@misarblog/mcp — Misar.Blog MCP Server

Publish & manage your blog from Claude Code, Cursor, or Windsurf

Publish blog posts, manage drafts, organize series, run AI research/title/cover-image generation, and pull analytics — all from your AI coding environment. Connect your Misar.Blog creator account via an API key or the one-click login browser flow (no copy-paste).

The stdio package exposes 23 tools. On the hosted Smithery remote (streamable-HTTP), 20 are available — the three local-only tools (login, status, upload_image) require a local process and are not exposed over remote HTTP.

Installation

Claude Code

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

Then set your API key:

export MISARBLOG_API_KEY=mbk_your_key

Manual configuration (Cursor, Windsurf, VS Code, any MCP client)

{
  "mcpServers": {
    "misarblog": {
      "command": "npx",
      "args": ["-y", "@misarblog/mcp"],
      "env": {
        "MISARBLOG_API_KEY": "mbk_your_key"
      }
    }
  }
}

• Cursor — ~/.cursor/mcp.json (global) or .cursor/mcp.json (project)
• Windsurf — ~/.codeium/windsurf/mcp_config.json
• VS Code (Copilot) — .vscode/mcp.json, add "type": "stdio" to the server entry

Hosted remote (no local install)

Install the hosted server straight from Smithery — it runs the package for you and connects over streamable-HTTP:

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

Or add the remote endpoint directly and authenticate with a Bearer API key:

https://www.misar.blog/api/mcp
Authorization: Bearer mbk_your_key

Authentication

Option 1 — API key (recommended). Generate a key at Dashboard → Settings → API Keys (it starts with mbk_), then set MISARBLOG_API_KEY. Keys are rate-limited to 100 req/min and can be revoked or regenerated at any time.

Option 2 — browser login (stdio only). Omit MISARBLOG_API_KEY and call the login tool as your first request. It starts a temporary 127.0.0.1 listener, opens https://www.misar.blog/dashboard/settings/api?mcp_port=<port>, and saves the returned key to ~/.misarblog/config.json — no clipboard involved. The listener is local-only and shuts down after 120 seconds.

Tools

23 tools over stdio; the 20 marked ✓ are also available on the Smithery remote.

Full parameter tables, return shapes, and example prompts live in the MCP Tools Reference.

Usage examples

Prompts you can send directly in Claude Code or Cursor Agent mode:

Write a 1000-word article about "Why AI-first blogging changes SEO forever"
and publish it on my Misar.Blog with tags ["AI", "SEO", "blogging"].

Generate a dark, futuristic cover image for an article titled "Building with MCP",
then create a draft with that image as the cover.

List my published articles, create a series called "AI Writing Guide",
and add the last 3 to it in chronological order.

Show me my analytics for the last 90 days.

Self-hosted Misar.Blog

Point the server at your own instance with MISARBLOG_BASE_URL:

{
  "mcpServers": {
    "misarblog": {
      "command": "npx",
      "args": ["-y", "@misarblog/mcp"],
      "env": {
        "MISARBLOG_API_KEY": "mbk_your_key",
        "MISARBLOG_BASE_URL": "https://blog.yourdomain.com"
      }
    }
  }
}

Requirements

• Node.js >= 18 (package fetched automatically via npx)
• A Misar.Blog creator account
• An API key from your dashboard, or the login tool

Links

• Homepage — https://www.misar.blog
• Smithery — https://smithery.ai/server/misar/misarblog-mcp
• Docs — https://docs.misar.io/blog
• npm — https://www.npmjs.com/package/@misarblog/mcp
• Source — https://git.misar.io/misaradmin/misar-io (packages/blog-mcp-server/)

License

MIT — Copyright (c) 2026 Misar AI Technology Pvt Ltd