# Mcp Server Jotbird

> JotBird MCP server — publish, list, and delete Markdown documents as shareable web pages from any AI assistant.

- **Type:** MCP server
- **Install:** `agentstack add mcp-jotbirdhq-mcp-server-jotbird`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [jotbirdhq](https://agentstack.voostack.com/s/jotbirdhq)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [jotbirdhq](https://github.com/jotbirdhq)
- **Source:** https://github.com/jotbirdhq/mcp-server-jotbird
- **Website:** https://www.jotbird.com/mcp

## Install

```sh
agentstack add mcp-jotbirdhq-mcp-server-jotbird
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# mcp-server-jotbird

An [MCP](https://modelcontextprotocol.io/) server for [JotBird](https://www.jotbird.com) 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](https://www.jotbird.com), open **Account > API keys**, and generate a key.

### 2. Add to your client

Claude Desktop

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

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

Claude Code

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

ChatGPT

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:

```bash
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](https://platform.openai.com/docs/mcp) for details.

Gemini CLI

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

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

Or add via CLI:

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

See [Gemini CLI MCP docs](https://google-gemini.github.io/gemini-cli/docs/tools/mcp-server.html) for details.

Other MCP clients

Any client that supports the [Model Context Protocol](https://modelcontextprotocol.io/) over stdio can use this server. Set the `JOTBIRD_API_KEY` environment variable and run:

```bash
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'"*
- *"Publish this at my namespace as 'project-notes'"* (Pro)

## Tools

### `publish`

Publish Markdown content as a formatted web page with a shareable URL. To update an existing page, pass its slug. Pro users with a username can publish at a permanent namespaced URL by passing `namespaced: true`.

| 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 | For flat documents: slug of an existing page to update. Omit to publish a new page with an auto-generated slug. For namespaced documents (`namespaced: true`): required — publishes at `@username/slug`. Use `list_documents` to find slugs. |
| `namespaced` | No | When `true`, publish at your namespace: `share.jotbird.com/@username/slug`. Requires Pro and a username set in Account Settings. |

### `list_documents`

List the user's published pages. Returns each page's title, URL, slug, expiration date, and username (for namespaced pages).

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. |
| `namespaced` | No | When `true`, delete the document at `@username/slug` instead of the flat URL. Requires Pro and a username. |

## Namespaced URLs (Pro)

Pro users with a username set in Account Settings can publish at permanent, human-readable URLs like `share.jotbird.com/@username/my-page`. Just ask your AI:

> "Publish this at my namespace as 'project-notes'."
> → `share.jotbird.com/@clayton-myers/project-notes`

Namespaced pages never expire and keep the same URL across updates. Set your username in **Account Settings** at [jotbird.com](https://www.jotbird.com).

## 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

```bash
npm install
npm run build
```

Test locally:

```bash
JOTBIRD_API_KEY=jb_your_key node dist/index.js
```

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [jotbirdhq](https://github.com/jotbirdhq)
- **Source:** [jotbirdhq/mcp-server-jotbird](https://github.com/jotbirdhq/mcp-server-jotbird)
- **License:** MIT
- **Homepage:** https://www.jotbird.com/mcp

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-jotbirdhq-mcp-server-jotbird
- Seller: https://agentstack.voostack.com/s/jotbirdhq
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.