MCP Tools Reference
All MisarBlog MCP tools with parameters, examples, and return values.
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"