@misarblog/mcp 1.0.5 → 1.0.6

package/README.md

@@ -45,13 +45,13 @@ chmod +x ~/.claude/scripts/misarblog-mcp.py
 
 # 2. Add to Claude Code MCP settings (see below)
 
-# 3. Run misarblog_login in Claude Code to authenticate via browser
+# 3. Run login in Claude Code to authenticate via browser
 ```
 
 **Fastest path — npx + any MCP client:**
 
 ```bash
-# No install needed — just add the config below and run misarblog_login
+# No install needed — just add the config below and run login
 ```
 
 ---
@@ -101,7 +101,7 @@ If you're on macOS with an older system Python, use Homebrew: `brew install pyth
 }
 ```
 
-> You can omit `MISARBLOG_API_KEY` if you plan to use the `misarblog_login` browser flow.
+> You can omit `MISARBLOG_API_KEY` if you plan to use the `login` browser flow.
 
 ---
 
@@ -197,7 +197,7 @@ code ~/.claude/settings.json
 **Verify the connection:**
 
 ```text
-> call misarblog_get_profile
+> call get_profile
 ```
 
 Claude Code should return your username, display name, and account status.
@@ -236,7 +236,7 @@ project (project-scoped, takes priority).
    - **Env**: `MISARBLOG_API_KEY=mbk_your_key_here`
 4. Click **Save** — Cursor restarts the MCP daemon automatically.
 
-Verify: open Cursor Agent mode → type `use misarblog_get_profile` — the tool card should appear.
+Verify: open Cursor Agent mode → type `use get_profile` — the tool card should appear.
 
 ---
 
@@ -303,7 +303,7 @@ VS Code reads MCP config from `.vscode/mcp.json` in the workspace root, or from
 }
 ```
 
-Restart VS Code after saving. The `misarblog_*` tools appear in GitHub Copilot Chat when
+Restart VS Code after saving. The Misar.Blog tools appear in GitHub Copilot Chat when
 you enable **Agent mode** (the `@` icon in the chat panel).
 
 ---
@@ -315,7 +315,7 @@ Any MCP-compatible client that supports stdio servers works with the same patter
 - **Command**: `python3` (Python) or `npx` (npm)
 - **Args**: `["~/.claude/scripts/misarblog-mcp.py"]` or `["-y", "@misarblog/mcp"]`
 - **Transport**: `stdio`
-- **Env**: `MISARBLOG_API_KEY=mbk_...` (or use `misarblog_login` after connecting)
+- **Env**: `MISARBLOG_API_KEY=mbk_...` (or use `login` after connecting)
 
 ---
 
@@ -332,13 +332,13 @@ Keys have a 100 req/min rate limit. You can revoke and regenerate at any time fr
 **Precedence order:**
 
 ```text
-MISARBLOG_API_KEY env var  →  ~/.misarblog/config.json  →  prompt to run misarblog_login
+MISARBLOG_API_KEY env var  →  ~/.misarblog/config.json  →  prompt to run login
 ```
 
 ### Browser login (no copy-paste)
 
 If you'd rather not handle the key manually, omit `MISARBLOG_API_KEY` from the config and run
-`misarblog_login` as your first tool call. The flow:
+`login` as your first tool call. The flow:
 
 1. The MCP server starts a temporary HTTP listener on `127.0.0.1` (random port 9001–9099)
 2. Your default browser opens to `https://www.misar.blog/dashboard/settings/api?mcp_port=<port>`
@@ -352,7 +352,7 @@ The listener accepts connections from `127.0.0.1` only and shuts down after 120
 **Example prompt:**
 
 ```text
-Connect my Misar.Blog account using misarblog_login
+Connect my Misar.Blog account using login
 ```
 
 Claude will call the tool, open your browser, and confirm once you've authorized.
@@ -361,24 +361,228 @@ Claude will call the tool, open your browser, and confirm once you've authorized
 
 ## Tools reference
 
-The server registers **23 tools**. Names are used verbatim (e.g. `publish_article`) — your MCP
-client selects them from natural-language requests. Most require an `mbk_` key; the two public tools
-(`list_comments`, `get_follow_status`) need none.
-
-| Area | Tools |
-| ---- | ----- |
-| Connection & account | `login`, `status`, `get_profile` |
-| Articles & drafts | `list_my_articles`, `get_article`, `publish_article`, `create_draft` |
-| Series | `get_series`, `create_series`, `add_to_series` |
-| AI writing | `research_topic`, `generate_title_seo`, `suggest_titles` |
-| Images | `upload_image`, `generate_cover_image` |
-| Analytics | `get_analytics_summary` |
-| Comments & follows (public) | `list_comments`, `get_follow_status` |
-| Newsletter | `list_newsletter_subscribers`, `list_newsletter_issues` |
-| Reactions | `get_reactions`, `add_reaction`, `remove_reaction` |
-
-Full parameter tables, return shapes, and example prompts for every tool live in the
-**[MCP Tools Reference](https://docs.misar.io/blog/mcp/tools)**.
+The server exposes **23 tools**. Names are unprefixed — call them exactly as
+shown (e.g. `login`, `publish_article`, `get_analytics_summary`).
+
+### Auth
+
+| Tool | Description | Required params |
+| ---- | ----------- | --------------- |
+| `login` | Browser-based auth — saves key to `~/.misarblog/config.json` | — |
+| `status` | Check whether you're authenticated and which account is connected | — |
+
+### Articles
+
+| Tool | Description | Required params |
+| ---- | ----------- | --------------- |
+| `list_my_articles` | List your articles, optionally filtered by status | — |
+| `get_article` | Fetch a single article by slug, including full markdown | `slug` |
+| `publish_article` | Publish now or schedule via ISO 8601 datetime | `title`, `body_markdown` |
+| `create_draft` | Save a draft for review in the web editor | `title`, `body_markdown` |
+
+### AI
+
+| Tool | Description | Required params |
+| ---- | ----------- | --------------- |
+| `research_topic` | Research a topic — insights, sources, and a content outline | `query` |
+| `generate_title_seo` | Generate 5 SEO/AEO/GEO-optimized titles from a topic or keyword | `prompt` |
+| `suggest_titles` | Generate 5 title options from your existing article content | `context` |
+
+### Images
+
+| Tool | Description | Required params |
+| ---- | ----------- | --------------- |
+| `upload_image` | Upload a local image file to the Misar.Blog CDN | `file_path` |
+| `generate_cover_image` | Generate an AI cover image and upload it to the CDN | `prompt` |
+
+### Series
+
+| Tool | Description | Required params |
+| ---- | ----------- | --------------- |
+| `get_series` | List all your series | — |
+| `create_series` | Create a new series to group related articles | `title` |
+| `add_to_series` | Add an existing article to a series | `series_slug`, `article_slug` |
+
+### Comments
+
+| Tool | Description | Required params |
+| ---- | ----------- | --------------- |
+| `list_comments` | Get public comments for an article (no API key required) | `article_id` |
+
+### Follows
+
+| Tool | Description | Required params |
+| ---- | ----------- | --------------- |
+| `get_follow_status` | Get public follow status and follower count for a user (no API key required) | `user_id` |
+
+### Newsletter
+
+| Tool | Description | Required params |
+| ---- | ----------- | --------------- |
+| `list_newsletter_subscribers` | Get your newsletter subscriber list | — |
+| `list_newsletter_issues` | Get your sent and scheduled newsletter issues | — |
+
+### Reactions
+
+| Tool | Description | Required params |
+| ---- | ----------- | --------------- |
+| `get_reactions` | Get reaction counts and your reactions for an article | `article_id` |
+| `add_reaction` | Add a reaction to an article (no-ops if already reacted) | `article_id`, `type` |
+| `remove_reaction` | Remove a specific reaction from an article | `article_id`, `type` |
+
+### Analytics
+
+| Tool | Description | Required params |
+| ---- | ----------- | --------------- |
+| `get_analytics_summary` | Views, revenue, and subscribers for a time period (up to 365 days) | — |
+
+### Profile
+
+| Tool | Description | Required params |
+| ---- | ----------- | --------------- |
+| `get_profile` | Your creator profile — username, display name, bio, Stripe status | — |
+
+### Tool parameters
+
+#### `login`
+
+| Param | Type | Default | Description |
+| ----- | ---- | ------- | ----------- |
+| `port` | number | random 9001–9099 | Local callback port (9001–9099) |
+| `base_url` | string | `https://www.misar.blog` | Misar.Blog base URL for self-hosted instances |
+| `force` | boolean | `false` | Force re-authentication even if already logged in (rotates your API key) |
+
+#### `list_my_articles`
+
+| Param | Type | Default | Description |
+| ----- | ---- | ------- | ----------- |
+| `status` | string | all | Filter: `draft` · `published` · `scheduled` · `archived` (omit for all) |
+| `limit` | number | `20` | Number of articles to return, 1–100 |
+
+#### `get_article`
+
+| Param | Type | Required | Description |
+| ----- | ---- | -------- | ----------- |
+| `slug` | string | yes | The article slug |
+
+#### `publish_article`
+
+| Param | Type | Required | Description |
+| ----- | ---- | -------- | ----------- |
+| `title` | string | yes | Article title (max 250 chars) |
+| `body_markdown` | string | yes | Full article body in Markdown |
+| `tags` | string[] | no | Up to 10 tags |
+| `cover_image_url` | string | no | URL of the cover image |
+| `schedule_at` | string | no | ISO 8601 timestamp to schedule; omit to publish immediately |
+| `visibility` | string | no | `public` · `subscribers` · `paid` · `private` (default: `public`) |
+
+#### `create_draft`
+
+| Param | Type | Required | Description |
+| ----- | ---- | -------- | ----------- |
+| `title` | string | yes | Draft title |
+| `body_markdown` | string | yes | Full article body in Markdown |
+| `tags` | string[] | no | Tags for the draft |
+
+#### `research_topic`
+
+| Param | Type | Required | Description |
+| ----- | ---- | -------- | ----------- |
+| `query` | string | yes | Research topic or question (5–500 chars). Be specific for best results |
+
+#### `generate_title_seo`
+
+| Param | Type | Required | Description |
+| ----- | ---- | -------- | ----------- |
+| `prompt` | string | yes | Your topic or target keywords (3–500 chars) |
+| `context` | string | no | Existing article content (plain text or markdown, max 8000 chars) to align titles |
+
+#### `suggest_titles`
+
+| Param | Type | Required | Description |
+| ----- | ---- | -------- | ----------- |
+| `context` | string | yes | Your article content in plain text or markdown (20–8000 chars) |
+
+#### `upload_image`
+
+| Param | Type | Required | Description |
+| ----- | ---- | -------- | ----------- |
+| `file_path` | string | yes | Absolute path to the image file (JPEG, PNG, WebP, or GIF) |
+
+#### `generate_cover_image`
+
+| Param | Type | Default | Description |
+| ----- | ---- | ------- | ----------- |
+| `prompt` | string | — | Description of the image to generate (max 1000 chars) |
+| `size` | string | `1792x1024` | `1024x1024` · `1792x1024` · `1024x1792` |
+
+#### `create_series`
+
+| Param | Type | Required | Description |
+| ----- | ---- | -------- | ----------- |
+| `title` | string | yes | Series title |
+| `description` | string | no | Short description of the series |
+
+#### `add_to_series`
+
+| Param | Type | Required | Description |
+| ----- | ---- | -------- | ----------- |
+| `series_slug` | string | yes | The series slug |
+| `article_slug` | string | yes | The article slug to add |
+| `position` | number | no | 1-indexed position; appends to end if omitted |
+
+#### `list_comments`
+
+| Param | Type | Default | Description |
+| ----- | ---- | ------- | ----------- |
+| `article_id` | string | — | UUID of the article to fetch comments for (required) |
+| `limit` | number | `20` | Max results, 1–100 |
+| `offset` | number | `0` | Pagination offset |
+
+#### `get_follow_status`
+
+| Param | Type | Required | Description |
+| ----- | ---- | -------- | ----------- |
+| `user_id` | string | yes | UUID of the profile to check follow status for |
+
+#### `list_newsletter_subscribers`
+
+| Param | Type | Default | Description |
+| ----- | ---- | ------- | ----------- |
+| `limit` | number | `20` | Max results, 1–100 |
+| `offset` | number | `0` | Pagination offset |
+
+#### `list_newsletter_issues`
+
+| Param | Type | Default | Description |
+| ----- | ---- | ------- | ----------- |
+| `limit` | number | `10` | Max results, 1–50 |
+
+#### `get_reactions`
+
+| Param | Type | Required | Description |
+| ----- | ---- | -------- | ----------- |
+| `article_id` | string | yes | UUID of the article |
+
+#### `add_reaction`
+
+| Param | Type | Required | Description |
+| ----- | ---- | -------- | ----------- |
+| `article_id` | string | yes | UUID of the article |
+| `type` | string | yes | Reaction type: `like` · `clap` · `bookmark` |
+
+#### `remove_reaction`
+
+| Param | Type | Required | Description |
+| ----- | ---- | -------- | ----------- |
+| `article_id` | string | yes | UUID of the article |
+| `type` | string | yes | Reaction type to remove: `like` · `clap` · `bookmark` |
+
+#### `get_analytics_summary`
+
+| Param | Type | Default | Description |
+| ----- | ---- | ------- | ----------- |
+| `days` | number | `30` | Look-back window, 1–365 |
 
 ---
 
@@ -440,7 +644,7 @@ If you run your own Misar.Blog instance, set `MISARBLOG_BASE_URL` to your domain
 }
 ```
 
-`MISARBLOG_BASE_URL` can also be stored in `~/.misarblog/config.json` (written by `misarblog_login`):
+`MISARBLOG_BASE_URL` can also be stored in `~/.misarblog/config.json` (written by `login`):
 
 ```json
 {
@@ -459,19 +663,19 @@ If you run your own Misar.Blog instance, set `MISARBLOG_BASE_URL` to your domain
 The server can't find your API key. Either:
 
 - Set `MISARBLOG_API_KEY` in the MCP config env block, or
-- Run `misarblog_login` once to save it to `~/.misarblog/config.json`
+- Run `login` once to save it to `~/.misarblog/config.json`
 
 ### "API key invalid or expired"
 
 Your key was revoked. Go to **Dashboard → Settings → API Keys** and generate a new one,
-or run `misarblog_login` again to get a fresh key via the browser flow.
+or run `login` again to get a fresh key via the browser flow.
 
 ### "Rate limited (100 req/min)"
 
 You've exceeded the API rate limit. Wait 60 seconds and retry. If you're running automated
 pipelines, add a short delay between tool calls.
 
-### Browser doesn't open during `misarblog_login`
+### Browser doesn't open during `login`
 
 The server prints the URL to stderr when `webbrowser.open()` fails. Copy and open it manually:
 
@@ -508,9 +712,9 @@ Run `/mcp` in a Claude Code session to list active servers. If `misarblog` is mi
      | MISARBLOG_API_KEY=mbk_test python3 ~/.claude/scripts/misarblog-mcp.py
    ```
 
-   You should see a JSON response listing 12 tools.
+   You should see a JSON response listing 23 tools.
 
-### Connection refused on `misarblog_login` callback
+### Connection refused on `login` callback
 
 The local HTTP server binds to `127.0.0.1`. If your browser opens on a different machine
 (e.g. remote VS Code over SSH), the callback won't reach the MCP server. In that case,

package/dist/index.js

@@ -13,7 +13,7 @@ import { registerFollowTools } from "./tools/follows.js";
 import { registerNewsletterTools } from "./tools/newsletter.js";
 import { registerReactionTools } from "./tools/reactions.js";
 function buildServer() {
-    const s = new McpServer({ name: "misarblog", version: "1.0.5" });
+    const s = new McpServer({ name: "misarblog", version: "1.0.6" });
     registerLoginTool(s);
     registerStatusTool(s);
     registerProfileTools(s);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@misarblog/mcp",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "mcpName": "io.github.mrgulshanyadav/misarblog-mcp",
   "description": "MCP server for Misar.Blog — publish blog posts, manage drafts, generate AI cover images, and access analytics from Claude Code, Cursor & Windsurf.",
   "type": "module",

package/smithery.yaml

@@ -10,7 +10,7 @@ startCommand:
         title: API Key
         description: >
           Your Misar.Blog API key (starts with mbk_). Generate one at
-          https://www.misar.blog/dashboard/settings/api — or leave blank and
+          https://www.misar.blog/dashboard/settings/api-keys — or leave blank and
           run the "login" tool to authenticate via browser.
         x-secret: true
       baseUrl: