MCP Setup

Prerequisites

• A Misar.Blog account at www.misar.blog
• An MCP-compatible AI client (Claude Desktop, Cursor, Windsurf, or any MCP-capable client)

Step 1 — Get Your API Key

The MCP connect flow generates a key automatically. Trigger it from your browser while logged in:

POST https://api.misar.io/blog/v1/auth/mcp-connect?callback_port=6748

Or visit Dashboard → Settings → API Keys → Connect MCP — the UI handles the flow and writes the key to your local MCP config automatically.

The key starts with mbk_ and is delivered to http://localhost:6748/callback (your local MCP client). Store it securely — it's shown only once.

Step 2 — Choose a Transport

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

Use this if your client supports remote MCP servers over HTTP. No npm install needed.

Claude Desktop (claude_desktop_config.json)

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

Config file locations:

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

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"
      }
    }
  }
}

Option B — 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"
      }
    }
  }
}

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

Step 3 — Verify Connection

Restart your AI client and run:

List my Misar.Blog articles

Your client should call list_articles and return your articles.

Available Tools

Revoking MCP Access

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

Troubleshooting