Misar.Blog MCP Server

io.github.Misar-AIPublished by GitHub account Misar-AIv5.1.8Updated Nov 7, 2026

Publish and manage articles, series, comments, reactions, newsletters, and analytics — from any AI…

VerifiedStreamable HTTPWeb executableProductivity & WorkflowCommunication & CollaborationData & Analytics

Overview

AI-generated overview

Lets an AI assistant write, publish and manage Misar.Blog articles, series, newsletters and analytics through the Misar.Blog API.

What you can do
  • List, read, search, draft, publish, schedule and update articles, including full markdown content
  • Create and manage series and add articles to them
  • Read analytics, profile, follower status, reputation, comments and newsletter subscribers and issues
  • Generate AI research, SEO titles, title suggestions and cover images
  • Upvote, save, repost and react to articles, plus check plan quotas and start a trial
  • Reusable prompts and read-only resources for drafting, SEO audits, newsletters and performance reports
When to use it
Useful for creators and teams who publish on Misar.Blog and want an assistant to draft, SEO-optimize, schedule and publish posts, plan series, write newsletters, or report on views, revenue and subscribers without leaving the chat.
Requirements
Either the remote Streamable HTTP endpoint or the local npm package run with npx (Node.js). A Misar.Blog account and API key, supplied as MISARBLOG_API_KEY or an Authorization bearer header, or obtained through the browser login tool. MISARBLOG_BASE_URL only for self-hosted instances. Network access to Misar.Blog.
Before you install
The API key grants account-level access and is stored locally after browser login. Publishing, scheduling, updating, reposting, upvoting and newsletter-related actions change public content or send mail; the README says agents should confirm first, but verify before letting an assistant act. The upgrade tool can start a free trial, a plan change. Some tools consume the plan's request quota, and the v1 reactions tools are deprecated.

Installation

