io.polyblog/polyblog

Search Polyblog articles with optional filters by blog, locale, slug, and published state. Returns a Markdown table of matches with id, title, locale, slug, and published. Use the returned cursor to page through results.

Fetch a single Polyblog article by id or by slug+locale. Returns allowlisted metadata and at most 8,000 characters of article content, with an explicit truncation flag.

List up to 100 locale versions of one article, grouped by its `originalArticleId`, and mark a truncated result. Returns safe article metadata and translation method. Pass `blogId` to compare against at most 100 configured locales.

Create a new Polyblog article in the given blog. Returns the created article id and title and fires an `article.created` webhook. Defaults to unpublished; passing `published: true` also creates a public article page. To write a TRANSLATION of an article you already have, pass that article's id as `…

Partially update an existing Polyblog article by id. Only the fields you pass are changed; everything else is preserved. Passing `published` can publish or unpublish its public page, and every update fires an `article.updated` webhook.

Generate a text-only SEO blog article: an LLM drafts bounded HTML, internal links come from the blog customDomain sitemap.xml, and the article is saved as a draft by default. This MCP tool always disables cover and inline image generation. Pass `topic` or `topicIdeaId`. It spends paid model usage a…

List Polyblog blogs the authenticated tenant has access to. Returns a bounded page of id, name, and custom domain. Pass the returned cursor to continue.

Fetch a single Polyblog blog by id or name. Returns the blog metadata formatted as Markdown.

Summarize multilingual article coverage for one organization-owned Polyblog blog. Compares configured locales with up to 100 recently edited article translations and clearly marks the result when the sample is truncated.

Create a new Polyblog blog in the signed-in organization. The name is globally unique because it becomes the public <name>.polyblog.io subdomain, so a clashing name fails rather than being adjusted. Creating a blog also fires a `blog.created` webhook to the organization subscribers.

Summarize URLs from the blog's customDomain `/sitemap.xml` (following a sitemap index one level) and return at most 25 safe sample URLs. Used by `generate_article` as the allowed internal-link pool.

Fetch fresh content from bounded Reddit subreddits and public HTTPS RSS feeds, spend paid model usage to score candidates, dedupe against published articles, and persist the keepers. Returns aggregate counts and at most five safe ideas; raw source errors are suppressed. Confirm sources and limits f…

List saved topic ideas for a blog, optionally filtered by status and minimum score. Returns id, score, title, status, and source. Use the id with `generate_article` to write the article.

Move a saved topic idea through its lifecycle: mark it `used` once an article has been written from it, `dismissed` to keep it out of future suggestions, or back to `new`. Only the status (and optionally the article it produced) is changed.

Replace the Reddit subreddits and/or public HTTPS RSS feeds used for topic research. Confirm the complete replacement lists before calling. Once set, `refresh_topic_ideas` only needs the blogId. Pass `reddit` and/or `rss`, or `clear: true` to wipe all sources.

Render a compact overview for a known Polyblog blog, including its domain, locales, and up to ten recently edited articles.

Render a focused preview for a known Polyblog article, including its publication state, metadata, and a bounded content excerpt.