MCP Tools Reference

All tools require an mbk_ API key in the Authorization: Bearer header. See Setup to configure your client.

misarblog_get_profile

Returns the authenticated creator's profile.

Parameters: none

Returns:

{
  "username": "johndoe",
  "display_name": "John Doe",
  "follower_count": 842,
  "article_count": 37
}

misarblog_list_articles

Lists published articles with optional filters.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | limit | integer | No | Max results (default 20, max 100) | | offset | integer | No | Pagination offset | | tag | string | No | Filter by tag slug |

Example prompt: "List my last 5 articles tagged nextjs"

misarblog_get_article

Fetches a single article including its full Markdown content.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | slug | string | Yes | Article slug |

misarblog_publish_article

Publishes a new article or schedules it.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | title | string | Yes | Article title | | content | string | Yes | Markdown body | | excerpt | string | No | Preview text | | slug | string | No | URL slug (auto-generated if omitted) | | tags | string[] | No | Tag slugs (max 5) | | featured_image_url | string | No | Cover image URL | | is_premium | boolean | No | Lock behind subscription | | scheduled_at | string | No | ISO 8601 publish datetime |

Example prompt: "Publish this article with the title 'Building with AI' and tag it nextjs and ai"

misarblog_save_draft

Saves content as a private draft.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | title | string | Yes | Draft title | | content | string | No | Markdown body | | tags | string[] | No | Tag slugs |

misarblog_generate_titles

Returns AI-generated title suggestions.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | topic | string | Yes | Topic or outline | | tone | string | No | technical | conversational | clickbait | | count | integer | No | Number of suggestions (1–10) |

Example prompt: "Give me 5 title ideas for an article about WebSocket performance"

misarblog_research

Streams AI research on a topic. The client receives the full output once streaming completes.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | topic | string | Yes | Research topic | | depth | string | No | brief | detailed | comprehensive |

Example prompt: "Research the impact of edge computing on web latency — comprehensive depth"

misarblog_generate_image

Generates an AI cover image and returns a CDN URL.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | prompt | string | Yes | Image description | | style | string | No | photorealistic | illustration | minimal | | aspect_ratio | string | No | 16:9 | 1:1 | 4:3 |

Example prompt: "Generate a cover image: a glowing neural network over a dark city skyline, photorealistic"

misarblog_get_analytics

Fetches views, revenue, and subscriber stats.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | period | string | No | 7d | 30d | 90d | all (default 30d) |

Example prompt: "Show me my MisarBlog analytics for the last 7 days"