MCP Tools Reference
Complete reference for all 23 Misar.Blog MCP tools — parameters, required fields, and safety annotations.
The misarblog MCP server exposes 23 tools, 8 prompts, and 5 resources.
Authentication is automatic once MISARBLOG_API_KEY is set, or after running the
login tool. All responses are JSON.
Tools marked destructive send email, publish content, or otherwise take an action other people can see. MCP clients should confirm before running them.
Tools
upgrade
Show your current Misar.Blog plan, how much of each quota you have left, and what upgrading unlocks. Call it any time — not only after hitting a limit. Set open=true to open the checkout page in your browser.
No parameters.
get_profile
Get your Misar.Blog creator profile
No parameters.
get_analytics_summary
Get analytics summary (views, revenue, subscribers) for a time period
No parameters.
list_my_articles
List your articles on Misar.Blog
No parameters.
get_article
Get a single article by slug, including full markdown content
No parameters.
publish_article
Publish a new article (or schedule it) on Misar.Blog
No parameters.
create_draft
Save an article as a draft on Misar.Blog (for review before publishing)
No parameters.
update_article
Update the title, body, or tags of an existing article or draft. Only the fields you pass are changed; omitted fields keep their current values.
No parameters.
search_articles
Search PUBLISHED articles across Misar.Blog by keyword, tag, or author — including other creators' work. Use list_my_articles for your own drafts and unpublished posts.
No parameters.
research_topic
Research a topic and get AI-generated insights, sources, and a content outline. Useful before writing an article.
No parameters.
generate_title_seo
Generate 5 SEO/AEO/GEO-optimized article titles from a topic or keyword prompt. Targets high-volume, low-competition long-tail keywords. Optimized for Google, AI answer engines (ChatGPT, Perplexity, Claude), Google AI Overviews, and AI search experiences. Each title includes a keyword strategy hint.
No parameters.
suggest_titles
Generate 5 compelling, SEO-friendly article title options from your existing article content. Use generate_title_seo instead if you want to target specific keywords or have not written content yet.
No parameters.
generate_cover_image
Generate a cover image using AI and upload it to the Misar.Blog CDN
No parameters.
get_series
List all your series on Misar.Blog
No parameters.
create_series
Create a new series to group related articles
No parameters.
add_to_series
Add an existing article to a series
No parameters.
list_comments
Get public comments for an article. Rate-limited by IP — no API key required.
No parameters.
get_follow_status
Get public follow status and follower count for a user by their profile UUID. No API key required.
No parameters.
list_newsletter_subscribers
Get your newsletter subscriber list. Requires API key authentication.
No parameters.
list_newsletter_issues
Get your sent and scheduled newsletter issues. Requires API key authentication.
No parameters.
get_reactions
Get reaction counts and your reactions for an article. Requires API key.
No parameters.
add_reaction
Add a reaction to an article. No-ops if already reacted. Requires API key.
No parameters.
remove_reaction
Remove a specific reaction from an article. Requires API key.
No parameters.
Prompts
draft_article
Write a complete, SEO-optimised article draft and save it to Misar.Blog.
| Argument | Required | Description |
|---|---|---|
topic | yes | Topic, title idea, or detailed outline |
tone | no | professional | conversational | technical | beginner-friendly |
word_count | no | Target word count (default 800) |
improve_seo
Audit an article for SEO/AEO/GEO and apply the improvements.
| Argument | Required | Description |
|---|---|---|
article_slug | yes | Slug of the article to analyse |
write_newsletter
Draft a newsletter issue from recent published articles.
| Argument | Required | Description |
|---|---|---|
issue_title | yes | Newsletter subject line |
num_articles | no | How many articles to feature (default 3) |
article_ideas
Generate article ideas grounded in what has and has not been covered.
| Argument | Required | Description |
|---|---|---|
theme | no | Theme or niche to generate ideas within |
count | no | How many ideas (default 10) |
social_caption
Write platform-specific promotional captions for an article.
| Argument | Required | Description |
|---|---|---|
article_slug | yes | Slug of the article to promote |
platform | no | twitter | linkedin | reddit | all (default all) |
optimize_headline
Generate and rank stronger headline options for an article.
| Argument | Required | Description |
|---|---|---|
article_slug | no | Slug of the article |
topic | no | Topic, if the article does not exist yet |
series_plan
Plan a multi-part article series and set it up on Misar.Blog.
| Argument | Required | Description |
|---|---|---|
topic | yes | Subject of the series |
parts | no | How many parts (default 5) |
engagement_report
Summarise blog performance and recommend what to do next.
| Argument | Required | Description |
|---|---|---|
days | no | Look-back window in days (default 30) |
Resources
| URI | Description |
|---|---|
misarblog://profile | Your Misar.Blog profile — username, display name, bio, and payout status. Read this to get the author URL and handle right before writing anything public. |
misarblog://articles/recent | Your 20 most recent published articles. Useful as a style and coverage reference so a new draft neither repeats nor contradicts existing work. |
misarblog://articles/drafts | Your unpublished drafts, so work in progress can be resumed rather than restarted. |
misarblog://series | Your series and the articles in each, in order. |
misarblog://analytics/summary | Views, revenue, and subscriber counts for the last 30 days — the baseline for any performance question. |