MCP Setup

Prerequisites

• A MisarBlog account
• An MCP-compatible AI client (Claude Desktop, Claude Code, Cursor, Windsurf, or any MCP-capable client)

Step 1 — Get Your API Key

Every tool that touches your account needs an mbk_ API key (format: mbk_ + 64 hex characters = 68 characters total). You have two options:

• From the dashboard — go to Dashboard → Settings → API Keys, create a key, and copy it. It's shown only once. Provide it via the MISARBLOG_API_KEY env var (see below).
• Browser login (stdio only) — skip the copy-paste and use the stdio server's browser login after setup. It opens your browser to the settings page where you click Authorize MCP Access; the key is saved to ~/.misarblog/config.json automatically.

Step 2 — Choose a Transport

Option A — Stdio (npm package, works everywhere)

Install once globally, or run directly with npx:

npm install -g @misarblog/mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "misarblog": {
      "command": "misarblog-mcp",
      "env": {
        "MISARBLOG_API_KEY": "mbk_YOUR_KEY"
      }
    }
  }
}

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Code

claude mcp add misarblog -- misarblog-mcp
# Then set your key:
export MISARBLOG_API_KEY=mbk_YOUR_KEY

Or use npx without installing:

claude mcp add misarblog -- npx @misarblog/mcp

Option B — HTTP (Remote MCP, no install required)

Use this if your client supports remote MCP servers over HTTP.

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "misarblog": {
      "type": "http",
      "url": "https://api.misar.io/blog/v1/mcp",
      "headers": {
        "Authorization": "Bearer mbk_YOUR_KEY"
      }
    }
  }
}

Cursor / Windsurf (.cursor/mcp.json or .windsurf/mcp.json)

{
  "mcpServers": {
    "misarblog": {
      "type": "http",
      "url": "https://api.misar.io/blog/v1/mcp",
      "headers": {
        "Authorization": "Bearer mbk_YOUR_KEY"
      }
    }
  }
}

Step 3 — Verify Connection

Restart your AI client and run:

Show my MisarBlog profile

Your client should call the get_profile tool and confirm which account is connected. Then try:

List my MisarBlog articles

which calls list_my_articles.

Available Tools

The server exposes 23 tools — connection & account, articles & drafts, AI writing, images, series, reactions, engagement, and newsletter — plus 6 prompt primitives. See the Tools Reference and Prompts for every tool's and prompt's parameters and examples.

Revoking Access

Go to Dashboard → Settings → API Keys and revoke the key. Access is removed immediately on the next tool call.

Troubleshooting