MCP Server

BetterPost provides a Model Context Protocol (MCP) server that lets AI assistants interact with your projects, stories, sources, and content generation directly. Manage your content pipeline without leaving your AI coding tool.

Getting Started

BetterPost's MCP server uses OAuth for authentication. When you connect for the first time, you'll be prompted to sign in with your BetterPost account. No API keys needed.

Your MCP server URL is:

https://betterpost.com/mcp

Setup by Client

Claude Desktop

Add this to your Claude Desktop config file.

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Claude Code

Run this command in your terminal:

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

VS Code (GitHub Copilot)

Add this to your .vscode/mcp.json or user settings:

{
  "servers": {
    "betterpost": {
      "type": "http",
      "url": "https://betterpost.com/mcp"
    }
  }
}

Cursor

Add this to your Cursor MCP settings (~/.cursor/mcp.json):

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

Windsurf

Add this to your Windsurf MCP config file (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "betterpost": {
      "serverUrl": "https://betterpost.com/mcp"
    }
  }
}

Available Tools

Once connected, your AI assistant can use the following tools:

Read Operations

| Tool | Description | |------|-------------| | list_projects | List all your BetterPost projects | | get_project | Get project details including criteria and settings | | list_stories | List recent stories ranked by relevancy | | get_story | Get full story details with summary, key points, and quotes | | list_sources | List all content sources for a project | | list_content | List recently generated content | | get_content | Get the full generated content piece | | list_schedule | List scheduled posts for a project | | get_usage | Get your credit usage, project count, and plan limits |

Write Operations

| Tool | Description | |------|-------------| | generate_content | Generate content for any channel (newsletter, blog, twitter, linkedin, etc.) | | add_source | Add a content source to a project | | remove_source | Remove a content source | | hide_story | Hide a story from future content generation | | create_scheduled_post | Set up recurring content on a specific day | | delete_scheduled_post | Remove a scheduled post |

Content Types

The generate_content tool supports all BetterPost channels:

• newsletter - Email newsletter
• blog - SEO-optimized blog post
• twitter - X (Twitter) thread
• linkedin - LinkedIn post
• bluesky - BlueSky post
• facebook - Facebook post
• email_outreach - Email outreach
• tiktok - TikTok script
• instagram - Instagram script
• youtube_shorts - YouTube Shorts script

Example Prompts

Once connected, try asking your AI assistant:

• "Show me the latest stories in my project"
• "Generate a LinkedIn post about the top trending story"
• "Add https://techcrunch.com as a source to my project"
• "How many credits have I used this month?"
• "Create a weekly Tuesday newsletter for my project using trending topics"
• "Hide that irrelevant story about [topic]"
• "What content have I generated recently?"

Authentication

BetterPost's MCP server uses OAuth 2.1 with Clerk. On first connection:

1. Your AI client discovers the authorization server via .well-known endpoints
2. A browser window opens for you to sign in with your BetterPost account
3. You authorize the AI client to access your BetterPost data
4. The client receives a token and can make requests on your behalf

No API keys or manual token management required.

Rate Limits

MCP requests have generous rate limits designed for AI assistant usage:

• General operations: 5,000 requests per minute
• Content generation: 200 requests per minute

Content generation uses 1 credit per generation, same as the web interface.