mcp-server-jotbird

An MCP server for JotBird that lets any LLM publish Markdown as beautifully formatted, shareable web pages.

Write a document in conversation, publish it with one tool call, and get back a live URL. Supports full Markdown — headings, code blocks, tables, footnotes, math, task lists, and more. Update or delete pages by slug.

Works with Claude, ChatGPT, Gemini, and any MCP-compatible client.

Quick start

1. Get an API key

Sign in at jotbird.com, open Account > API keys, and generate a key.

2. Add to your client

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "jotbird": {
      "command": "npx",
      "args": ["-y", "mcp-server-jotbird"],
      "env": {
        "JOTBIRD_API_KEY": "jb_your_key_here"
      }
    }
  }
}

claude mcp add jotbird -e JOTBIRD_API_KEY=jb_your_key_here -- npx -y mcp-server-jotbird

ChatGPT requires a remote (HTTP) MCP server — it doesn't support local stdio servers directly. You'll need to run a proxy that exposes the server over HTTP with a public tunnel:

JOTBIRD_API_KEY=jb_your_key_here npx mcp-proxy --shell --tunnel -- npx -y mcp-server-jotbird

This starts the server and prints a public tunnel URL (e.g. https://funny-eel-44.tunnel.gla.ma).

Then in ChatGPT:

1. Go to Settings > Apps > Advanced settings and enable Developer mode
2. Click New App, give it a name, and paste the tunnel URL with /mcp appended (e.g. https://funny-eel-44.tunnel.gla.ma/mcp)
3. Set authentication to No Auth and click Create
4. In a new chat, select Developer mode from the model picker and enable the app

See OpenAI's MCP docs for details.

Edit .gemini/settings.json (project-level) or ~/.gemini/settings.json (global):

{
  "mcpServers": {
    "jotbird": {
      "command": "npx",
      "args": ["-y", "mcp-server-jotbird"],
      "env": {
        "JOTBIRD_API_KEY": "$JOTBIRD_API_KEY"
      }
    }
  }
}

Or add via CLI:

gemini mcp add jotbird npx -e JOTBIRD_API_KEY=jb_your_key_here -- -y mcp-server-jotbird

See Gemini CLI MCP docs for details.

Any client that supports the Model Context Protocol over stdio can use this server. Set the JOTBIRD_API_KEY environment variable and run:

npx -y mcp-server-jotbird

3. Use it

Ask your LLM things like:

• "Write a blog post about X and publish it to JotBird"
• "Publish these meeting notes as a shareable page"
• "Update my published page 'my-notes' with this new section"
• "Show me all my published pages"
• "Take down the page with slug 'old-draft'"

Tools

publish

Publish Markdown content as a formatted web page with a shareable URL. To update an existing page, pass its slug.

| Parameter | Required | Description | |-----------|----------|-------------| | markdown | Yes | Markdown content (max 256 KB). Supports footnotes, task lists, definition lists, math ($…$ and $$…$$), and inline HTML. | | title | No | Page title. If omitted, the first H1 in the Markdown is used. | | slug | No | Slug of an existing page to update. Custom slugs cannot be created — omit this to publish a new page with an auto-generated slug. Use list_documents to find slugs. |

list_documents

List the user's published pages. Returns each page's title, URL, slug, and expiration date.

No parameters.

delete

Permanently delete a published page and its shareable URL. Cannot be undone.

| Parameter | Required | Description | |-----------|----------|-------------| | slug | Yes | Slug of the page to delete. Use list_documents to find slugs. |

Limits

| | Free | Pro | |--|------|-----| | Published pages | 10 | Unlimited | | Publishes per hour | 10 | 100 | | Page expiration | 90 days | Never | | Max markdown size | 256 KB | 256 KB |

Environment variables

| Variable | Required | Description | |----------|----------|-------------| | JOTBIRD_API_KEY | Yes | Your JotBird API key (jb_...) | | JOTBIRD_API_URL | No | API base URL (default: https://www.jotbird.com) |

Development

npm install
npm run build

Test locally:

JOTBIRD_API_KEY=jb_your_key node dist/index.js

License

MIT