Polyblog Multilingual Blog

Create a new blog

CreateUse this when someone asks to start a new Polyblog blog in Polyblog with a given name and languages. Returns the signed-innew organization.blog's Theid, name, isdomain globallyand uniquelanguages; becausethe itname becomes the public <name>.polyblog.io subdomain, so a clashing name fails rather than being adjusted.already Creatingtaken afails. blogNot alsofor firesadding a `blog.created` webhookpost to thean organizationexisting subscribers.blog.

 ⟨3 unchanged words⟩ additionalProperties":false,"properties":{"articlesFormat":{"description":"Format for the blog's posts: markdown or html","enum":["markdown","html"],"type":"string"},"defaultLocale":{"description":"ISO 639-1 codeMain thelanguage, blogan writesISO in639-1 bycode default,such e.g.as \"en\"en","maxLength":50,"type":"string"},"description":{"description":"Short description of what the blog is about, up to 600 characters","maxLength":600,"type":"string"},"locales":{"description":"Every language the blog publishes in, ISO 639-1 codes thesuch blogas

 ⟨5 unchanged words⟩ :true,"readOnlyHint":false,"title":"Create a new blog"}

Delete articlea blog post

PermanentlyUse this when someone asks to permanently delete a Polyblogblog articlepost byin id.every Deletinglanguage. aGiven publishedthe articleoriginal removespost's id, that post and all its publictranslations pageare deleted and firestheir anpages `article.deleted`go webhook.offline; Thisgiven cannota betranslation's undoneown —id, confirmnothing withis deleted although the userresult beforestill calling.says deleted. Returns the id. Not for unpublishing.

 ⟨5 unchanged words⟩ ,"properties":{"id":{"description":"ArticleId idof tothe deleteoriginal post (its originalArticleId); every language version of it is deleted","maxLength":200,"minLength":1,"type ⟨5 unchanged words⟩ 

 ⟨3 unchanged words⟩ additionalProperties":false,"properties":{"articleId":{"description":"The id passed in. The API deletes every article whose originalArticleId equals it, so a translation id deletes nothing even though status is deleted.","maxLength":200,"type":"string"},"status ⟨9 unchanged words⟩ 

 ⟨5 unchanged words⟩ :true,"readOnlyHint":false,"title":"Delete articlea blog post"}

GenerateDraft articlea blog post with AI

GenerateUse athis text-onlywhen SEOsomeone blogasks article:you anto LLMwrite draftsa boundednew HTML,blog internalpost linkson comea fromtopic or saved topic idea. Returns the blogdraft's customDomainid, sitemap.xmlURL, andtitle, theword articlecount isand savedinternal aslinks a(text draftonly; bypublished default.only Thiswith MCPautoPublish). toolIt alwaysuses disablespaid coverAI and inlinecan imagetake generation.about Passa `topic`minute, orand `topicIdeaId`.a Itcall spendsthat paidtimes modelout usagecan andstill usuallysave takesthe 30–60draft. seconds.Not for saving your own text.

 ⟨5 unchanged words⟩ ,"properties":{"autoPublish":{"description":"Publishtrue immediately.publishes Defaultthe falsepost (savesimmediately; asdefaults to false, a draft).","type":"boolean"},"blogId":{"description":"TargetBlog blogto idwrite for","maxLength":200,"minLength":1,"type":"string"},"locale":{"description":"LocaleLanguage codeof (the post, an ISO 639-1 code; defaults to blog

 ⟨4 unchanged words⟩ openWorldHint":true,"readOnlyHint":false,"title":"GenerateDraft articlea blog post with AI"}

GetRead articlea blog post

FetchUse athis singlewhen Polyblogsomeone articlewants byto idread, check or byquote slug+locale.one blog post. Returns allowlistedits metadatatitle, summary, language, slug, blog, author, published state, dates and atup mostto 8,000 characters of article content, withlooked anup explicitby truncationid flag.or by slug plus language. Not for a visual preview card.

 ⟨6 unchanged words⟩ ":{"idOrSlug":{"description":"Article id, or its slug together with locale","maxLength":300,"minLength":1,"type":"string"},"locale":{"description":"LocaleLanguage toof disambiguatethe post, an ISO 639-1 code such as en; needed when looking up by slug","maxLength": ⟨7 unchanged words⟩ 

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":true,"title":"GetRead articlea blog post"}

Get blog details

FetchUse athis singlewhen Polyblogsomeone blogasks about one blog's setup, such as its domain, default language or languages. Returns the blog's id, name, custom domain, default locale, locales, cover image URL and dates, by id or name. ReturnsNot thefor bloga metadatavisual formattedoverview aswith Markdown.recent posts.

 ⟨6 unchanged words⟩ ":{"idOrName":{"description":"Blog id (uuid), or the blog's name","maxLength":200,"minLength":1, ⟨6 unchanged words⟩ 

 ⟨5 unchanged words⟩ false,"readOnlyHint":true,"title":"Get blog details"}

AuditCheck blog localizationtranslation coverage

SummarizeUse multilingualthis articlewhen coveragesomeone forasks onehow organization-ownedwell Polyblogtheir blog.blog Comparesis configuredtranslated, localesor withwhich uplanguages toare 100missing recentlyposts. editedReturns articleper-language translationscounts of posts, published posts and clearlydrafts markswith thea resultcoverage whenpercentage, from the sample100 ismost truncated.recently edited posts. Not for one post's translations.

 ⟨5 unchanged words⟩ ,"properties":{"blogId":{"description":"Polyblog blogBlog id, or namethe toblog's auditname","maxLength":200,"minLength":1,"type ⟨5 unchanged words⟩ 

 ⟨99 unchanged words⟩ array"},"sample":{"additionalProperties":false,"description":"Coverage is computed from the 100 most recently edited posts; truncated means the blog has more","properties":{"articles":{"minimum":0," ⟨22 unchanged words⟩ 

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":true,"title":"AuditCheck blog localizationtranslation coverage"}

GetCheck sitemapa URLsblog's sitemap

SummarizeUse URLsthis fromwhen thesomeone blog'sasks customDomainwhat `/sitemap.xml`pages (followingtheir ablog's sitemap indexlists, oneor level)which andpages returnare atavailable mostto link to. Returns the sitemap's URL count and the first 25 safeURLs samplewith URLs.language Usedand bylast-modified `generate_article`date, asread live from the allowedblog's internal-linkcustom pool.domain. Not for the posts stored in Polyblog.

 ⟨5 unchanged words⟩ ,"properties":{"blogId":{"description":"TargetBlog blogwhose idsitemap to read","maxLength":200,"minLength":1,"type":"string"},"locale":{"description":"Two-letterOnly localeURLs toin filterthis bylanguage, (e.g.a \"en\")two-letter code such as en","maxLength":50,"type":"string"},"maxUrls":{"description":"CapHow onmany sitemap URLs returnedto

 ⟨19 unchanged words⟩ ,"type":"integer"},"returned":{"$refdescription":"#/properties/childSitemapsHow many sitemap URLs were read, at most maxUrls","maximum":9007199254740991,"minimum":0,"type":"integer"},"rootSitemap":{"$ref":"#/properties/baseUrl"},"sample":{"description":"The first 25 URLs read; returned counts every URL read","items":{"additionalProperties":false,"properties":{ ⟨45 unchanged words⟩ 

 ⟨4 unchanged words⟩ openWorldHint":true,"readOnlyHint":true,"title":"GetCheck sitemapa URLsblog's sitemap"}

List articlea post's translations

List upUse tothis 100when localesomeone versionsasks ofwhich onelanguages article,a groupedblog bypost itsexists `originalArticleId`in, andor markwhich atranslations truncatedare result.still missing. Returns safeeach language version sharing the original article metadataid, up to 100, with title, slug, published state and translationhow method.it Passwas `blogId`translated; towith compareblogId againstit atalso mostlists 100the configuredblog's locales.missing languages. Not for a whole blog's coverage.

 ⟨5 unchanged words⟩ ,"properties":{"blogId":{"description":"Optional blogBlog id.id; Whenwhen given, the replyresult also lists the blog localeslanguages that are still missinglack athis translation.post","maxLength":200,"type":"string"},"originalArticleId":{"description":"Original article id — the idId of the source-localeoriginal article;article that every translation shares, itas reported on each of its versions

 ⟨5 unchanged words⟩ :false,"readOnlyHint":true,"title":"List articlea post's translations"}

List your blogs

ListUse Polyblogthis blogswhen thesomeone authenticatedasks tenantwhich hasblogs accessthey to.have Returnsin Polyblog, or a boundedblog's pageid ofis needed. Returns each blog's id, name, and custom domain.domain, Pass25 theper returnedpage cursorby todefault continue.with a cursor. Not for a blog's posts.

 ⟨5 unchanged words⟩ ,"properties":{"cursor":{"description":"Opaque paginationThe cursornextCursor fromof athe previous callpage; absent for the first page","maxLength":4096,"type":"string"},"limit":{"description":"Blogs per page, from 1 to 100; defaults to 25","exclusiveMinimum":0,"maximum":100,"type": ⟨3 unchanged words⟩ 

 ⟨53 unchanged words⟩ :"string"},{"type":"null"}],"description":"Cursor for the next page; null on the last page"}},"required":["items","hasMore", ⟨3 unchanged words⟩ 

 ⟨5 unchanged words⟩ :false,"readOnlyHint":true,"title":"List your blogs"}

List saved topic ideas

ListUse savedthis topicwhen ideassomeone forasks awhat blog,they optionallycould filteredwrite byabout statusnext andfrom minimumtopic score.ideas already saved. Returns each idea's id, score out of 10, title, status, and source.source, Usefiltered theby idstatus withor `generate_article`minimum toscore, write25 theper article.page by default. Not for fetching new ideas.

 ⟨5 unchanged words⟩ ,"properties":{"blogId":{"description":"TargetBlog blogwhose idideas to list","maxLength":200,"minLength":1,"type":"string"},"cursor":{"description":"The nextCursor of the previous page with the same filters; absent for the first page","maxLength":4096,"type":"string"},"limit":{"description":"Ideas per page, from 1 to 100; defaults to 25","exclusiveMinimum":0,"maximum":100,"type":"integer"},"minScore":{"description":"MinimumOnly LLMideas with at least this AI score, (0-10)0 to include10","maximum":10,"minimum":0,"type":"integer"},"status":{"description":"FilterOnly byideas lifecyclewith

 ⟨73 unchanged words⟩ :"string"},{"type":"null"}],"description":"Cursor for the next page; null on the last page"}},"required":["items","hasMore", ⟨3 unchanged words⟩ 

 ⟨5 unchanged words⟩ :false,"readOnlyHint":true,"title":"List saved topic ideas"}

RefreshFind new topic ideas

Fetch fresh content fromUse boundedthis Redditwhen subredditssomeone andasks publicfor HTTPSnew RSSblog feeds,topic spendideas paidfrom modelReddit usageor toRSS scorefeeds. candidates,Returns dedupecounts againstand publishedup articles,to and5 persistof the keepers.saved Returnsideas; aggregateit countsfetches andthe atsources, mostscores fivecandidates safewith ideas;paid rawAI sourceand errorssaves arethose suppressed.that Confirmpass. sourcesNot andfor limitsideas first.already saved.

 ⟨5 unchanged words⟩ ,"properties":{"audience":{"description":"AudienceWho description.the Defaultsblog towrites thefor; blogdefaults `context`to fieldthe ifblog's omitted.context","maxLength":600,"type":"string"},"blogId":{"description":"TargetBlog blogto idfind ideas for","maxLength":200,"minLength":1,"type":"string"},"limitPerSource":{"description":"Max

 ⟨4 unchanged words⟩ openWorldHint":true,"readOnlyHint":false,"title":"RefreshFind new topic ideas"}

SearchFind articlesblog posts

SearchUse Polyblogthis articleswhen withsomeone optionalasks filtersto bysee their blog, localeposts, slug,drafts andor published state.articles, Returnsoptionally afor Markdownone tableblog, oflanguage matchesor withslug. Returns id, title, localelanguage, slug and published state, most recently edited first, 25 per page by default with a cursor. It filters by those fields and published.does Usenot search the returnedtext. cursorNot tofor pagereading througha results.post.

 ⟨5 unchanged words⟩ ,"properties":{"blogId":{"description":"FilterOnly toposts ain specificthis blog","maxLength":200,"type":"string"},"cursor":{"description":"Opaque paginationThe cursornextCursor fromof athe previous callpage with the same filters; absent for the first page","maxLength":4096,"type":"string"},"limit":{"description":"Posts per page, from 1 to 100; defaults to 25","exclusiveMinimum":0,"maximum":100,"type":"integer"},"locale":{"description":"Only posts in this language, an ISO 639-1 locale code, e.g.such \"en\",

 ⟨67 unchanged words⟩ :"string"},{"type":"null"}],"description":"Cursor for the next page; null on the last page"}},"required":["items","hasMore", ⟨3 unchanged words⟩ 

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":true,"title":"SearchFind articlesblog posts"}

SetMark a topic idea statusused or dismissed

MoveUse athis savedwhen someone asks to mark a topic idea through itsas lifecycle:used, markdismiss it `used`, onceor anbring articleit hasback beenas writtennew. fromReturns it,the `dismissed`idea towith keepits itnew outstatus ofand, futurewhen suggestionsgiven, orthe backarticle toit `new`.produced; Onlynothing else about the statusidea (andchanges. optionallyNot thefor articleediting itan produced)idea's istitle changed.or angle.

 ⟨5 unchanged words⟩ properties":{"status":{"description":"New lifecycle status: fornew, theused topicor ideadismissed","enum":["new","used"," ⟨3 unchanged words⟩ ,"topicIdeaId":{"description":"Topic idea id from `list_topic_ideas`","maxLength":200,"minLength":1,"type":"string"},"usedForArticleId":{"description":"ArticleId idof thisthe ideaarticle produced;written onlyfrom meaningfulthis idea; only 

 ⟨4 unchanged words⟩ openWorldHint":false,"readOnlyHint":false,"title":"SetMark a topic idea statusused or dismissed"}

Set blog topic research sources

ReplaceUse thethis Redditwhen subredditssomeone and/orasks publicto HTTPSchoose RSSwhich feedssubreddits usedor forRSS topicfeeds research.their Confirmblog's thetopic completeresearch replacementreads. listsReturns beforethe calling.saved Oncesources; set,each `refresh_topic_ideas`list onlypassed needsreplaces the blogId.old Passone, `reddit`and and/orclear `rss`,removes orthem `clear:all. true`Not tofor wipefetching allideas sources.now.

 ⟨5 unchanged words⟩ ,"properties":{"blogId":{"description":"Target blogBlog id, or the blog's name","maxLength":200,"minLength":1,"type":"string"},"clear":{"description":"Removetrue theremoves topicSourcesevery fieldsaved entirely.source","type":"boolean"},"reddit":{"description":"SubredditComplete new list of up to 20 subreddit names, (without /r/)./r/; Replacesreplaces the existingold list.list

 ⟨5 unchanged words⟩ :false,"readOnlyHint":false,"title":"Set blog topic research sources"}

ShowPreview Polybloga articleblog previewpost

RenderUse athis focusedwhen previewsomeone forwants ato knownsee Polybloghow articleone blog post looks, includingwith its publicationstatus and details. Returns a preview card with the post's title, language, published state, metadata, and aup boundedto content6,000 excerpt.characters of content. Not for finding posts.

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Preview a blog post"}

Show Polyblog blog overview

RenderUse this when someone wants a compactquick overview forof aone knownof Polyblogtheir blog,blogs. includingReturns itsan overview card with the blog's domain, locales,languages and up to ten10 most recently edited articles.posts. Not for translation coverage.

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"readOnlyHint":true,"title":"Show blog overview"}

UpdateEdit articlea blog post

Partially update an existingUse Polyblogthis articlewhen bysomeone id.asks Onlyto thechange fieldsa youblog passpost's aretitle, changed;text, everythingsummary, elseslug, isauthor preserved.or Passingcategories, `published`or canto publish or unpublish itsit. publicReturns pagethe updated post; only the fields passed change, and everyeach updateedit firesnotifies anthe `article.updated`blog's webhook.webhooks. Not for adding a translation.

 ⟨3 unchanged words⟩ additionalProperties":false,"properties":{"author":{"description":"New author name, up to 200 characters","maxLength":200,"type":"string"},"categories":{"description":"Complete new list of up to 50 categories; replaces the old list","items":{"maxLength":100,"type":"string"},"maxItems":50,"type":"array"},"content":{"description":"New body in the post's format, up to 100,000 characters; replaces the whole body","maxLength":100000,"type":"string"},"description":{"description":"New summary, up to 1,000 characters","maxLength":1000,"type":"string"},"format":{"description":"markdown or html, describing how content is written","enum":["markdown","html"],"type":"string"},"id":{"description":"ArticleId idof the post to updatechange","maxLength":200,"minLength":1,"type":"string"},"published":{"description":"true publishes the post, false turns it back into a draft","type":"boolean"},"slug":{"description":"New URL slug, up to 300 characters; changes the post's URL","maxLength":300,"type":"string"},"title":{"description":"New title, up to 300 characters","maxLength":300,"type":"string"}}, ⟨4 unchanged words⟩ 

 ⟨4 unchanged words⟩ openWorldHint":true,"readOnlyHint":false,"title":"UpdateEdit articlea blog post"}

{"$schema":"httphttps://json-schema.org/draft-07/schema#","additionalProperties//json-schema.org/draft/2020-12/schema":false,"properties":{"blogId":{"description":" ⟨19 unchanged words⟩ 

{"$schema":"httphttps://json-schema.org/draft-07/schema#//json-schema.org/draft/2020-12/schema","additionalProperties":false,"properties":{"articles" ⟨120 unchanged words⟩