@misarblog/mcp 1.0.0

package/README.md

@@ -0,0 +1,590 @@
+# Misar.Blog MCP Server
+
+Connect Claude Code, Cursor, Windsurf, or any MCP-compatible AI assistant to your
+[Misar.Blog](https://www.misar.blog) account. Publish articles, manage drafts, generate
+cover images, and pull analytics — all from your AI coding environment.
+
+Two runtimes are available — choose based on what you already have installed:
+
+| Runtime | Requires | Best for |
+| ------- | -------- | -------- |
+| **Python** (recommended) | Python 3.11+ · stdlib only | Claude Code, any lightweight setup |
+| **npm / npx** | Node.js 18+ | Node-first workflows, CI/CD |
+
+---
+
+## Contents
+
+- [Quick Start](#quick-start)
+- [Option A — Python](#option-a--python-no-dependencies)
+- [Option B — npm / npx](#option-b--npm--npx)
+- [Client Setup](#client-setup)
+  - [Claude Code](#claude-code)
+  - [Cursor](#cursor)
+  - [Windsurf](#windsurf)
+  - [VS Code (Copilot)](#vs-code-copilot)
+  - [Any other MCP client](#any-other-mcp-client)
+- [Authentication](#authentication)
+  - [API Key (recommended)](#api-key-recommended)
+  - [Browser login (no copy-paste)](#browser-login-no-copy-paste)
+- [Tools reference](#tools-reference)
+- [Usage examples](#usage-examples)
+- [Self-hosted Misar.Blog](#self-hosted-misarblog)
+- [Troubleshooting](#troubleshooting)
+
+---
+
+## Quick Start
+
+**Fastest path — Python + Claude Code:**
+
+```bash
+# 1. Copy the server script
+cp packages/mcp/misarblog-mcp.py ~/.claude/scripts/misarblog-mcp.py
+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
+```
+
+**Fastest path — npx + any MCP client:**
+
+```bash
+# No install needed — just add the config below and run misarblog_login
+```
+
+---
+
+## Option A — Python (no dependencies)
+
+Uses Python's standard library only. No `pip install` required. Works on macOS, Linux, and Windows (with Python 3.11+).
+
+### 1 · Download the script
+
+**If you cloned the MisarBlog repo:**
+
+```bash
+cp packages/mcp/misarblog-mcp.py ~/.claude/scripts/misarblog-mcp.py
+chmod +x ~/.claude/scripts/misarblog-mcp.py
+```
+
+**Direct download (one-liner):**
+
+```bash
+mkdir -p ~/.claude/scripts
+curl -fsSL https://www.misar.blog/mcp/misarblog-mcp.py -o ~/.claude/scripts/misarblog-mcp.py
+chmod +x ~/.claude/scripts/misarblog-mcp.py
+```
+
+### 2 · Verify Python version
+
+```bash
+python3 --version   # must be 3.11 or later
+```
+
+If you're on macOS with an older system Python, use Homebrew: `brew install python`.
+
+### 3 · Add to your MCP client config
+
+```json
+{
+  "mcpServers": {
+    "misarblog": {
+      "command": "python3",
+      "args": ["~/.claude/scripts/misarblog-mcp.py"],
+      "env": {
+        "MISARBLOG_API_KEY": "mbk_your_key_here"
+      }
+    }
+  }
+}
+```
+
+> You can omit `MISARBLOG_API_KEY` if you plan to use the `misarblog_login` browser flow.
+
+---
+
+## Option B — npm / npx
+
+Uses Node.js 18+ with the `@modelcontextprotocol/sdk`. `npx` fetches and caches the package on first run — no manual install needed.
+
+### Option B1 — Zero-install via npx (recommended)
+
+```json
+{
+  "mcpServers": {
+    "misarblog": {
+      "command": "npx",
+      "args": ["-y", "@misarblog/mcp"],
+      "env": {
+        "MISARBLOG_API_KEY": "mbk_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Option B2 — Global install
+
+```bash
+npm install -g @misarblog/mcp
+```
+
+Then use `misarblog-mcp` as the command:
+
+```json
+{
+  "mcpServers": {
+    "misarblog": {
+      "command": "misarblog-mcp",
+      "env": {
+        "MISARBLOG_API_KEY": "mbk_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Option B3 — pnpm / yarn
+
+```bash
+pnpm add -g @misarblog/mcp
+# or
+yarn global add @misarblog/mcp
+```
+
+### Verify Node version
+
+```bash
+node --version   # must be v18 or later
+```
+
+---
+
+## Client Setup
+
+### Claude Code
+
+Claude Code stores MCP server config in `~/.claude/settings.json`.
+
+**Edit the file:**
+
+```bash
+# Open in your editor
+code ~/.claude/settings.json
+```
+
+**Add the `mcpServers` block** (create `settings.json` if it doesn't exist):
+
+```json
+{
+  "mcpServers": {
+    "misarblog": {
+      "command": "python3",
+      "args": ["~/.claude/scripts/misarblog-mcp.py"],
+      "env": {
+        "MISARBLOG_API_KEY": "mbk_your_key_here"
+      }
+    }
+  }
+}
+```
+
+**Reload Claude Code** — MCP servers start automatically on the next session. You'll see
+`misarblog` listed when you run `/mcp` in any Claude Code session.
+
+**Verify the connection:**
+
+```text
+> call misarblog_get_profile
+```
+
+Claude Code should return your username, display name, and account status.
+
+---
+
+### Cursor
+
+Cursor stores MCP config at `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` inside a
+project (project-scoped, takes priority).
+
+**Global config** (`~/.cursor/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "misarblog": {
+      "command": "npx",
+      "args": ["-y", "@misarblog/mcp"],
+      "env": {
+        "MISARBLOG_API_KEY": "mbk_your_key_here"
+      }
+    }
+  }
+}
+```
+
+**Alternative — via Cursor Settings UI:**
+
+1. Open Cursor → **Settings** → **MCP**
+2. Click **+ Add new MCP server**
+3. Fill in:
+   - **Name**: `misarblog`
+   - **Command**: `npx`
+   - **Args**: `-y @misarblog/mcp`
+   - **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.
+
+---
+
+### Windsurf
+
+Windsurf reads MCP config from `~/.codeium/windsurf/mcp_config.json`.
+
+```json
+{
+  "mcpServers": {
+    "misarblog": {
+      "command": "npx",
+      "args": ["-y", "@misarblog/mcp"],
+      "env": {
+        "MISARBLOG_API_KEY": "mbk_your_key_here"
+      }
+    }
+  }
+}
+```
+
+Reload Windsurf after saving. The MCP tools appear under the **Cascade** panel → **Tools**.
+
+---
+
+### VS Code (Copilot)
+
+VS Code reads MCP config from `.vscode/mcp.json` in the workspace root, or from
+**User Settings** (`settings.json`) under `"mcp"`.
+
+**Workspace config** (`.vscode/mcp.json`):
+
+```json
+{
+  "servers": {
+    "misarblog": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@misarblog/mcp"],
+      "env": {
+        "MISARBLOG_API_KEY": "mbk_your_key_here"
+      }
+    }
+  }
+}
+```
+
+**User settings** (`settings.json`):
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "misarblog": {
+        "type": "stdio",
+        "command": "npx",
+        "args": ["-y", "@misarblog/mcp"],
+        "env": {
+          "MISARBLOG_API_KEY": "mbk_your_key_here"
+        }
+      }
+    }
+  }
+}
+```
+
+Restart VS Code after saving. The `misarblog_*` tools appear in GitHub Copilot Chat when
+you enable **Agent mode** (the `@` icon in the chat panel).
+
+---
+
+### Any other MCP client
+
+Any MCP-compatible client that supports stdio servers works with the same pattern:
+
+- **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)
+
+---
+
+## Authentication
+
+### API Key (recommended)
+
+1. Go to **Misar.Blog → Dashboard → Settings → API Keys**
+2. Click **Generate API Key** — your key starts with `mbk_`
+3. Copy it and paste into the `MISARBLOG_API_KEY` env var in your MCP config
+
+Keys have a 100 req/min rate limit. You can revoke and regenerate at any time from the settings page.
+
+**Precedence order:**
+
+```text
+MISARBLOG_API_KEY env var  →  ~/.misarblog/config.json  →  prompt to run misarblog_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:
+
+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>`
+3. You click **Authorize MCP Access** — you must be logged in to Misar.Blog
+4. The page sends your API key directly to the local listener
+5. The key is saved to `~/.misarblog/config.json` — no clipboard involved
+6. All subsequent tool calls use this saved key automatically
+
+The listener accepts connections from `127.0.0.1` only and shuts down after 120 seconds.
+
+**Example prompt:**
+
+```text
+Connect my Misar.Blog account using misarblog_login
+```
+
+Claude will call the tool, open your browser, and confirm once you've authorized.
+
+---
+
+## Tools reference
+
+| 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) | — |
+
+### Tool parameters
+
+#### `misarblog_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 |
+
+#### `misarblog_list_articles`
+
+| Param | Type | Default | Description |
+| ----- | ---- | ------- | ----------- |
+| `status` | string | `published` | One of: `draft` · `published` · `scheduled` · `archived` |
+| `limit` | number | `20` | Max results, 1–100 |
+
+#### `misarblog_publish_article`
+
+| Param | Type | Required | Description |
+| ----- | ---- | -------- | ----------- |
+| `title` | string | yes | Article title (max 250 chars) |
+| `body_markdown` | string | yes | Full article content 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`) |
+| `visibility` | string | no | `public` · `subscribers` · `paid` · `private` (default: `public`) |
+
+#### `misarblog_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 |
+
+#### `misarblog_upload_image`
+
+| Param | Type | Required | Description |
+| ----- | ---- | -------- | ----------- |
+| `file_path` | string | yes | Absolute local path (jpg, png, webp, gif, svg) |
+
+#### `misarblog_generate_image`
+
+| Param | Type | Default | Description |
+| ----- | ---- | ------- | ----------- |
+| `prompt` | string | — | Image description (max 1000 chars) |
+| `size` | string | `1024x1024` | `1024x1024` · `1792x1024` · `1024x1792` |
+
+#### `misarblog_create_series`
+
+| Param | Type | Required | Description |
+| ----- | ---- | -------- | ----------- |
+| `title` | string | yes | Series name |
+| `description` | string | no | Short description |
+
+#### `misarblog_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 |
+| `position` | number | no | 1-indexed position; appends to end if omitted |
+
+#### `misarblog_get_analytics`
+
+| Param | Type | Default | Description |
+| ----- | ---- | ------- | ----------- |
+| `days` | number | `30` | Look-back window, 1–365 |
+
+---
+
+## Usage examples
+
+These are prompts you can send directly in Claude Code or Cursor Agent mode:
+
+**Publish a new article:**
+
+```text
+Write a 1000-word article about "Why AI-first blogging changes SEO forever"
+and publish it on my Misar.Blog with tags ["AI", "SEO", "blogging"].
+```
+
+**Draft with a generated cover image:**
+
+```text
+Generate a dark, futuristic cover image for an article titled "Building with MCP".
+Then create a draft with that image as the cover.
+```
+
+**Check performance:**
+
+```text
+Show me my analytics for the last 90 days.
+```
+
+**Publish on a schedule:**
+
+```text
+Write a short announcement post and schedule it to publish tomorrow at 9am UTC.
+```
+
+**Organize a series:**
+
+```text
+List my articles with status "published", then create a series called "AI Writing Guide"
+and add the last 3 articles to it in chronological order.
+```
+
+---
+
+## Self-hosted Misar.Blog
+
+If you run your own Misar.Blog instance, set `MISARBLOG_BASE_URL` to your domain:
+
+```json
+{
+  "mcpServers": {
+    "misarblog": {
+      "command": "python3",
+      "args": ["~/.claude/scripts/misarblog-mcp.py"],
+      "env": {
+        "MISARBLOG_API_KEY": "mbk_your_key_here",
+        "MISARBLOG_BASE_URL": "https://blog.yourdomain.com"
+      }
+    }
+  }
+}
+```
+
+`MISARBLOG_BASE_URL` can also be stored in `~/.misarblog/config.json` (written by `misarblog_login`):
+
+```json
+{
+  "api_key": "mbk_...",
+  "username": "yourname",
+  "base_url": "https://blog.yourdomain.com"
+}
+```
+
+---
+
+## Troubleshooting
+
+### "Not configured" on every tool call
+
+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`
+
+### "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.
+
+### "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`
+
+The server prints the URL to stderr when `webbrowser.open()` fails. Copy and open it manually:
+
+```text
+Open this URL in your browser:
+  https://www.misar.blog/dashboard/settings/api?mcp_port=9042
+```
+
+You have 120 seconds from when the tool runs to click **Authorize MCP Access**.
+
+### `python3: command not found`
+
+- macOS: `brew install python` or install from [python.org](https://www.python.org)
+- Linux: `sudo apt install python3` / `sudo dnf install python3`
+- Windows: Install from [python.org](https://www.python.org) and ensure `python3` is in `PATH`
+
+Alternatively, switch to the [npm/npx option](#option-b--npm--npx) — it only requires Node.js.
+
+### `npx` is slow on first run
+
+`npx -y @misarblog/mcp` downloads the package on first run and caches it locally. Subsequent
+starts are instant. If startup time matters, use `npm install -g @misarblog/mcp` instead.
+
+### MCP server doesn't appear in Claude Code
+
+Run `/mcp` in a Claude Code session to list active servers. If `misarblog` is missing:
+
+1. Check `~/.claude/settings.json` — ensure the `mcpServers.misarblog` block is valid JSON
+2. Verify the script path: `ls -la ~/.claude/scripts/misarblog-mcp.py`
+3. Test the server directly:
+
+   ```bash
+   printf '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}\n' \
+     | MISARBLOG_API_KEY=mbk_test python3 ~/.claude/scripts/misarblog-mcp.py
+   ```
+
+   You should see a JSON response listing 12 tools.
+
+### Connection refused on `misarblog_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,
+use the [API Key method](#api-key-recommended) instead.
+
+---
+
+## Requirements
+
+- **Python runtime**: Python 3.11+ · no external packages
+- **npm runtime**: Node.js 18+ · package fetched automatically via npx
+- **Account**: Misar.Blog creator account ([sign up free](https://www.misar.blog))

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerArticleTools } from "./tools/articles.js";
+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);
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("MCP server error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/lib/api-client.d.ts

@@ -0,0 +1,3 @@
+export declare function apiFetch<T>(path: string, options?: RequestInit): Promise<T>;
+export declare function apiUpload<T>(path: string, form: FormData): Promise<T>;
+//# sourceMappingURL=api-client.d.ts.map

package/dist/lib/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/lib/api-client.ts"],"names":[],"mappings":"AAGA,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,CAAC,CAAC,CAeZ;AAED,wBAAsB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAc3E"}

package/dist/lib/api-client.js

@@ -0,0 +1,34 @@
+import { getApiKey, getBaseUrl } from "./auth.js";
+import { apiError } from "./errors.js";
+export async function apiFetch(path, options = {}) {
+    const key = getApiKey();
+    const res = await fetch(`${getBaseUrl()}${path}`, {
+        ...options,
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${key}`,
+            "X-MCP-Source": "mcp_claude",
+            ...options.headers,
+        },
+    });
+    const body = await res.json().catch(() => ({}));
+    if (!res.ok)
+        throw apiError(res.status, body);
+    return body;
+}
+export async function apiUpload(path, form) {
+    const key = getApiKey();
+    const res = await fetch(`${getBaseUrl()}${path}`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${key}`,
+            "X-MCP-Source": "mcp_claude",
+        },
+        body: form,
+    });
+    const body = await res.json().catch(() => ({}));
+    if (!res.ok)
+        throw apiError(res.status, body);
+    return body;
+}
+//# sourceMappingURL=api-client.js.map

package/dist/lib/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../src/lib/api-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAY,EACZ,UAAuB,EAAE;IAEzB,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,UAAU,EAAE,GAAG,IAAI,EAAE,EAAE;QAChD,GAAG,OAAO;QACV,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,aAAa,EAAE,UAAU,GAAG,EAAE;YAC9B,cAAc,EAAE,YAAY;YAC5B,GAAG,OAAO,CAAC,OAAO;SACnB;KACF,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC9C,OAAO,IAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,IAAY,EAAE,IAAc;IAC7D,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,UAAU,EAAE,GAAG,IAAI,EAAE,EAAE;QAChD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,GAAG,EAAE;YAC9B,cAAc,EAAE,YAAY;SAC7B;QACD,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC9C,OAAO,IAAS,CAAC;AACnB,CAAC"}

package/dist/lib/auth.d.ts

@@ -0,0 +1,11 @@
+interface MisarConfig {
+    api_key?: string;
+    username?: string;
+    base_url?: string;
+}
+export declare function saveConfig(config: MisarConfig): void;
+export declare function getApiKey(): string;
+export declare function tryGetApiKey(): string | null;
+export declare function getBaseUrl(): string;
+export {};
+//# sourceMappingURL=auth.d.ts.map

package/dist/lib/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/lib/auth.ts"],"names":[],"mappings":"AAMA,UAAU,WAAW;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAUD,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAIpD;AAED,wBAAgB,SAAS,IAAI,MAAM,CAUlC;AAED,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAM5C;AAED,wBAAgB,UAAU,IAAI,MAAM,CAQnC"}

package/dist/lib/auth.js

@@ -0,0 +1,44 @@
+import { readFileSync, writeFileSync, mkdirSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+const CONFIG_PATH = join(homedir(), ".misarblog", "config.json");
+function loadConfig() {
+    try {
+        return JSON.parse(readFileSync(CONFIG_PATH, "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+export function saveConfig(config) {
+    mkdirSync(join(homedir(), ".misarblog"), { recursive: true });
+    const existing = loadConfig();
+    writeFileSync(CONFIG_PATH, JSON.stringify({ ...existing, ...config }, null, 2), "utf8");
+}
+export function getApiKey() {
+    const envKey = process.env.MISARBLOG_API_KEY?.trim();
+    if (envKey)
+        return envKey;
+    const cfg = loadConfig();
+    if (cfg.api_key)
+        return cfg.api_key;
+    throw new Error("Not configured. Run the login tool to connect via browser, or set MISARBLOG_API_KEY.");
+}
+export function tryGetApiKey() {
+    try {
+        return getApiKey();
+    }
+    catch {
+        return null;
+    }
+}
+export function getBaseUrl() {
+    const envUrl = (process.env.MISARBLOG_BASE_URL ?? "").trim();
+    if (envUrl)
+        return envUrl.replace(/\/$/, "") + "/api/v1";
+    const cfg = loadConfig();
+    if (cfg.base_url)
+        return cfg.base_url.replace(/\/$/, "") + "/api/v1";
+    return "https://www.misar.blog/api/v1";
+}
+//# sourceMappingURL=auth.js.map

package/dist/lib/auth.js.map

@@ -0,0 +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"}

package/dist/lib/errors.d.ts

@@ -0,0 +1,3 @@
+export declare function formatError(error: unknown): string;
+export declare function apiError(status: number, body: unknown): Error;
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIlD;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,KAAK,CAM7D"}

package/dist/lib/errors.js

@@ -0,0 +1,14 @@
+export function formatError(error) {
+    if (error instanceof Error)
+        return error.message;
+    if (typeof error === "string")
+        return error;
+    return "An unknown error occurred";
+}
+export function apiError(status, body) {
+    const msg = typeof body === "object" && body !== null && "error" in body
+        ? String(body.error)
+        : `HTTP ${status}`;
+    return new Error(msg);
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,2BAA2B,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,IAAa;IACpD,MAAM,GAAG,GACP,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,IAAI;QAC1D,CAAC,CAAC,MAAM,CAAE,IAA2B,CAAC,KAAK,CAAC;QAC5C,CAAC,CAAC,QAAQ,MAAM,EAAE,CAAC;IACvB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC"}

package/dist/tools/articles.d.ts

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

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

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

package/dist/tools/articles.js

@@ -0,0 +1,89 @@
+import { z } from "zod";
+import { apiFetch } from "../lib/api-client.js";
+import { formatError } from "../lib/errors.js";
+export function registerArticleTools(server) {
+    server.tool("list_my_articles", "List your articles on Misar.Blog", {
+        status: z
+            .enum(["draft", "published", "scheduled", "archived"])
+            .optional()
+            .describe("Filter by status (omit for all published)"),
+        limit: z.number().int().min(1).max(100).default(20).describe("Number of articles to return"),
+    }, async ({ status, limit }) => {
+        try {
+            const qs = new URLSearchParams({ limit: String(limit) });
+            if (status)
+                qs.set("status", status);
+            const data = await apiFetch(`/articles?${qs}`);
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${formatError(err)}` }], isError: true };
+        }
+    });
+    server.tool("get_article", "Get a single article by slug, including full markdown content", { slug: z.string().describe("The article slug") }, async ({ slug }) => {
+        try {
+            const article = await apiFetch(`/articles/${encodeURIComponent(slug)}`);
+            return { content: [{ type: "text", text: JSON.stringify(article, null, 2) }] };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${formatError(err)}` }], isError: true };
+        }
+    });
+    server.tool("publish_article", "Publish a new article (or schedule it) on Misar.Blog", {
+        title: z.string().min(1).max(250).describe("Article title"),
+        body_markdown: z.string().min(1).describe("Full article body in Markdown"),
+        tags: z.array(z.string()).max(10).optional().describe("Up to 10 tags"),
+        cover_image_url: z.string().url().optional().describe("URL of the cover image"),
+        schedule_at: z
+            .string()
+            .optional()
+            .describe("ISO 8601 timestamp to schedule. Omit to publish immediately."),
+        visibility: z
+            .enum(["public", "subscribers", "paid", "private"])
+            .default("public")
+            .describe("Who can read this article"),
+    }, async (args) => {
+        try {
+            const article = await apiFetch("/articles", {
+                method: "POST",
+                body: JSON.stringify(args),
+            });
+            const action = args.schedule_at ? "scheduled" : "published";
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Article ${action} successfully!\n\nURL: ${article.url}\nEditor: ${article.editor_url}\n\n${JSON.stringify(article, null, 2)}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${formatError(err)}` }], isError: true };
+        }
+    });
+    server.tool("create_draft", "Save an article as a draft on Misar.Blog (for review before publishing)", {
+        title: z.string().min(1).describe("Draft title"),
+        body_markdown: z.string().min(1).describe("Full article body in Markdown"),
+        tags: z.array(z.string()).optional().describe("Tags for the draft"),
+    }, async (args) => {
+        try {
+            const draft = await apiFetch("/drafts", {
+                method: "POST",
+                body: JSON.stringify(args),
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Draft saved!\n\nEditor: ${draft.editor_url}\n\n${JSON.stringify(draft, null, 2)}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${formatError(err)}` }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=articles.js.map

package/dist/tools/articles.js.map

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

package/dist/tools/images.d.ts

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

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

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

package/dist/tools/images.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { apiFetch, apiUpload } from "../lib/api-client.js";
+import { formatError } from "../lib/errors.js";
+import { readFile } from "fs/promises";
+export function registerImageTools(server) {
+    server.tool("upload_image", "Upload a local image file to the Misar.Blog CDN", {
+        file_path: z.string().describe("Absolute path to the image file (JPEG, PNG, WebP, or GIF)"),
+    }, async ({ file_path }) => {
+        try {
+            const { Blob } = await import("buffer");
+            const data = await readFile(file_path);
+            const ext = file_path.split(".").pop()?.toLowerCase() ?? "jpg";
+            const mimeMap = {
+                jpg: "image/jpeg",
+                jpeg: "image/jpeg",
+                png: "image/png",
+                webp: "image/webp",
+                gif: "image/gif",
+            };
+            const mime = mimeMap[ext] ?? "image/jpeg";
+            const blob = new Blob([data], { type: mime });
+            const form = new FormData();
+            form.append("file", blob, `upload.${ext}`);
+            const result = await apiUpload("/images/upload", form);
+            return { content: [{ type: "text", text: `Image uploaded!\n\nURL: ${result.url}` }] };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${formatError(err)}` }], isError: true };
+        }
+    });
+    server.tool("generate_cover_image", "Generate a cover image using AI and upload it to the Misar.Blog CDN", {
+        prompt: z.string().min(1).max(1000).describe("Description of the image to generate"),
+        size: z
+            .enum(["1024x1024", "1792x1024", "1024x1792"])
+            .default("1792x1024")
+            .describe("Image dimensions (default: landscape 1792x1024)"),
+    }, async ({ prompt, size }) => {
+        try {
+            const result = await apiFetch("/images/generate", {
+                method: "POST",
+                body: JSON.stringify({ prompt, size }),
+            });
+            return {
+                content: [
+                    { type: "text", text: `Cover image generated!\n\nURL: ${result.url}\n\nUse this as cover_image_url when publishing.` },
+                ],
+            };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${formatError(err)}` }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=images.js.map

package/dist/tools/images.js.map

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

package/dist/tools/login.d.ts

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

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

@@ -0,0 +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"}

package/dist/tools/login.js

@@ -0,0 +1,93 @@
+import { z } from "zod";
+import { createServer } from "http";
+import { execFileSync } from "child_process";
+import { saveConfig, getBaseUrl } from "../lib/auth.js";
+// Opens URL in the system browser — uses execFileSync with separate args (no shell, no injection)
+function openBrowser(url) {
+    try {
+        if (process.platform === "darwin")
+            execFileSync("open", [url], { stdio: "ignore" });
+        else if (process.platform === "win32")
+            execFileSync("cmd.exe", ["/c", "start", "", url], { stdio: "ignore" });
+        else
+            execFileSync("xdg-open", [url], { stdio: "ignore" });
+    }
+    catch {
+        process.stderr.write(`Open this URL in your browser:\n  ${url}\n`);
+    }
+}
+function pickPort(preferred) {
+    if (preferred && preferred >= 9001 && preferred <= 9099)
+        return preferred;
+    return 9001 + Math.floor(Math.random() * 99);
+}
+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 }) => {
+        const _port = pickPort(preferredPort);
+        const _baseUrl = (base_url ?? getBaseUrl().replace(/\/api\/v1$/, "")).replace(/\/$/, "");
+        const _settingsUrl = `${_baseUrl}/dashboard/settings/api?mcp_port=${_port}`;
+        return new Promise((resolve) => {
+            let _resolved = false;
+            const _srv = createServer((req, res) => {
+                // Only accept callbacks from loopback
+                const _remote = req.socket.remoteAddress ?? "";
+                if (_remote !== "127.0.0.1" && _remote !== "::1" && _remote !== "::ffff:127.0.0.1") {
+                    res.writeHead(403).end();
+                    return;
+                }
+                if (req.method !== "POST" || req.url !== "/token") {
+                    res.writeHead(404).end();
+                    return;
+                }
+                let _body = "";
+                req.on("data", (chunk) => { _body += chunk.toString(); });
+                req.on("end", () => {
+                    try {
+                        const _data = JSON.parse(_body);
+                        const _gotKey = (_data.api_key ?? "").trim();
+                        const _gotUser = (_data.username ?? "").trim();
+                        if (!_gotKey.startsWith("mbk_")) {
+                            res.writeHead(400).end(JSON.stringify({ error: "invalid key" }));
+                            return;
+                        }
+                        res.writeHead(200, { "Content-Type": "application/json" }).end(JSON.stringify({ ok: true }));
+                        saveConfig({ api_key: _gotKey, username: _gotUser, ...(base_url ? { base_url } : {}) });
+                        if (!_resolved) {
+                            _resolved = true;
+                            _srv.close();
+                            resolve({
+                                content: [{
+                                        type: "text",
+                                        text: `Connected as @${_gotUser}! API key saved to ~/.misarblog/config.json.\n\nYou can now use all Misar.Blog tools without setting MISARBLOG_API_KEY.`,
+                                    }],
+                            });
+                        }
+                    }
+                    catch {
+                        res.writeHead(400).end();
+                    }
+                });
+            });
+            _srv.listen(_port, "127.0.0.1", () => {
+                openBrowser(_settingsUrl);
+            });
+            // 120s timeout
+            setTimeout(() => {
+                if (!_resolved) {
+                    _resolved = true;
+                    _srv.close();
+                    resolve({
+                        content: [{
+                                type: "text",
+                                text: `Login timed out after 120 seconds. Open this URL manually and click 'Authorize MCP Access':\n\n${_settingsUrl}`,
+                            }],
+                    });
+                }
+            }, 120_000);
+        });
+    });
+}
+//# sourceMappingURL=login.js.map

package/dist/tools/login.js.map

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

package/dist/tools/profile.d.ts

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

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

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

package/dist/tools/profile.js

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import { apiFetch } from "../lib/api-client.js";
+import { formatError } from "../lib/errors.js";
+export function registerProfileTools(server) {
+    server.tool("get_profile", "Get your Misar.Blog creator profile", {}, async () => {
+        try {
+            const profile = await apiFetch("/me");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(profile, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${formatError(err)}` }], isError: true };
+        }
+    });
+    server.tool("get_analytics_summary", "Get analytics summary (views, revenue, subscribers) for a time period", { days: z.number().int().min(1).max(365).default(30).describe("Number of days to look back (default: 30, max: 365)") }, async ({ days }) => {
+        try {
+            const data = await apiFetch(`/analytics?days=${days}`);
+            const revenueUsd = (data.revenue_net_cents / 100).toFixed(2);
+            const summary = {
+                ...data,
+                revenue_usd: `$${revenueUsd}`,
+            };
+            return { content: [{ type: "text", text: JSON.stringify(summary, null, 2) }] };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${formatError(err)}` }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=profile.js.map

package/dist/tools/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../src/tools/profile.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;AAmB/C,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,qCAAqC,EAAE,EAAE,EAAE,KAAK,IAAI,EAAE;QAC/E,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAkB,KAAK,CAAC,CAAC;YACvD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;qBACvC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC5F,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,uEAAuE,EACvE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,qDAAqD,CAAC,EAAE,EACtH,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAoB,mBAAmB,IAAI,EAAE,CAAC,CAAC;YAC1E,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,iBAAiB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC7D,MAAM,OAAO,GAAG;gBACd,GAAG,IAAI;gBACP,WAAW,EAAE,IAAI,UAAU,EAAE;aAC9B,CAAC;YACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACjF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC5F,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/series.d.ts

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

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

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

package/dist/tools/series.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+import { apiFetch } from "../lib/api-client.js";
+import { formatError } from "../lib/errors.js";
+export function registerSeriesTools(server) {
+    server.tool("get_series", "List all your series on Misar.Blog", {}, async () => {
+        try {
+            const data = await apiFetch("/series");
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${formatError(err)}` }], isError: true };
+        }
+    });
+    server.tool("create_series", "Create a new series to group related articles", {
+        title: z.string().min(1).describe("Series title"),
+        description: z.string().optional().describe("Short description of the series"),
+    }, async ({ title, description }) => {
+        try {
+            const series = await apiFetch("/series", {
+                method: "POST",
+                body: JSON.stringify({ title, description }),
+            });
+            return {
+                content: [
+                    { type: "text", text: `Series created!\n\nURL: ${series.url}\nSlug: ${series.slug}\n\n${JSON.stringify(series, null, 2)}` },
+                ],
+            };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${formatError(err)}` }], isError: true };
+        }
+    });
+    server.tool("add_to_series", "Add an existing article to a series", {
+        series_slug: z.string().describe("The series slug"),
+        article_slug: z.string().describe("The article slug to add"),
+        position: z.number().int().min(1).optional().describe("Position in the series (optional, appends if omitted)"),
+    }, async ({ series_slug, article_slug, position }) => {
+        try {
+            const result = await apiFetch(`/series/${encodeURIComponent(series_slug)}/articles`, {
+                method: "POST",
+                body: JSON.stringify({ article_slug, position }),
+            });
+            return { content: [{ type: "text", text: `Article added to series successfully.` }] };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Error: ${formatError(err)}` }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=series.js.map

package/dist/tools/series.js.map

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

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@misarblog/mcp",
+  "version": "1.0.0",
+  "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",
+  "main": "./dist/index.js",
+  "bin": {
+    "misarblog-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "pnpm build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.10.2",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "blogging",
+    "blog",
+    "content-publishing",
+    "markdown",
+    "ai-writing",
+    "ai-content",
+    "draft-management",
+    "analytics",
+    "claude-code",
+    "cursor",
+    "windsurf",
+    "misarblog",
+    "publishing-platform",
+    "seo",
+    "aeo",
+    "writer-tools",
+    "editorial"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://git.misar.io/misaradmin/MisarBlog"
+  },
+  "homepage": "https://www.misar.blog"
+}