MCP Server Overview
Connect AI assistants to MisarBlog via the Model Context Protocol (MCP).
The MisarBlog MCP server (@misarblog/mcp v1.0.6) exposes your blog content and writing tools to any MCP-compatible AI assistant (Claude, Cursor, Windsurf, etc.), letting you publish, draft, research, and analyze directly from your AI workflow.
What You Can Do
The server registers 23 tools across these areas:
| Area | Tools |
|---|---|
| Connection & account | login, status, get_profile, get_analytics_summary |
| Articles & drafts | list_my_articles, get_article, create_draft, publish_article |
| AI writing | research_topic, generate_title_seo, suggest_titles |
| Images | upload_image, generate_cover_image |
| Series | get_series, create_series, add_to_series |
| Reactions | get_reactions, add_reaction, remove_reaction |
| Engagement | list_comments, get_follow_status |
| Newsletter | list_newsletter_subscribers, list_newsletter_issues |
See the Tools Reference for every tool's parameters and examples.
Tools and prompts
The server registers 23 tools and 6 MCP prompt primitives (discoverable via prompts/list). It does not register resource primitives. See MCP Prompts for the prompt arguments and behavior.
Authentication
Tool calls are authenticated with an mbk_ API key. There are two ways to provide it:
- Environment variable — set
MISARBLOG_API_KEY=mbk_...(get a key from Dashboard → Settings → API Keys). - Browser login (stdio) — the stdio server can open your browser to the settings page where you click Authorize MCP Access; the key is written to
~/.misarblog/config.jsonautomatically. No copy-paste needed.
Transport & configuration
The stdio server ships as the @misarblog/mcp npm package (binary misarblog-mcp) and communicates over standard input/output. A remote HTTP endpoint is also available at https://api.misar.io/blog/v1/mcp for clients that support remote MCP servers.
Configuration env vars:
| Variable | Required | Description |
|---|---|---|
MISARBLOG_API_KEY | Recommended | Your mbk_ key. Optional if you use browser login (stdio). |
MISARBLOG_BASE_URL | No | Override the API base (default https://api.misar.io/blog/v1). Used for self-hosted instances. |
Next Steps
- Setup — Install and configure the MCP server
- Tools Reference — All 23 tools with parameters and examples
- MCP Prompts — The 6 prompt primitives and their arguments