An authenticated MCP server for publishing and managing a Misar.Blog creator account from any AI client.
Authenticate and check connection via browser login (login) or API key, plus status.
Manage articles: publish, schedule, draft, update, list, fetch by slug, and search published posts across the platform.
Work with series: list, create series, and add articles at a chosen position.
View analytics and profile: plan/quota info, upgrade/trial links, creator profile, and views/revenue/subscriber summaries.
AI content helpers: research topics, generate SEO/AEO/GEO titles, suggest titles from existing content, and generate AI cover images.
Media: upload local images to the Misar.Blog CDN.
Engagement: upvote/remove upvote, save/unsave/list saved, repost/remove repost, and get reputation tiers/badges.
Newsletter and comments: list subscribers and newsletter issues, and read article comment threads.
Legacy reactions: get/add/remove like, clap, or bookmark reactions, deprecated and sunsetting 2027-02-03.
Safety annotations: read-only, idempotent, open-world, and destructive hints are provided so clients can warn before irreversible or public actions.
Allows Windsurf (by Codeium) to publish and manage blog posts, drafts, series, and analytics on Misar.Blog.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MisarBlog MCP Server Create a draft about AI blogging and suggest titles."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Publish and manage articles, series, upvotes, saved, reposts, reputation, newsletters and analytics — from any AI assistant.
31 tools · 8 prompts · 5 resources · 6 agent skills
Works with Claude (Desktop, Code, and web), Cursor, VS Code, Windsurf, Cline, Zed, Gemini CLI, ChatGPT, and any other MCP-compatible client — over stdio or Streamable HTTP.
npx -y @smithery/cli install misar/misarblog-mcp --client claudeclaude mcp add misarblog -- npx -y @misarblog/mcp@latest{
"mcpServers": {
"misarblog": {
"command": "npx",
"args": ["-y", "@misarblog/mcp@latest"],
"env": { "MISARBLOG_API_KEY": "mbk_your_key_here" }
}
}
}Ready-made configs for every client live in connectors/.
{
"mcpServers": {
"misarblog": {
"type": "streamable-http",
"url": "https://www.misar.blog/api/mcp",
"headers": { "Authorization": "Bearer mbk_your_key_here" }
}
}
}Related MCP server: WordPress MCP
Two options — no copy-paste needed for the first:
Browser login. Start the server with no key and run the login tool.
It opens the Misar.Blog consent screen, you review the requested
permissions, and the key is delivered straight back and saved to
~/.misarblog/config.json.
API key. Create one at https://www.misar.blog/dashboard/settings/api-keys and set MISARBLOG_API_KEY.
Self-hosted instances: set MISARBLOG_BASE_URL.
Tool | Description |
| Show your current Misar.Blog plan, how much of each quota you have left, and what upgrading unlocks, with the link to upgrade. |
| Get your Misar.Blog creator profile. |
| Get analytics summary (views, revenue, subscribers) for a time period. |
| List your articles on Misar.Blog. |
| Get a single article by slug, including full markdown content. |
| Publish a new article (or schedule it) on Misar.Blog. |
| Save an article as a draft on Misar.Blog (for review before publishing). |
| Update the title, body, or tags of an existing article or draft. |
| Search PUBLISHED articles across Misar.Blog by keyword, tag, or author — including other creators' work. |
| Research a topic and get AI-generated insights, sources, and a content outline. |
| Generate 5 SEO/AEO/GEO-optimized article titles from a topic or keyword prompt. |
| Generate 5 compelling, SEO-friendly article title options from your existing article content. |
| Generate a cover image using AI and upload it to the Misar.Blog CDN. |
| List all your series on Misar.Blog. |
| Create a new series to group related articles. |
| Add an existing article to a series. |
| Get the comment thread for an article. |
| Get follow status and follower count for a profile UUID. |
| Get your newsletter subscriber list. |
| Get your sent and scheduled newsletter issues. |
| Upvote an article as the account holder. |
| Remove your upvote from an article. |
| Save an article to your saved list to read later. |
| Remove an article from your saved list. |
| List your saved articles, newest save first. |
| Get a creator's reputation: score, tier and tier name, upvotes received, progress toward the next tier, and badges. |
| Repost an article to your followers, with an optional note (up to 280 characters). |
| Undo your repost of an article. |
| Deprecated (the v1 reactions API sunsets on 2027-02-03): get reaction counts and your reactions for an article. |
| Deprecated (the v1 reactions API sunsets on 2027-02-03): add a reaction to an article. |
| Deprecated (the v1 reactions API sunsets on 2027-02-03): remove a specific reaction from an article. |
Reusable workflows your client exposes as slash-commands.
Prompt | Description |
| Write a complete, SEO-optimised article draft and save it to Misar.Blog. |
| Audit an article for SEO/AEO/GEO and apply the improvements. |
| Draft a newsletter issue from recent published articles. |
| Generate article ideas grounded in what has and has not been covered. |
| Write platform-specific promotional captions for an article. |
| Generate and rank stronger headline options for an article. |
| Plan a multi-part article series and set it up on Misar.Blog. |
| Summarise blog performance and recommend what to do next. |
Read-only context an agent can attach without spending a tool call.
URI | Description |
| Your Misar.Blog profile — username, display name, bio, and payout status. |
| Your 20 most recent published articles. |
| Your unpublished drafts, so work in progress can be resumed rather than restarted.. |
| Your series and the articles in each, in order.. |
| Views, revenue, and subscriber counts for the last 30 days — the baseline for any performance question.. |
Bundled in skills/ — guidance an agent loads when a task matches.
Skill | Use when |
| Report on Misar.Blog performance — views, revenue, subscribers, engagement. Use for "how is my blog doing", traffic reports, or content performance analysis. |
| Plan and manage a multi-part article series on Misar.Blog. Use for "series", "multi-part", "part 2", or organising related posts into a sequence. |
| Draft and review Misar.Blog newsletter issues and subscriber performance. Use for "newsletter", "email my subscribers", or newsletter performance questions. |
| Write platform-specific promotional copy for a Misar.Blog article. Use for "share this post", "social caption", "promote my article", or writing X/LinkedIn/Reddit copy. |
| Write, draft, and publish an article on Misar.Blog. Use when the user wants to write a post, publish an article, save a draft, or turn notes into a blog post. |
| Audit and improve an existing Misar.Blog article for SEO, AEO, and AI-answer-engine citability. Use for "improve SEO", "why isn't this ranking", "meta description", or "optimise for AI search". |
Destructive and irreversible actions are annotated (destructiveHint) so
clients can prompt before running them. The skills instruct agents to confirm
before anything that sends mail, publishes content, or is otherwise visible to
other people.
Discovery (initialize, tools/list, prompts/list, resources/list)
never requires credentials, so registries can index the server without one.
Every action does.
Website — https://www.misar.blog
App — https://www.misar.blog
Documentation — https://docs.misar.io/blog/mcp
MIT © Misar.AI
Deprecated (the v1 reactions API sunsets on 2027-02-03): add a reaction to an article. Use upvote_article instead of like or clap, and save_article instead of bookmark. No-ops if already reacted. Requires API key.
Inputs: type (required), article_id (required).
Add an existing article to a series
Inputs: series_slug (required), article_slug (required), position.
Save an article as a draft on Misar.Blog (for review before publishing)
Inputs: title (required), body_markdown (required), tags.
Create a new series to group related articles
Inputs: title (required), description.
Generate a cover image using AI and upload it to the Misar.Blog CDN
Inputs: prompt (required), size.
Generate 5 SEO/AEO/GEO-optimized article titles from a topic or keyword prompt. Targets high-volume, low-competition long-tail keywords. Optimized for Google, AI answer engines (ChatGPT, Perplexity, Claude), Google AI Overviews, and AI search experiences. Each title includes a keyword strategy hint.
Inputs: prompt (required), context.
Get analytics summary (views, revenue, subscribers) for a time period
Inputs: days.
Get a single article by slug, including full markdown content
Inputs: slug (required).
Get follow status and follower count for a profile UUID. Requires an API key; counts against your plan's request quota.
Inputs: user_id (required).
Get your Misar.Blog creator profile
Inputs: no named parameters.
Deprecated (the v1 reactions API sunsets on 2027-02-03): get reaction counts and your reactions for an article. Use upvote_article / save_article for new work. Requires API key.
Inputs: article_id (required).
Get a creator's reputation: score, tier and tier name, upvotes received, progress toward the next tier, and badges. Requires an API key; counts against your plan's request quota.
Inputs: username (required).
List all your series on Misar.Blog
Inputs: no named parameters.
Get the comment thread for an article. Requires an API key; counts against your plan's request quota.
Inputs: article_id (required), limit, offset.
List your articles on Misar.Blog
Inputs: limit, status.
Get your sent and scheduled newsletter issues. Requires API key authentication.
Inputs: limit.
Get your newsletter subscriber list. Requires API key authentication.
Inputs: limit, offset.
List your saved articles, newest save first. Returns {items, next_cursor}; pass next_cursor back as cursor for the next page. Requires an API key; counts against your plan's request quota.
Inputs: limit, cursor.
Authenticate with your Misar.Blog account via browser — no API key copy-paste needed. Opens the Misar.Blog authorization page where you review the requested permissions and click 'Authorize'. Your API key is delivered straight back to this client and saved to ~/.misarblog/config.json.
Inputs: port, force, base_url.
Publish a new article (or schedule it) on Misar.Blog
Inputs: title (required), body_markdown (required), tags, visibility, +2 more.
Deprecated (the v1 reactions API sunsets on 2027-02-03): remove a specific reaction from an article. Use remove_upvote / unsave_article for new work. Requires API key.
Inputs: type (required), article_id (required).
Undo your repost of an article. Returns {reposted: false, repost_count}. Requires an API key; counts against your plan's request quota.
Inputs: article_id (required).
Remove your upvote from an article. Returns {upvoted: false, upvote_count}. Requires an API key; counts against your plan's request quota.
Inputs: article_id (required).
Repost an article to your followers, with an optional note (up to 280 characters). Needs reputation tier 1; you cannot repost your own article; notes are moderated. Reposting again replaces the note. Returns {reposted, repost_count}. Requires an API key; counts against your plan's request quota.
Inputs: article_id (required), note.
Research a topic and get AI-generated insights, sources, and a content outline. Useful before writing an article.
Inputs: query (required).
Save an article to your saved list to read later. Idempotent. Returns {saved, save_count}. Requires an API key; counts against your plan's request quota.
Inputs: article_id (required).
Search PUBLISHED articles across Misar.Blog by keyword, tag, or author — including other creators' work. Use list_my_articles for your own drafts and unpublished posts.
Inputs: q, tag, limit, author.
Check whether you are authenticated with Misar.Blog and which account is connected. Run this first to verify your connection.
Inputs: no named parameters.
Generate 5 compelling, SEO-friendly article title options from your existing article content. Use generate_title_seo instead if you want to target specific keywords or have not written content yet.
Inputs: context (required).
Remove an article from your saved list. Returns {saved: false, save_count}. Requires an API key; counts against your plan's request quota.
Inputs: article_id (required).
Update the title, body, or tags of an existing article or draft. Only the fields you pass are changed; omitted fields keep their current values.
Inputs: id (required), tags, title, body_markdown.
Show your current Misar.Blog plan, how much of each quota you have left, and what upgrading unlocks, with the link to upgrade. Call it any time — not only after hitting a limit. By default it only reads. With start_trial=true it starts the free, no-card trial on the account (a plan change; no payment is taken). It never upgrades a paid plan or takes payment itself: the user does that by following the link. On a local install, open=true also opens that link in the user's browser.
Inputs: open, plan, start_trial.
Upload a local image file to the Misar.Blog CDN
Inputs: file_path (required).
Upvote an article as the account holder. Idempotent: upvoting again changes nothing. Returns {upvoted, upvote_count}. Requires an API key; counts against your plan's request quota.
Inputs: article_id (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 34 tools
Most tools target distinct resources or actions, but title generation (generate_title_seo vs suggest_titles) and deprecated reaction tools overlapping with upvote/save create some confusion. Deprecation notes help, but a few boundaries remain ambiguous.
Predominantly snake_case verb_noun (get_article, publish_article, list_comments), with minor deviations like single-word status/login/upgrade and inconsistent removal verbs (unsave_article vs remove_upvote). Overall predictable and readable.
34 tools is heavy for a blog platform, including three deprecated reaction tools and many social/newsletter operations. While the domain is broad, the surface feels over-scoped and could be consolidated.
Core article lifecycle lacks a delete operation, and there is no way to create comments, remove articles from series, or perform follow/unfollow actions. These are notable gaps for a publishing platform.
Run your company blog for SEO and AI search from your AI assistant.
Write blog articles with AI and publish them to WordPress, Shopify and 30+ platforms.
Publish blog posts, send newsletters and emails from Claude, Claude Code, Codex and ChatGPT.
AI agents that research, write and publish SEO articles on your website, from your AI assistant.