In SourceWeft

  1. Open Misar.Blog MCP Server in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Misar-AI%2Fmisarblog-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "misar-blog": {
      "type": "http",
      "url": "https://www.misar.blog/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

Misar.Blog MCP Server

Publish and manage articles, series, upvotes, saved, reposts, reputation, newsletters and analytics — from any AI assistant.

[npm] [smithery] [license]

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.

Install

Smithery (recommended)

bash
npx -y @smithery/cli install misar/misarblog-mcp --client claude

Claude Code

bash
claude mcp add misarblog -- npx -y @misarblog/mcp@latest

Manual (any client)

json
{  "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/.

Remote (no install)

json
{  "mcpServers": {    "misarblog": {      "type": "streamable-http",      "url": "https://www.misar.blog/api/mcp",      "headers": { "Authorization": "Bearer mbk_your_key_here" }    }  }}

Authentication

Two options — no copy-paste needed for the first:

  1. 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.
  2. 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.

Tools

ToolDescription
upgradeShow your current Misar.Blog plan, how much of each quota you have left, and what upgrading unlocks, with the link to upgrade.
get_profileGet your Misar.Blog creator profile.
get_analytics_summaryGet analytics summary (views, revenue, subscribers) for a time period.
list_my_articlesList your articles on Misar.Blog.
get_articleGet a single article by slug, including full markdown content.
publish_articlePublish a new article (or schedule it) on Misar.Blog.
create_draftSave an article as a draft on Misar.Blog (for review before publishing).
update_articleUpdate the title, body, or tags of an existing article or draft.
search_articlesSearch PUBLISHED articles across Misar.Blog by keyword, tag, or author — including other creators' work.
research_topicResearch a topic and get AI-generated insights, sources, and a content outline.
generate_title_seoGenerate 5 SEO/AEO/GEO-optimized article titles from a topic or keyword prompt.
suggest_titlesGenerate 5 compelling, SEO-friendly article title options from your existing article content.
generate_cover_imageGenerate a cover image using AI and upload it to the Misar.Blog CDN.
get_seriesList all your series on Misar.Blog.
create_seriesCreate a new series to group related articles.
add_to_seriesAdd an existing article to a series.
list_commentsGet the comment thread for an article.
get_follow_statusGet follow status and follower count for a profile UUID.
list_newsletter_subscribersGet your newsletter subscriber list.
list_newsletter_issuesGet your sent and scheduled newsletter issues.
upvote_articleUpvote an article as the account holder.
remove_upvoteRemove your upvote from an article.
save_articleSave an article to your saved list to read later.
unsave_articleRemove an article from your saved list.
list_savedList your saved articles, newest save first.
get_reputationGet a creator's reputation: score, tier and tier name, upvotes received, progress toward the next tier, and badges.
repost_articleRepost an article to your followers, with an optional note (up to 280 characters).
remove_repostUndo your repost of an article.
get_reactionsDeprecated (the v1 reactions API sunsets on 2027-02-03): get reaction counts and your reactions for an article.
add_reactionDeprecated (the v1 reactions API sunsets on 2027-02-03): add a reaction to an article.
remove_reactionDeprecated (the v1 reactions API sunsets on 2027-02-03): remove a specific reaction from an article.

Prompts

Reusable workflows your client exposes as slash-commands.

PromptDescription
draft_articleWrite a complete, SEO-optimised article draft and save it to Misar.Blog.
improve_seoAudit an article for SEO/AEO/GEO and apply the improvements.
write_newsletterDraft a newsletter issue from recent published articles.
article_ideasGenerate article ideas grounded in what has and has not been covered.
social_captionWrite platform-specific promotional captions for an article.
optimize_headlineGenerate and rank stronger headline options for an article.
series_planPlan a multi-part article series and set it up on Misar.Blog.
engagement_reportSummarise blog performance and recommend what to do next.

Resources

Read-only context an agent can attach without spending a tool call.

URIDescription
misarblog://profileYour Misar.Blog profile — username, display name, bio, and payout status.
misarblog://articles/recentYour 20 most recent published articles.
misarblog://articles/draftsYour unpublished drafts, so work in progress can be resumed rather than restarted..
misarblog://seriesYour series and the articles in each, in order..
misarblog://analytics/summaryViews, revenue, and subscriber counts for the last 30 days — the baseline for any performance question..

Agent skills

Bundled in skills/ — guidance an agent loads when a task matches.

SkillUse when
blog-analytics-reportReport on Misar.Blog performance — views, revenue, subscribers, engagement. Use for "how is my blog doing", traffic reports, or content performance analysis.
manage-article-seriesPlan and manage a multi-part article series on Misar.Blog. Use for "series", "multi-part", "part 2", or organising related posts into a sequence.
newsletter-campaign-reportDraft and review Misar.Blog newsletter issues and subscriber performance. Use for "newsletter", "email my subscribers", or newsletter performance questions.
promote-articleWrite 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.
publish-blog-postWrite, 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.
seo-optimize-articleAudit 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".

Safety

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.

Links

MIT © Misar.AI

Source: README.md at commit 176db82

Tools

23

upgrade

Plan usage and upgrade

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.

Parametersopenplanstart_trial

get_profile

Get profile

Get your Misar.Blog creator profile

Takes no parameters.

get_analytics_summary

Analytics summary

Get analytics summary (views, revenue, subscribers) for a time period

Parametersdays

list_my_articles

List my articles

List your articles on Misar.Blog

Parameterslimitstatus

get_article

Get article

Get a single article by slug, including full markdown content

Parametersslugrequired

publish_article

Publish article

Publish a new article (or schedule it) on Misar.Blog

Parameterstagstitlerequiredvisibilityschedule_atbody_markdownrequiredcover_image_url

create_draft

Create draft

Save an article as a draft on Misar.Blog (for review before publishing)

Parameterstagstitlerequiredbody_markdownrequired

update_article

Update article

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.

Parametersidrequiredtagstitlebody_markdown

search_articles

Search articles

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.

Parametersqtaglimitauthor

research_topic

Research topic

Research a topic and get AI-generated insights, sources, and a content outline. Useful before writing an article.

Parametersqueryrequired

generate_title_seo

Generate SEO titles

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.

Parameterspromptrequiredcontext

suggest_titles

Suggest titles

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.

Parameterscontextrequired

generate_cover_image

Generate cover image

Generate a cover image using AI and upload it to the Misar.Blog CDN

Parameterssizepromptrequired

get_series

List series

List all your series on Misar.Blog

Takes no parameters.

create_series

Create series

Create a new series to group related articles

Parameterstitlerequireddescription

add_to_series

Add to series

Add an existing article to a series

Parameterspositionseries_slugrequiredarticle_slugrequired

list_comments

List comments

Get the comment thread for an article. Requires an API key; counts against your plan's request quota.

Parameterslimitoffsetarticle_idrequired

get_follow_status

Follow status

Get follow status and follower count for a profile UUID. Requires an API key; counts against your plan's request quota.

Parametersuser_idrequired

list_newsletter_subscribers

List subscribers

Get your newsletter subscriber list. Requires API key authentication.

Parameterslimitoffset

list_newsletter_issues

List newsletter issues

Get your sent and scheduled newsletter issues. Requires API key authentication.

Parameterslimit

get_reactions

Get reactions

Get reaction counts and your reactions for an article. Requires API key.

Parametersarticle_idrequired

add_reaction

Add reaction

Add a reaction to an article. No-ops if already reacted. Requires API key.

Parameterstyperequiredarticle_idrequired

remove_reaction

Remove reaction

Remove a specific reaction from an article. Requires API key.

Parameterstyperequiredarticle_idrequired

Version history

2
  1. v5.1.8LatestOct 17, 2026
  2. v5.1.2Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts