@misarblog/mcp 1.0.4 → 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,85 +361,224 @@ Claude will call the tool, open your browser, and confirm once you've authorized
 
 ## Tools reference
 
+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 |
 | ---- | ----------- | --------------- |
-| `misarblog_login` | Browser-based auth — saves key to `~/.misarblog/config.json` | — |
-| `misarblog_get_profile` | Username, display name, bio, subscriber count, Stripe status | — |
-| `misarblog_list_articles` | List your articles by status | — |
-| `misarblog_get_article` | Fetch a single article with full body | `slug` |
-| `misarblog_publish_article` | Publish now or schedule via ISO 8601 datetime | `title`, `body_markdown` |
-| `misarblog_create_draft` | Save a draft for review in the web editor | `title`, `body_markdown` |
-| `misarblog_upload_image` | Upload a local file to the Misar.Blog CDN | `file_path` |
-| `misarblog_generate_image` | Generate an AI cover image from a text prompt | `prompt` |
-| `misarblog_list_series` | List all article series on your account | — |
-| `misarblog_create_series` | Create a new series | `title` |
-| `misarblog_add_to_series` | Add an article to a series at a given position | `series_slug`, `article_slug` |
-| `misarblog_get_analytics` | Views, revenue, and subscriber trends (up to 365 days) | — |
+| `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
 
-#### `misarblog_login`
+#### `login`
 
 | Param | Type | Default | Description |
 | ----- | ---- | ------- | ----------- |
-| `port` | number | random 9001–9099 | Local callback port |
-| `base_url` | string | `https://www.misar.blog` | Override for self-hosted instances |
+| `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) |
 
-#### `misarblog_list_articles`
+#### `list_my_articles`
 
 | Param | Type | Default | Description |
 | ----- | ---- | ------- | ----------- |
-| `status` | string | `published` | One of: `draft` · `published` · `scheduled` · `archived` |
-| `limit` | number | `20` | Max results, 1–100 |
+| `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 |
 
-#### `misarblog_publish_article`
+#### `publish_article`
 
 | Param | Type | Required | Description |
 | ----- | ---- | -------- | ----------- |
 | `title` | string | yes | Article title (max 250 chars) |
-| `body_markdown` | string | yes | Full article content in Markdown |
+| `body_markdown` | string | yes | Full article body in Markdown |
 | `tags` | string[] | no | Up to 10 tags |
-| `cover_image_url` | string | no | HTTPS URL of cover image |
-| `schedule_at` | string | no | ISO 8601 datetime to publish later (e.g. `2025-06-01T09:00:00Z`) |
+| `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`) |
 
-#### `misarblog_create_draft`
+#### `create_draft`
 
 | Param | Type | Required | Description |
 | ----- | ---- | -------- | ----------- |
 | `title` | string | yes | Draft title |
-| `body_markdown` | string | yes | Content in Markdown |
-| `tags` | string[] | no | Up to 10 tags |
+| `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 |
 
-#### `misarblog_upload_image`
+#### `suggest_titles`
 
 | Param | Type | Required | Description |
 | ----- | ---- | -------- | ----------- |
-| `file_path` | string | yes | Absolute local path (jpg, png, webp, gif, svg) |
+| `context` | string | yes | Your article content in plain text or markdown (20–8000 chars) |
 
-#### `misarblog_generate_image`
+#### `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 | — | Image description (max 1000 chars) |
-| `size` | string | `1024x1024` | `1024x1024` · `1792x1024` · `1024x1792` |
+| `prompt` | string | — | Description of the image to generate (max 1000 chars) |
+| `size` | string | `1792x1024` | `1024x1024` · `1792x1024` · `1024x1792` |
 
-#### `misarblog_create_series`
+#### `create_series`
 
 | Param | Type | Required | Description |
 | ----- | ---- | -------- | ----------- |
-| `title` | string | yes | Series name |
-| `description` | string | no | Short description |
+| `title` | string | yes | Series title |
+| `description` | string | no | Short description of the series |
 
-#### `misarblog_add_to_series`
+#### `add_to_series`
 
 | Param | Type | Required | Description |
 | ----- | ---- | -------- | ----------- |
-| `series_slug` | string | yes | URL slug of the series |
-| `article_slug` | string | yes | URL slug of the article |
+| `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 |
 
-#### `misarblog_get_analytics`
+#### `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 |
 | ----- | ---- | ------- | ----------- |
@@ -505,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
 {
@@ -524,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:
 
@@ -573,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.d.ts

@@ -1,3 +1,4 @@
 #!/usr/bin/env node
-export {};
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createSandboxServer(): McpServer;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA8BpE,wBAAgB,mBAAmB,cAElC"}

package/dist/index.js

@@ -6,21 +6,43 @@ import { registerImageTools } from "./tools/images.js";
 import { registerSeriesTools } from "./tools/series.js";
 import { registerProfileTools } from "./tools/profile.js";
 import { registerLoginTool } from "./tools/login.js";
-const server = new McpServer({
-    name: "misarblog",
-    version: "1.0.0",
-});
-registerLoginTool(server);
-registerProfileTools(server);
-registerArticleTools(server);
-registerImageTools(server);
-registerSeriesTools(server);
+import { registerStatusTool } from "./tools/status.js";
+import { registerAiTools } from "./tools/ai.js";
+import { registerCommentTools } from "./tools/comments.js";
+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.6" });
+    registerLoginTool(s);
+    registerStatusTool(s);
+    registerProfileTools(s);
+    registerArticleTools(s);
+    registerAiTools(s);
+    registerImageTools(s);
+    registerSeriesTools(s);
+    registerCommentTools(s);
+    registerFollowTools(s);
+    registerNewsletterTools(s);
+    registerReactionTools(s);
+    return s;
+}
+export function createSandboxServer() {
+    return buildServer();
+}
 async function main() {
+    const server = buildServer();
     const transport = new StdioServerTransport();
     await server.connect(transport);
 }
-main().catch((err) => {
-    console.error("MCP server error:", err);
-    process.exit(1);
-});
+// Auto-start when run directly (argv[1] ends with our known binary names).
+// Smithery scanner imports this module without a matching argv[1], so main() won't fire.
+const argv1 = process.argv[1] ?? "";
+const isDirectRun = argv1.endsWith("index.ts") || argv1.endsWith("index.js") || argv1.endsWith("misarblog-mcp");
+if (isDirectRun) {
+    main().catch((err) => {
+        console.error("MCP server error:", err);
+        process.exit(1);
+    });
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC3B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAE5B,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;IACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,SAAS,WAAW;IAClB,MAAM,CAAC,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACjE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IACrB,kBAAkB,CAAC,CAAC,CAAC,CAAC;IACtB,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACxB,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACxB,eAAe,CAAC,CAAC,CAAC,CAAC;IACnB,kBAAkB,CAAC,CAAC,CAAC,CAAC;IACtB,mBAAmB,CAAC,CAAC,CAAC,CAAC;IACvB,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACxB,mBAAmB,CAAC,CAAC,CAAC,CAAC;IACvB,uBAAuB,CAAC,CAAC,CAAC,CAAC;IAC3B,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACzB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,WAAW,EAAE,CAAC;AACvB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;IAC7B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,2EAA2E;AAC3E,yFAAyF;AACzF,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACpC,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AAChH,IAAI,WAAW,EAAE,CAAC;IAChB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACnB,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/auth.js

@@ -39,6 +39,6 @@ export function getBaseUrl() {
     const cfg = loadConfig();
     if (cfg.base_url)
         return cfg.base_url.replace(/\/$/, "") + "/api/v1";
-    return "https://www.misar.blog/api/v1";
+    return "https://api.misar.io/blog/v1";
 }
 //# sourceMappingURL=auth.js.map

package/dist/lib/auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/lib/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;AAQjE,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAgB,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAmB;IAC5C,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,UAAU,EAAE,CAAC;IAC9B,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC;IACrD,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,IAAI,GAAG,CAAC,OAAO;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAEpC,MAAM,IAAI,KAAK,CACb,sFAAsF,CACvF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,IAAI,CAAC;QACH,OAAO,SAAS,EAAE,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7D,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC;IAEzD,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,IAAI,GAAG,CAAC,QAAQ;QAAE,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC;IAErE,OAAO,+BAA+B,CAAC;AACzC,CAAC"}
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/lib/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;AAQjE,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAgB,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAmB;IAC5C,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,UAAU,EAAE,CAAC;IAC9B,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC;IACrD,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,IAAI,GAAG,CAAC,OAAO;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAEpC,MAAM,IAAI,KAAK,CACb,sFAAsF,CACvF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,IAAI,CAAC;QACH,OAAO,SAAS,EAAE,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7D,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC;IAEzD,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,IAAI,GAAG,CAAC,QAAQ;QAAE,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC;IAErE,OAAO,8BAA8B,CAAC;AACxC,CAAC"}

package/dist/tools/ai.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAiTools(server: McpServer): void;
+//# sourceMappingURL=ai.d.ts.map

package/dist/tools/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/tools/ai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAyBpE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,QA6GhD"}

package/dist/tools/ai.js

@@ -0,0 +1,104 @@
+import { z } from "zod";
+import { apiFetch } from "../lib/api-client.js";
+import { formatError } from "../lib/errors.js";
+function formatTitles(titles) {
+    if (titles.length === 0)
+        return "No titles were generated.";
+    return titles
+        .map((t, i) => {
+        const hint = t.hint ? `\n   → ${t.hint}` : "";
+        return `${i + 1}. ${t.title}${hint}`;
+    })
+        .join("\n\n");
+}
+export function registerAiTools(server) {
+    server.tool("research_topic", "Research a topic and get AI-generated insights, sources, and a content outline. Useful before writing an article.", {
+        query: z
+            .string()
+            .min(5)
+            .max(500)
+            .describe("Research topic or question. Be specific for best results."),
+    }, async ({ query }) => {
+        try {
+            const data = await apiFetch("/ai/research", {
+                method: "POST",
+                body: JSON.stringify({ query }),
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: data.result ?? JSON.stringify(data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${formatError(err)}` }], isError: true };
+        }
+    });
+    server.tool("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.", {
+        prompt: z
+            .string()
+            .min(3)
+            .max(500)
+            .describe("Your article topic or target keywords. Be specific — include your niche, audience, and any long-tail phrases you want to rank for. Example: 'best AI writing tools for beginner bloggers 2025'"),
+        context: z
+            .string()
+            .max(8000)
+            .optional()
+            .describe("Optional: existing article content (plain text or markdown). Providing it lets the AI align titles with your actual content."),
+    }, async ({ prompt, context }) => {
+        try {
+            const data = await apiFetch("/ai/titles", {
+                method: "POST",
+                body: JSON.stringify({ action: "seo", prompt, context }),
+            });
+            const formatted = formatTitles(data.titles);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `## SEO/AEO/GEO Title Suggestions\n\nOptimized for: Google · AI answer engines (AEO) · Google AI Overviews (GEO) · AI search experiences (ASX)\nKeyword strategy: high-volume, low-competition long-tail phrases\n\n${formatted}\n\n---\n*Click any title to use it. Each title targets a distinct keyword angle and search intent.*`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${formatError(err)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool("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.", {
+        context: z
+            .string()
+            .min(20)
+            .max(8000)
+            .describe("Your article content in plain text or markdown"),
+    }, async ({ context }) => {
+        try {
+            const data = await apiFetch("/ai/titles", {
+                method: "POST",
+                body: JSON.stringify({ action: "suggest", context }),
+            });
+            const formatted = formatTitles(data.titles);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `## Title Suggestions\n\n${formatted}\n\n---\n*Titles generated from your article content.*`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${formatError(err)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=ai.js.map

package/dist/tools/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../../src/tools/ai.ts"],"names":[],"mappings":"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"}

package/dist/tools/comments.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerCommentTools(server: McpServer): void;
+//# sourceMappingURL=comments.d.ts.map

package/dist/tools/comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../src/tools/comments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyB5D"}

package/dist/tools/comments.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import { formatError } from "../lib/errors.js";
+const SITE_URL = (process.env.MISARBLOG_SITE_URL ?? "https://www.misar.blog").replace(/\/$/, "");
+export function registerCommentTools(server) {
+    server.tool("list_comments", "Get public comments for an article. Rate-limited by IP — no API key required.", {
+        article_id: z.string().uuid().describe("UUID of the article to fetch comments for"),
+        limit: z.number().int().min(1).max(100).optional().default(20),
+        offset: z.number().int().min(0).optional().default(0),
+    }, async ({ article_id, limit, offset }) => {
+        try {
+            const qs = new URLSearchParams({ article_id, limit: String(limit), offset: String(offset) });
+            const res = await fetch(`${SITE_URL}/api/comments?${qs}`, {
+                headers: { Accept: "application/json" },
+            });
+            const data = await res.json().catch(() => ({}));
+            if (!res.ok) {
+                return { content: [{ type: "text", text: `Error ${res.status}: ${JSON.stringify(data)}` }], isError: true };
+            }
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: formatError(e) }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=comments.js.map

package/dist/tools/comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.js","sourceRoot":"","sources":["../../src/tools/comments.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,wBAAwB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAEjG,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,IAAI,CACT,eAAe,EACf,+EAA+E,EAC/E;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;QACnF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;KACtD,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,IAAI,eAAe,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC7F,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,iBAAiB,EAAE,EAAE,EAAE;gBACxD,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;aACxC,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAChD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,SAAS,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACvH,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACvF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACvF,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/follows.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerFollowTools(server: McpServer): void;
+//# sourceMappingURL=follows.d.ts.map

package/dist/tools/follows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"follows.d.ts","sourceRoot":"","sources":["../../src/tools/follows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoB3D"}

package/dist/tools/follows.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import { formatError } from "../lib/errors.js";
+const SITE_URL = (process.env.MISARBLOG_SITE_URL ?? "https://www.misar.blog").replace(/\/$/, "");
+export function registerFollowTools(server) {
+    server.tool("get_follow_status", "Get public follow status and follower count for a user by their profile UUID. No API key required.", { user_id: z.string().uuid().describe("UUID of the profile to check follow status for") }, async ({ user_id }) => {
+        try {
+            const res = await fetch(`${SITE_URL}/api/follows?user_id=${encodeURIComponent(user_id)}`, {
+                headers: { Accept: "application/json" },
+            });
+            const data = await res.json().catch(() => ({}));
+            if (!res.ok) {
+                return { content: [{ type: "text", text: `Error ${res.status}: ${JSON.stringify(data)}` }], isError: true };
+            }
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: formatError(e) }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=follows.js.map

package/dist/tools/follows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"follows.js","sourceRoot":"","sources":["../../src/tools/follows.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,wBAAwB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAEjG,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,oGAAoG,EACpG,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC,EAAE,EACzF,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,wBAAwB,kBAAkB,CAAC,OAAO,CAAC,EAAE,EAAE;gBACxF,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;aACxC,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAChD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,SAAS,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACvH,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACvF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACvF,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/login.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/tools/login.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsBpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,QAgFlD"}
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/tools/login.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0BpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,QAmGlD"}

package/dist/tools/login.js

@@ -1,7 +1,8 @@
 import { z } from "zod";
 import { createServer } from "http";
 import { execFileSync } from "child_process";
-import { saveConfig, getBaseUrl } from "../lib/auth.js";
+import { saveConfig, getBaseUrl, tryGetApiKey } from "../lib/auth.js";
+import { apiFetch } from "../lib/api-client.js";
 // Opens URL in the system browser — uses execFileSync with separate args (no shell, no injection)
 function openBrowser(url) {
     try {
@@ -25,7 +26,26 @@ export function registerLoginTool(server) {
     server.tool("login", "Authenticate with your Misar.Blog account via browser — no API key copy-paste needed. Opens your browser to the settings page where you click 'Authorize MCP Access'. Your API key is saved to ~/.misarblog/config.json.", {
         port: z.number().int().min(9001).max(9099).optional().describe("Local callback port (9001–9099). Random by default."),
         base_url: z.string().url().optional().describe("Misar.Blog base URL for self-hosted instances."),
-    }, async ({ port: preferredPort, base_url }) => {
+        force: z.boolean().optional().describe("Force re-authentication even if already logged in (rotates your API key)."),
+    }, async ({ port: preferredPort, base_url, force }) => {
+        // Guard: if already authenticated and key is valid, skip the login flow
+        if (!force) {
+            const existingKey = tryGetApiKey();
+            if (existingKey) {
+                try {
+                    const profile = await apiFetch("/me");
+                    return {
+                        content: [{
+                                type: "text",
+                                text: `Already authenticated as @${profile.username}. Use \`status\` to verify, or call \`login\` with force=true to rotate your API key.`,
+                            }],
+                    };
+                }
+                catch {
+                    // Key exists but rejected — fall through to re-auth
+                }
+            }
+        }
         const _port = pickPort(preferredPort);
         const _baseUrl = (base_url ?? getBaseUrl().replace(/\/api\/v1$/, "")).replace(/\/$/, "");
         const _settingsUrl = `${_baseUrl}/dashboard/settings/api?mcp_port=${_port}`;

package/dist/tools/login.js.map

@@ -1 +1 @@
-{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/tools/login.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/tools/login.ts"],"names":[],"mappings":"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"}

package/dist/tools/newsletter.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerNewsletterTools(server: McpServer): void;
+//# sourceMappingURL=newsletter.d.ts.map

package/dist/tools/newsletter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"newsletter.d.ts","sourceRoot":"","sources":["../../src/tools/newsletter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgC/D"}

package/dist/tools/newsletter.js

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import { apiFetch } from "../lib/api-client.js";
+import { formatError } from "../lib/errors.js";
+export function registerNewsletterTools(server) {
+    server.tool("list_newsletter_subscribers", "Get your newsletter subscriber list. Requires API key authentication.", {
+        limit: z.number().int().min(1).max(100).optional().default(20),
+        offset: z.number().int().min(0).optional().default(0),
+    }, async ({ limit, offset }) => {
+        try {
+            const qs = new URLSearchParams({ limit: String(limit), offset: String(offset) });
+            const data = await apiFetch(`/newsletter/subscribers?${qs}`);
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: formatError(e) }], isError: true };
+        }
+    });
+    server.tool("list_newsletter_issues", "Get your sent and scheduled newsletter issues. Requires API key authentication.", { limit: z.number().int().min(1).max(50).optional().default(10) }, async ({ limit }) => {
+        try {
+            const data = await apiFetch(`/newsletter/issues?limit=${limit}`);
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: formatError(e) }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=newsletter.js.map

package/dist/tools/newsletter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"newsletter.js","sourceRoot":"","sources":["../../src/tools/newsletter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,IAAI,CACT,6BAA6B,EAC7B,uEAAuE,EACvE;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;KACtD,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,IAAI,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACjF,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAU,2BAA2B,EAAE,EAAE,CAAC,CAAC;YACtE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACvF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACvF,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,iFAAiF,EACjF,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,EACjE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAClB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAU,4BAA4B,KAAK,EAAE,CAAC,CAAC;YAC1E,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACvF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACvF,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/reactions.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerReactionTools(server: McpServer): void;
+//# sourceMappingURL=reactions.d.ts.map

package/dist/tools/reactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactions.d.ts","sourceRoot":"","sources":["../../src/tools/reactions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsD7D"}

package/dist/tools/reactions.js

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import { apiFetch } from "../lib/api-client.js";
+import { formatError } from "../lib/errors.js";
+const REACTION_TYPES = ["like", "clap", "bookmark"];
+export function registerReactionTools(server) {
+    server.tool("get_reactions", "Get reaction counts and your reactions for an article. Requires API key.", {
+        article_id: z.string().uuid().describe("UUID of the article"),
+    }, async ({ article_id }) => {
+        try {
+            const data = await apiFetch(`/reactions?article_id=${encodeURIComponent(article_id)}`);
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: formatError(e) }], isError: true };
+        }
+    });
+    server.tool("add_reaction", "Add a reaction to an article. No-ops if already reacted. Requires API key.", {
+        article_id: z.string().uuid().describe("UUID of the article"),
+        type: z.enum(REACTION_TYPES).describe("Reaction type: like, clap, or bookmark"),
+    }, async ({ article_id, type }) => {
+        try {
+            const data = await apiFetch("/reactions", {
+                method: "POST",
+                body: JSON.stringify({ article_id, type }),
+            });
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: formatError(e) }], isError: true };
+        }
+    });
+    server.tool("remove_reaction", "Remove a specific reaction from an article. Requires API key.", {
+        article_id: z.string().uuid().describe("UUID of the article"),
+        type: z.enum(REACTION_TYPES).describe("Reaction type to remove: like, clap, or bookmark"),
+    }, async ({ article_id, type }) => {
+        try {
+            const qs = new URLSearchParams({ article_id, type });
+            const data = await apiFetch(`/reactions?${qs}`, { method: "DELETE" });
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: formatError(e) }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=reactions.js.map

package/dist/tools/reactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactions.js","sourceRoot":"","sources":["../../src/tools/reactions.ts"],"names":[],"mappings":"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"}

package/dist/tools/status.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerStatusTool(server: McpServer): void;
+//# sourceMappingURL=status.d.ts.map

package/dist/tools/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASpE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,QAkCnD"}

package/dist/tools/status.js

@@ -0,0 +1,35 @@
+import { tryGetApiKey } from "../lib/auth.js";
+import { apiFetch } from "../lib/api-client.js";
+import { formatError } from "../lib/errors.js";
+export function registerStatusTool(server) {
+    server.tool("status", "Check whether you are authenticated with Misar.Blog and which account is connected. Run this first to verify your connection.", {}, async () => {
+        const key = tryGetApiKey();
+        if (!key) {
+            return {
+                content: [{
+                        type: "text",
+                        text: "Not authenticated. Run the `login` tool to connect your Misar.Blog account.",
+                    }],
+            };
+        }
+        try {
+            const profile = await apiFetch("/me");
+            return {
+                content: [{
+                        type: "text",
+                        text: `Authenticated as @${profile.username}. Your API key is active and working.`,
+                    }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `API key found but rejected by server: ${formatError(err)}. Run \`login\` to re-authenticate.`,
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/tools/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAM/C,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,CAAC,IAAI,CACT,QAAQ,EACR,+HAA+H,EAC/H,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC;QAC3B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,6EAA6E;qBACpF,CAAC;aACH,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAkB,KAAK,CAAC,CAAC;YACvD,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,qBAAqB,OAAO,CAAC,QAAQ,uCAAuC;qBACnF,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,yCAAyC,WAAW,CAAC,GAAG,CAAC,qCAAqC;qBACrG,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@misarblog/mcp",
-  "version": "1.0.4",
+  "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",
@@ -55,7 +55,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://git.misar.io/misaradmin/MisarBlog"
+    "url": "https://git.misar.io/misaradmin/misar-io"
   },
   "homepage": "https://www.misar.blog"
-}
+}

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: