# Misar.Blog MCP Server

Publish and manage blog posts, articles, and series on Misar.Blog directly from your AI agent. Features 20 tools: create/publish articles, manage series, query analytics, handle comments, reactions, …

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add misar/misarblog-mcp

# Browse available tools
npx -y smithery tool list misar/misarblog-mcp

# Get full schema for a tool
npx -y smithery tool get misar/misarblog-mcp get_profile

# Call a tool
npx -y smithery tool call misar/misarblog-mcp get_profile '{}'
```

## Direct MCP Connection

Endpoint: `https://misarblog-mcp--misar.run.tools`

**Required config:**
- `apiKey` (query) — Your Misar.Blog API key (starts with mbk_). Get one from https://www.misar.blog/settings/api

## Tools (20)

- `get_profile` — Get your Misar.Blog creator profile
- `get_analytics_summary` — Get analytics summary (views, revenue, subscribers) for a time period
- `list_my_articles` — List your articles on Misar.Blog
- `get_article` — Get a single article by slug, including full markdown content
- `publish_article` — Publish a new article on Misar.Blog
- `create_draft` — Save an article as a draft on Misar.Blog
- `get_series` — List all your series on Misar.Blog
- `create_series` — Create a new series to group related articles
- `add_to_series` — Add an existing article to a series
- `research_topic` — Research a topic and get AI-generated insights, sources, and a content outline
- `generate_title_seo` — Generate 5 SEO/AEO/GEO-optimized article titles from a topic or keyword prompt
- `suggest_titles` — Generate 5 compelling, SEO-friendly article title options from your existing article content
- `generate_cover_image` — Generate a cover image using AI and upload it to the Misar.Blog CDN
- `list_comments` — Get public comments for an article
- `get_follow_status` — Get public follow status and follower count for a user by their profile UUID
- `get_reactions` — Get reaction counts for an article
- `add_reaction` — Add a reaction to an article
- `remove_reaction` — Remove a reaction from an article
- `list_newsletter_subscribers` — Get your newsletter subscriber list
- `list_newsletter_issues` — Get your sent and scheduled newsletter issues

```bash
# Get full input/output schema for a tool
npx -y smithery tool get misar/misarblog-mcp <tool-name>
```
