MCP Server

Publish from Claude, ChatGPT, or any AI.

Turn any AI output into a link. The JotBird MCP server lets your AI publish Markdown as beautifully formatted, shareable web pages. Write a document in conversation, publish it with one command, and get back a live link. No copy-pasting or browser needed.

Get started View on GitHub

Claude Code

Write a beginner's guide to sourdough bread and publish it.

I'll write that guide and publish it for you.

Used publish

Published! Here's your link:
share.jotbird.com/bright-calm-meadow

Claude Code

Write a beginner's guide to sourdough bread and publish it.

I'll write that guide and publish it for you.

Used publish

Published! Here's your link:
share.jotbird.com/bright-calm-meadow

How it works

Three steps to turn any AI conversation into a shareable web page.

Step 1

Get an API key

Create a free JotBird account and generate an API key from your account settings. Takes seconds.

Step 2

Connect your AI

Add the JotBird MCP server to your AI client's config. One JSON snippet — works with Claude Desktop, Claude Code, Gemini CLI, and more.

Step 3

Ask it to publish

Say "publish this as a web page" and your AI handles the rest. You get back a shareable URL instantly.

What you can do

Anything your AI can write, JotBird can publish.

Share AI-generated content

Ask your AI to write a blog post, tutorial, or guide — then publish it as a clean, readable web page with a single shareable link. No formatting or exporting needed.

Export ChatGPT and Claude conversations

Turn AI conversations into permanent, shareable pages. Better than screenshots — your content is rendered as a real web page with proper typography and code highlighting.

Publish notes and documentation

Meeting notes, research summaries, project docs, changelogs — write them in conversation and publish to a URL you can share with your team in seconds.

Automate publishing workflows

Build AI-powered pipelines that generate and publish content automatically. Combine with other MCP tools to create, review, and publish — all in one conversation.

Just say what you want

No special syntax. No commands to memorize. Tell your AI what you need in plain language and it handles the rest.

“Publish this as a web page.”

The simplest case. Your AI takes the conversation context, formats it as Markdown, and publishes it.

“Write a beginner’s guide to sourdough bread and publish it to JotBird.”

Your AI writes the content and publishes it in one step. You get back a shareable URL.

“Update my published page ‘project-roadmap’ with the new Q3 milestones.”

Pass a slug to update an existing page in place. Same URL, fresh content.

“Summarize our conversation and publish it as meeting notes.”

Great for turning long AI sessions into clean, shareable summaries.

“Show me all my published pages.”

Your AI shows you every page with its URL and expiration date.

“Take down the page with slug ‘old-draft’.”

Permanently deletes the page and its public URL.

How it looks

Every published page gets a responsive URL — no ads, no tracking, no clutter. Markdown is rendered with proper typography, code blocks, headings, and lists. Here's an example.

Example of a published JotBird page showing rendered Markdown with headings, lists, and code blocks

Works with your AI

The JotBird MCP server uses the open Model Context Protocol standard, so it works with any compatible client.

Claude Desktop

stdio

Claude Code

stdio

Gemini CLI

stdio

ChatGPT

remote transport

Plus any other MCP-compatible client or framework.

Ready to publish from your AI?

Create a free JotBird account, grab an API key, and start publishing in under a minute.

Create account View on GitHub

Reference

Setup Guide

Everything you need to connect the JotBird MCP server to your AI.

Setup

Get your API key

Your API key starts with jb_ and is shown once — copy it before closing the dialog.

Client

Claude Desktop

Edit your Claude Desktop config file. On macOS it's at ~/Library/Application Support/Claude/claude_desktop_config.json.

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

Restart Claude Desktop. You'll see JotBird's tools (publish, list_documents, delete) available in the tools menu.

Client

Claude Code

One command to add:

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

Client

Gemini CLI

Edit .gemini/settings.json (project) 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

Client

ChatGPT

ChatGPT requires a remote (HTTP) MCP server — it doesn't support local stdio servers directly. Run a proxy with a public tunnel:

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

This prints a public tunnel URL. Then in ChatGPT:

Go to Settings > Apps > Advanced settings and enable Developer mode
Click New App, give it a name, and paste the tunnel URL with /mcp appended
Set authentication to No Auth and click Create
In a new chat, select Developer mode from the model picker and enable the app

See OpenAI's MCP docs for details.

For tool parameters, rate limits, and other technical details, see the API documentation.

The JotBird MCP server is open source. View on GitHub