@paragraph-com/mcp

MCP (Model Context Protocol) server for Paragraph — expose your publication to AI agents in Claude Desktop, Cursor, VS Code Copilot, and any MCP-compatible client.

Remote server (recommended)

Use the hosted server at mcp.paragraph.com — no installation or API key management required. You'll authenticate through your Paragraph account in the browser.

Claude Code

claude mcp add paragraph --transport http https://mcp.paragraph.com/mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "paragraph": {
      "url": "https://mcp.paragraph.com/mcp"
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "paragraph": {
      "url": "https://mcp.paragraph.com/mcp"
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "paragraph": {
      "url": "https://mcp.paragraph.com/mcp"
    }
  }
}

Local server

If you prefer to run the server locally, you can use npx. Requires Node.js 18+.

npx @paragraph-com/mcp

Authentication (local only)

The remote server handles auth automatically. For local usage, set your API key via environment variable:

PARAGRAPH_API_KEY=your-key npx @paragraph-com/mcp

Or log in with the Paragraph CLI — the MCP server shares the same config:

npx @paragraph-com/cli login
npx @paragraph-com/mcp

Local setup by client

claude mcp add paragraph -- npx @paragraph-com/mcp

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "paragraph": {
      "command": "npx",
      "args": ["@paragraph-com/mcp"],
      "env": {
        "PARAGRAPH_API_KEY": "your-key"
      }
    }
  }
}

Add to .cursor/mcp.json or .vscode/mcp.json:

{
  "servers": {
    "paragraph": {
      "command": "npx",
      "args": ["@paragraph-com/mcp"],
      "env": {
        "PARAGRAPH_API_KEY": "your-key"
      }
    }
  }
}

Streamable HTTP (local)

npx @paragraph-com/mcp --http --port 3100

HTTP mode binds to 127.0.0.1 (localhost only) and accepts POST requests. A health check is available at GET /health.

Available Tools

Posts

• get-post — Get a post by ID or slugs
• list-posts — List posts from a publication or your own posts
• create-post — Create a new post (markdown)
• update-post — Update an existing post: body, status, schedule, cover, canonical URL, or newsletter-only delivery
• delete-post — Delete a post
• send-test-email — Send a test newsletter for a draft

Content

Drafted short-form content — X posts and threads, LinkedIn posts, one-off emails, and X Articles. These tools draft only; the writer sends the piece from the Paragraph app.

• create-content — Save a piece to your publication's library
• list-content — List your library, filterable by kind and status
• get-content — Get one piece, with its body
• update-content — Rename a piece or replace its body
• archive-content — Put a piece away without deleting it
• restore-content — Bring an archived piece back

Content groups

One identity for a post and everything made out of it — the post, the thread drawn from it, the LinkedIn version, the newsletter. The writer sees it as a single stacked row under Content. Seed a group from the post, then pass its bucketId on every create-content derived from it.

• create-post-content-bucket — Get or create a post's group (idempotent)
• get-post-content-bucket — Find a post's group, or null, without creating one
• get-content-bucket — Get one group and everything already made from its post
• list-content-buckets — List the publication's groups, most recently active first

Publications

• get-publication — Get publication metadata by ID, slug, or domain
• update-publication — Update publication settings

Subscribers

• list-subscribers — List your subscribers
• get-subscriber-count — Get subscriber count
• add-subscriber — Add a subscriber by email or wallet
• remove-subscriber — Remove a subscriber by email or wallet

Users

• get-user — Get user profile by ID or wallet

Coins

• get-coin — Get coin metadata or list popular coins
• list-coin-holders — Get coin holders

Search

• search-posts — Search posts
• search-blogs — Search publications
• search-coins — Search coins

Feed

• get-feed — Get the curated platform feed

Me

• get-me — Get your authenticated publication info

Analytics

• analytics-query — Run a read-only SQL query against your publication's analytics (open rates, CTR, subscriber counts, top posts, etc.)
• analytics-schema — List available tables and columns in the analytics schema

Emails

• send-custom-email — Send a markdown email from your publication to a list of recipients

Toolset Filtering

Only expose the tools your agent needs:

npx @paragraph-com/mcp --toolsets posts,search

Available toolsets: posts, content, buckets, publications, subscribers, users, coins, search, feed, me, analytics, emails

Examples

Search and summarize posts on a topic

Prompt: "Search for posts about onchain governance and give me a summary of the top results"

The MCP server calls search-posts with the query. Claude receives the matching posts and synthesizes a summary of the key themes, authors, and publications.

Draft and publish a blog post

Prompt: "Write a post titled 'Weekly Update #12' about our new token-gating feature, then publish it"

The server calls create-post with the title and generated markdown content, creating it as a draft. After you confirm, it calls update-post to set the status to published, making it live on your publication.

Send a newsletter without publishing it online

Prompt: "Email this update to my subscribers, but don't put it on the site"

The server calls create-post to save the draft, then, after you confirm, update-post with publishOnline: false, status: "published", and sendNewsletter: true. Subscribers get the email; the post never appears on your website, feed, or RSS, and its URL returns 404. The tool result has no publicUrl for that reason.

Cross-post something that first appeared elsewhere

Prompt: "Republish my Substack post here and point the canonical at the original"

The server calls create-post with the content, then update-post with canonicalUrl set to the Substack URL. Search engines credit the original instead of treating the Paragraph copy as duplicate content, while the Paragraph link keeps working and the newsletter still sends.

Repurpose a post across channels

Prompt: "Turn my latest post into an X thread and a LinkedIn post"

The server calls create-post-content-bucket with the post's id to get the group, then create-content twice with that bucketId. The writer opens Content and sees the post with the thread and the LinkedIn version stacked under it, ready to review and send.

Get subscriber analytics

Prompt: "How many subscribers does my publication have? Show me the most recent ones."

The server calls get-me to identify your publication, then get-subscriber-count for the total, and list-subscribers to return the latest subscribers with their details.

Answer questions about newsletter performance

Prompt: "What's my average open rate over the last 30 days, and which posts performed best?"

The server calls analytics-query with a scoped SQL query against post_analytics_summary, returning open rates, CTR, and views for each post. Claude summarizes the trend and highlights the top performers.

Explore the platform feed

Prompt: "What's trending on Paragraph right now?"

The server calls get-feed to retrieve the curated platform feed and Claude summarizes the top posts, their authors, and topics.

Manage post lifecycle

Prompt: "Show me my drafts and send a test email for the most recent one"

The server calls list-posts with status: draft to retrieve your drafts, then send-test-email with the latest draft's ID so you can preview the newsletter in your inbox before sending it to subscribers.

Support

• Issues & bugs: GitHub Issues
• Email: [email protected]
• Website: paragraph.com

Releasing

npm run release patch   # 1.0.0 → 1.0.1
npm run release minor   # 1.0.0 → 1.1.0
npm run release major   # 1.0.0 → 2.0.0

Builds, tests, publishes to npm, deploys the Cloudflare Worker at mcp.paragraph.com, and creates a GitHub release. The script will prompt for any missing credentials.

Privacy Policy

This MCP server connects to the Paragraph API on your behalf. See the Paragraph Privacy Policy for details on data collection, usage, storage, and your rights.

License

MIT