Misar.Blog MCP Server

{"destructiveHint":false,"idempotentHint":false,"openWorldHint":falsetrue,"readOnlyHint":false}

{"destructiveHint":false,"idempotentHint":false,"openWorldHint":falsetrue,"readOnlyHint":true}

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":true}

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":true}

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":true}

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":true}

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":true}

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":true}

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":true}

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":true}

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":true}

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":true}

{"destructiveHint":false,"idempotentHint":false,"openWorldHint":falsetrue,"readOnlyHint":true}

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":true}

{"destructiveHint":false,"idempotentHint":false,"openWorldHint":falsetrue,"readOnlyHint":true}

{"destructiveHint":true,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":false}

 ⟨9 unchanged words⟩  quota you have left, and what upgrading unlocks.unlocks, with the link to upgrade. Call it any time — not only after hitting a limit. SetReads open=trueonly: toit opennever changes the checkoutplan pageor takes payment; the user upgrades by following the link. On a local install, open=true also opens that link in yourthe user's browser.

 ⟨5 unchanged words⟩ ,"properties":{"open":{"description":"OpenLocal installs only: also open the upgrade/checkoutupgrade pagelink in the defaultuser's browser. Ignored by the hosted server, which returns the link instead.","type":"boolean"},"plan":{ ⟨31 unchanged words⟩ 

Add an article to a series

Place an existing article intoAdd an existing series, optionally at a specific position.

Both the series and the article must already exist — this creates neither. Identify them by SLUG, not id: get_series supplies the series slug and the article tools supply the article slug. Omit position to append at the end.

Requires an API key. Adding an article does not change its publication status or URL; it only changes where it appears. Inserting at a position shifts the articles after it down. Errors if either slug is unknown.series

 ⟨5 unchanged words⟩ ,"properties":{"article_slug":{"description":"Slug of theThe article slug to add, from list_my_articles. Not its title or id.","type":"string"},"position":{"description":"1-based position within the series. Omit to appendPosition atin the end. Insertingseries shifts(optional, laterappends articlesif down.omitted)","minimum":1,"type":"integer"},"series_slug":{"description":"Slug of the targetThe series, from get_series. Not its title or id.slug","type":"string"}},"required": ⟨4 unchanged words⟩ 

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":truefalse,"readOnlyHint":false}

Create a draft

Save an article as an unpublished draft.

Nothing becomes visible to readers: use this whenever the work still needs review, and publish_article only when it should go live. The draft can be edited afterwards with update_article.

Each call creates a NEW draft — not idempotent, so calling twice leaves two drafts. Requires an API key. Returns the draft with anon editor_urlMisar.Blog (for finishing it inreview thebefore browser.publishing)

 ⟨5 unchanged words⟩ ,"properties":{"body_markdown":{"description":"Article bodyFull soarticle far,body asin Markdown.Markdown","minLength":1,"type":"string"},"tags":{"description":"Topic tags to carryTags throughfor tothe publication.draft","items":{"type":"string"},"type":"array"},"title":{"description":"Working headline. Can be changed beforeDraft publishing.title","minLength":1,"type":"string"} ⟨5 unchanged words⟩ 

{"destructiveHint":false,"idempotentHint":false,"openWorldHint":truefalse,"readOnlyHint":false}

Create a series

Create a new, empty series — a named collection that related articles can be added to.

Creating the series does not move any article into it; follow up with add_to_series for each one. Call get_series first to avoid making a second series with the same title, since each call creates a NEW series and nothing deduplicates them.

Requires an API key. The series and its URL become publicly reachable, though it shows nothinggroup untilrelated articles are added. Returns the series with the slug that add_to_series needs.

 ⟨5 unchanged words⟩ properties":{"description":{"description":"Short summary showndescription onof the series page. Optional.","type":"string"},"title":{"description":"Display name of the series. The slug is derived fromSeries this.title","minLength":1,"type":"string"} ⟨4 unchanged words⟩ 

{"destructiveHint":false,"idempotentHint":false,"openWorldHint":truefalse,"readOnlyHint":false}

Generate a cover image

Generate an image from a textcover promptimage withusing AI, and upload it to the Misar.Blog CDN, and return its public URL for use as cover_image_url when publishing.

Use it when no artwork exists yet; use upload_image for a file the user already has. Each call generates a NEW image and costs generation credits against the account's plan — it is not idempotent, so re-running to 'try again' bills again. Generation takes noticeably longer than other tools.

Requires an API key. The resulting URL is public and cannot be deleted through this server. Results vary between runs for the same prompt.

 ⟨5 unchanged words⟩ ,"properties":{"prompt":{"description":"WhatDescription of the image should show, in plain language, up to 1000 characters. Describe subject and style; avoid asking for text in the image.generate","maxLength":1000,"minLength":1,"type ⟨2 unchanged words⟩ ":{"default":"1792x1024","description":"OutputImage dimensions: '1792x1024' landscape (the default, best for: articlelandscape covers1792x1024), '1024x1024' square, '1024x1792' portrait.","enum":["1024x1024","1792x1024"," ⟨7 unchanged words⟩ 

{"destructiveHint":false,"idempotentHint":false,"openWorldHint":truefalse,"readOnlyHint":false}

Generate SEO titles from keywords

Generate 5 search-optimisedSEO/AEO/GEO-optimized article titles from a TOPIC OR KEYWORD, each with atopic keyword-strategyor hint.keyword Aimsprompt. atTargets high-volume, low-competition long-tail phraseskeywords. andOptimized atfor Google, AI answer engines (ChatGPT, Perplexity, Claude) as well as Google.

Pick between the two title tools by what you have in hand: use this one when you have a topic or keywords and the article may not be written yet. Use suggest_titles when the draft already exists and you want titles drawn from its actual text. Passing `context` here does not make them equivalent — this one still optimises for the keywords you supply.

Nothing is saved and no article is created or retitled; use update_article to apply a title. Requires, anGoogle APIAI keyOverviews, and consumes AI credits persearch call.experiences. Generative,Each sotitle repeatedincludes callsa returnkeyword differentstrategy titles.hint.

 ⟨5 unchanged words⟩ "properties":{"context":{"description":"Optional: draftexisting textarticle content (plain or Markdown, up totext 8000or charsmarkdown) so the. titlesProviding matchit whatlets the article actually says.AI Titlesalign stilltitles followwith

{"destructiveHint":false,"idempotentHint":false,"openWorldHint":truefalse,"readOnlyHint":true}

Get analyticsAnalytics summary

Summarise the account's performance over a trailingGet window:analytics pagesummary (views, gross and net revenue, and active subscriber count.

Use it for 'how did I do this month' style questions. These are whole-account totals — it cannot break results down per article, and it covers a trailing window ending today rather than an arbitrary date range.

Reads only. Requires an API key. Revenue is returned in cents (revenue_cents gross, revenue_net_cents after feessubscribers) with a formatted revenue_usd added for convenience — read the cents fields when doing arithmetic. Zero views is a real answer, not antime error.period

 ⟨6 unchanged words⟩ "days":{"default":30,"description":"SizeNumber of the trailing window in days, ending today. 1-365, defaults to 30. Use 7look forback a(default: week30, 365 for amax: year.365)","maximum":365,"minimum":1,"type ⟨3 unchanged words⟩ 

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":truefalse,"readOnlyHint":true}

Get one article

FetchGet a single article by slug, including its full Markdown body.

Use this after list_my_articles or search_articles has given you a slug and you need the actualmarkdown content — for reading, editing, or repurposing it. Fetching one article at a time is deliberate: the listing tools omit bodies so they stay cheap.

Reads only; nothing is created or modified. Requires an API key for unpublished articles; published ones are readable without. Returns the article object with content_markdown populated. Errors if the slug does not exist or the account cannot see it.

 ⟨5 unchanged words⟩ ,"properties":{"slug":{"description":"URL slug of theThe article, e.g. 'how-we-cut-build-times'. Not the numeric id, and not the full URL.slug","type":"string"}},"required": ⟨3 unchanged words⟩ 

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":truefalse,"readOnlyHint":true}

Get followFollow status

Check whether the authenticated account follows a given profile, and how many followers that profile has.

Use it before offering toGet follow someone, so you do not suggest an action that is alreadystatus done.and Itfollower answerscount aboutfor ONEa profile identified by UUID — there is no tool here that lists everyone you follow.

Reads only; following state is not changed.UUID. Requires an API key andkey; counts against theyour plan's request quota. Returns the follow relationship and follower count. Errors if the UUID does not match a profile.

 ⟨7 unchanged words⟩ "description":"UUID of the profile to check, as returned in author fields by article tools. Notfollow thestatus username.for","format":"uuid","type":"string ⟨4 unchanged words⟩ 

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":truefalse,"readOnlyHint":true}

Get my profile

Fetch the authenticatedGet account'syour ownMisar.Blog creator profile: id, username, display name, bio, public profile URL, and whether Stripe payouts are connected.

Use it to confirm which account a key belongs to before acting on that account's behalf, to get your own profile id for tools that take a UUID, or to check stripe_connected before discussing paid posts. It only ever describes the caller — there is no tool here for looking up someone else's profile.

Reads only; nothing is modified. Requires an API key, and takes no parameters. Errors if the key is missing or invalid, which is the quickest way to test authentication.

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":truefalse,"readOnlyHint":true}

Get article reactions

Read theGet reaction totals on one article,counts plusand whichyour reactions the authenticated account has left on it.

Use it before add_reaction or remove_reaction so you know the current state — it is how you tell 'not yet liked' from 'already liked'. Covers one article at a time.

Reads only; no reaction is addedfor oran removed.article. Requires an API key. Returns counts per type (like, clap, bookmark) alongside the caller's own reactions. Zero counts are a real answer, not an error.

 ⟨6 unchanged words⟩ article_id":{"description":"UUID of the article, from the `id` field returned by article tools.","format":"uuid","type":"string ⟨4 unchanged words⟩ 

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":truefalse,"readOnlyHint":true}

List my series

List every series the authenticated account owns. Despite the name this returns the whole collection, not one series — there is no single-series lookup.

Use it to find a series slug before calling add_to_series, or to check whether a series already exists before create_series makes a duplicate.

Reads only; nothing is created or modified. Requires an API key, and takes no parameters — it is unfiltered and unpaginated. Returns `{ series, total }` where each entry carries id, slug, title, description, url and article_count. An empty list means the account hasall noyour series yet, which is not anon error.Misar.Blog

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":truefalse,"readOnlyHint":true}

List article comments

ReadGet the comment thread on one article, oldest first, paginated.

Use it to review reader feedback or summarise a discussion. It reads comments only; there is no tool here for posting or moderating a reply.

Readsan only.article. Requires an API key andkey; counts against theyour plan's request quota. Page through with limit and offset — the default returns the first 20. Returns the comments with their authors and timestamps; an empty list simply means no comments yet, which is not an error.

 ⟨6 unchanged words⟩ article_id":{"description":"UUID of the article, as returned in the `id` field by article tools.to Notfetch thecomments slug.for","format":"uuid","type":"string"},"limit":{"default":20,"description":"Comments per page, 1-100. Defaults to 20.","maximum":100,"minimum":1,"type":"integer"},"offset":{"default":0,"description":"Comments to skip before this page. Defaults to 0.","minimum":0,"type":"integer"}} ⟨4 unchanged words⟩ 

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":truefalse,"readOnlyHint":true}

List articles owned by the authenticated account, newest first, including drafts and scheduled posts.

Use this to find your own work — it is the only listing that sees unpublished content. To search across the whole site, including other creators, use search_articles instead.

Reads only; nothing is created or modified. Requires an API key. Returns `{ articles, total }`, where each article carries id, slug, title, status, url, editor_url, tags and timestamps, but NOT the article body — call get_article for that. `total` counts all matches, not just the pageon returned.Misar.Blog

 ⟨6 unchanged words⟩ "limit":{"default":20,"description":"MaximumNumber of articles to return, 1-100. Defaults to 20.","maximum":100,"minimum":1,"type":"integer"},"status":{"description":"Return only articles in this state. Omit toFilter returnby everystatus state(omit thefor accountall owns.published)","enum":["draft","published"," ⟨6 unchanged words⟩ 

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":truefalse,"readOnlyHint":true}

List newsletter issues the accountGet hasyour sent or scheduled, newest first.

Use it to check what went out and when, or to confirm a scheduled send exists before queueing another. For WHO receives them, use list_newsletter_subscribers.

Reads only — this neither sends nor cancels annewsletter issue.issues. Requires an API key. Returns each issue with its subject, status and send time. An empty list means nothing has been sent yet, which is not ankey error.authentication.

 ⟨5 unchanged words⟩ properties":{"limit":{"default":10,"description":"Issues to return, 1-50, newest first. Defaults to 10.","maximum":50,"minimum":1,"type":" ⟨3 unchanged words⟩ 

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":truefalse,"readOnlyHint":true}

List newsletter subscribers

List the people subscribed to the authenticatedGet account'syour newsletter, paginated.

Use it to size the audience or export the list. For what has been SENT to them, use list_newsletter_issues instead.

Reads only — no email is sent and no subscriber is added or removed.list. Requires an API key. This returns personal data (email addresses), so treat the result as confidential and do not echo it into shared transcripts. Page with limit and offset; the default returns the firstkey 20.authentication.

 ⟨5 unchanged words⟩ properties":{"limit":{"default":20,"description":"Subscribers per page, 1-100. Defaults to 20.","maximum":100,"minimum":1,"type":"integer"},"offset":{"default":0,"description":"Subscribers to skip before this page. Defaults to 0.","minimum":0,"type":"integer"}} ⟨2 unchanged words⟩ 

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":truefalse,"readOnlyHint":true}

Publish an article

CreatePublish a new article and make it live immediately, (or schedule it for a future time.

This PUBLISHES: without schedule_at the article is world-readable the moment this returns, at the visibility you choose. If the piece is not ready, use create_draft instead and publish later. Each call creates a NEW article — it is not idempotent, so calling twice publishes twice; use update_article to change one that exists.

Requires an API key and consumes one publish from the account's plan quota; the response warns when the allowance is nearly spent. Returns the created article with its public url) andon editor_url.Misar.Blog

 ⟨5 unchanged words⟩ ,"properties":{"body_markdown":{"description":"CompleteFull article body as Markdown. Images may be referenced byin URL.Markdown","minLength":1,"type":"string"},"cover_image_url":{"description":"Absolute URL of the hero image. generate_cover_image returns a URL suitablecover here.image","format":"uri","type":"string"},"schedule_at":{"description":"ISO 8601 timestamp to publish at, e.g. '2026-09-01T09:00:00Z'.schedule. Omit to publish immediately. A past timestamp publishes immediately.","type":"string"},"tags":{"description":"Up to 10 topic tags used for discovery and filtering.","items":{"type":"string"}, ⟨3 unchanged words⟩ :"array"},"title":{"description":"Headline, 1-250Article characters.title","maxLength":250,"minLength":1,"type ⟨2 unchanged words⟩ ":{"default":"public","description":"Audience: 'public' anyone, 'subscribers' newsletter subscribers, 'paid' paying members, 'private' onlyWho you.can Defaultsread tothis 'public'.article","enum":["public","subscribers"," ⟨9 unchanged words⟩ 

Remove a reaction

Withdraw one reaction the authenticated account previously left on an article.

Removes exactly the type you name and leaves the account's other reactions on that article intact — removing 'like' does not removeRemove a 'bookmark'. Nothing else is deleted: the article and its comments are untouched.

Safe to repeat: removing aspecific reaction that is not there succeeds andfrom changesan nothing.article. Requires an API key. Call get_reactions first if you need to know what is currently set.

 ⟨6 unchanged words⟩ article_id":{"description":"UUID of the article to un-react to, from the `id` field of article tools.","format":"uuid","type":"string"},"type":{"description":"WhichReaction reactiontype to withdrawremove: 'like'like, 'clap'clap, or 'bookmark'.bookmark","enum":["like","clap"," ⟨8 unchanged words⟩ 

Research a topic

Research a topic with AI and returnget AI-generated insights, sources, and a suggested content outline.

Use it at the START of a piece,Useful before drafting — it produces raw material to write from, not a finished article and not a title. For titles use generate_title_seo; to see what already exists on Misar.Blog use search_articles.

Nothing is saved: no draft, article, or file is created, and calling it has no effect on the blog. Requireswriting an API key and consumes AI credits from the account's plan, so each call costs whether or not you use the output. Runs noticeably longer than a plain read, and being generative, two identical calls give different text. Returns prose to read, not structured JSON — verify any factual claims it makes.article.

 ⟨5 unchanged words⟩ ,"properties":{"query":{"description":"TheResearch topic or question to research, 5-500 characters. Specific beats broad: 'how small SaaS teams price annualquestion. plans'Be returnsspecific morefor thanbest 'pricing'.results.","maxLength":500,"minLength":5,"type ⟨5 unchanged words⟩ 

{"destructiveHint":false,"idempotentHint":false,"openWorldHint":truefalse,"readOnlyHint":true}

Search published articles

Search PUBLISHED articles across all of Misar.Blog, including other creators' work.

Use this for discovery, research, and competitive reading. It never returnsby draftskeyword, scheduledtag, or private posts — not even your ownauthor — so reach for list_my_articles when you wantincluding yourother unpublishedcreators' work.

Reads only. No API key required; unauthenticated callers are rate-limited by IP. Filters combine with AND. Returns an array of article summaries without bodies; pass a slug toUse get_articlelist_my_articles for the full text. An empty array means no matches,your whichown isdrafts notand anunpublished error.posts.

 ⟨5 unchanged words⟩ ,"properties":{"author":{"description":"Restrict toFilter oneby author, by username.username","type":"string"},"limit":{"default":10,"description":"Maximum resultsResults to return, 1-20. Defaults to 10.(1-20)","maximum":20,"minimum":1,"type":"integer"},"q":{"description":"Free-textKeyword query matched against title and body. Minimum(min 2 characters.characters)","minLength":2,"type":"string"},"tag":{"description":"Restrict to articles carrying thisFilter exactby tag.tag","type":"string"}},"type":"object"}

{"destructiveHint":false,"idempotentHint":true,"openWorldHint":truefalse,"readOnlyHint":true}

Suggest titles from draft text

Generate 5 title options FROM AN EXISTING DRAFTcompelling, derived from what theSEO-friendly article actually says.

Pick between the two title tools by what you have in hand: use this one when the text existsoptions andfrom shouldyour driveexisting thearticle headline.content. Use generate_title_seo when you are starting from a topic orinstead keyword,if oryou want titles aimedto attarget specific search terms — this tool takes no keyword input at all.

Nothing is saved and thekeywords articleor ishave not retitled; apply a choice with update_article. Requires an API key and consumes AI credits per call. Generative, so repeated calls return different titles. Needs at least 20 characters of text towritten workcontent from.yet.

 ⟨5 unchanged words⟩ ,"properties":{"context":{"description":"TheYour article text to draw titlescontent from,in plain or Markdown, 20-8000 characters. More of the real draft yields better-fitting titles thantext aor summary.markdown","maxLength":8000,"minLength":20,"type ⟨5 unchanged words⟩ 

{"destructiveHint":false,"idempotentHint":false,"openWorldHint":truefalse,"readOnlyHint":true}

Update an article

ChangeUpdate the title, body, or tags of an existing article or draft that alreadydraft. exists.

Only the fields you pass are touched;changed; omitted fields keep their current values. Passing `tags` REPLACES the whole tag list rather than adding to it, so send the full set you want. Editing a published article changes what readers see immediately; it does not unpublish or re-date it.

Safe to repeat: the same call twice leaves the same result. Requires an API key, and the account must own the article. Errors if no updatable field is supplied. Returns the updated article.

 ⟨5 unchanged words⟩ ,"properties":{"body_markdown":{"description":"Replacement body as Markdown. Replaces the wholeNew body, not ain patch.Markdown","minLength":1,"type":"string"},"id":{"description":"Article or draft id from a listing tool. This is the id, not the slug.ID","minLength":1,"type":"string"},"tags":{"description":"Replacement tag list, up to 10. OverwritesReplace the existing tagstag entirely.list","items":{"type":"string"}, ⟨3 unchanged words⟩ :"array"},"title":{"description":"ReplacementNew headline.title","maxLength":500,"minLength":1,"type ⟨5 unchanged words⟩ 

{"destructiveHint":falsetrue,"idempotentHint":true,"openWorldHint":truefalse,"readOnlyHint":false}

ShowPlan planusage and quota, or upgrade

Show the account'syour current Misar.Blog plan, how much of each quota remainsyou have left, and what a higher planupgrading unlocks.

Called with no argumentsCall it only reads — useful any time, — not justonly after hitting a limit, and the natural follow-up when a write tool reports a quota error. Two arguments make it act rather than report, so pass them only on explicit instruction from the user: `start_trial`limit. ENROLSSet theopen=true accountto inopen the free trial immediately (a real account change, not a preview), and `open` LAUNCHES a checkout page in the user'syour browser. Neither charges a card by itself.

Requires an API key. No billing state changes unless you pass start_trial; the returned quota snapshot already reflects a trial started in the same call. For whether you are authenticated at all, use `status`.

 ⟨6 unchanged words⟩ :{"open":{"description":"Open the checkoutupgrade/checkout page in the user's default browser. Side effect on their desktop — only when they asked to upgrade.","type":"boolean"},"plan":{"description":"Plan slug to open, (e.g. 'pro' or, 'business'.'business'). Defaults to the recommended plan. Only meaningful with open=true.","type":"string"},"start_trial":{"description":"Enrol inStart the free no-card trial nowimmediately, if eligible. This changes the account's plan — do not set ityou're speculatively.eligible.","type":"boolean"}},"type":"object"}