MCP server
Connect AI agents to Paragraph via the Model Context Protocol.
The Paragraph MCP server lets AI agents interact with Paragraph directly. Manage posts, publications, subscribers, coins, and more from any MCP-compatible client.
This page is about giving your AI tools (Claude Code, Cursor, and so on) access to Paragraph's API. If you want the opposite (connecting external tools to your Paragraph agent so it can use them), see agent connections.
Quick start
The fastest way to get started is with the hosted server at mcp.paragraph.com. No installation or API key management needed. You authenticate through your Paragraph account in the browser.
claude mcp add paragraph --transport http https://mcp.paragraph.com/mcpAdd to your claude_desktop_config.json:
{
"mcpServers": {
"paragraph": {
"url": "https://mcp.paragraph.com/mcp"
}
}
}Add to .cursor/mcp.json in your project root:
{
"mcpServers": {
"paragraph": {
"url": "https://mcp.paragraph.com/mcp"
}
}
}Add to .vscode/mcp.json in your project root:
{
"servers": {
"paragraph": {
"url": "https://mcp.paragraph.com/mcp"
}
}
}Local server
If you prefer to run the server locally, use npx. Requires Node.js 18+.
npx @paragraph-com/mcpThe server runs over stdio and works with any MCP client.
claude mcp add paragraph -- npx @paragraph-com/mcpTo include your API key:
claude mcp add --env PARAGRAPH_API_KEY=your-key paragraph -- npx @paragraph-com/mcpAdd to your claude_desktop_config.json:
{
"mcpServers": {
"paragraph": {
"command": "npx",
"args": ["@paragraph-com/mcp"],
"env": {
"PARAGRAPH_API_KEY": "your-key"
}
}
}
}Add to .cursor/mcp.json in your project root:
{
"mcpServers": {
"paragraph": {
"command": "npx",
"args": ["@paragraph-com/mcp"],
"env": {
"PARAGRAPH_API_KEY": "your-key"
}
}
}
}Add to .vscode/mcp.json in your project root:
{
"servers": {
"paragraph": {
"command": "npx",
"args": ["@paragraph-com/mcp"],
"env": {
"PARAGRAPH_API_KEY": "your-key"
}
}
}
}Authentication
The remote server at mcp.paragraph.com handles authentication automatically. When you first connect, you'll be redirected to approve access through your Paragraph account in the browser.
For the local server, the MCP server resolves your API key in this order:
PARAGRAPH_API_KEYenvironment variable (highest priority)- Shared CLI config at
~/.paragraph/config.json(set vianpx @paragraph-com/cli login)
Get your API key in the app at app.paragraph.com under Settings -> Publication -> Developer.
Read-only tools like search, feed, and public post fetching work without authentication. You only need to authenticate for write operations and accessing your own publication data.
Available tools
The server exposes 18 tools organized into toolsets:
| Toolset | Tools | Auth required |
|---|---|---|
| posts | get-post, list-posts, create-post, update-post, delete-post, send-test-email | Write ops only |
| publications | get-publication | No |
| subscribers | list-subscribers, get-subscriber-count, add-subscriber | Yes |
| users | get-user | No |
| coins | get-coin, list-coin-holders | No |
| search | search-posts, search-blogs, search-coins | No |
| feed | get-feed | No |
| me | get-me | Yes |
Filtering toolsets
Expose only the tools your agent needs to reduce context usage:
npx @paragraph-com/mcp --toolsets posts,searchAvailable toolset names: posts, publications, subscribers, users, coins, search, feed, me
HTTP mode
For server deployments, run the MCP server over HTTP instead of stdio:
npx @paragraph-com/mcp --http --port 3100The HTTP server binds to 127.0.0.1 (localhost only) and accepts POST requests. A health check is available at GET /health.