MCP Server Reference

This is the full reference for BetterPost's MCP server. For setup instructions and a walkthrough, see Getting Started with the MCP Server.

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 | | list_saved_topics | List saved content topics for a project | | list_content_type_settings | List per-channel content settings | | get_project_stats | Get article and source count stats | | list_product_tie_ins | List product tie-ins for content |

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 | | update_project | Update project settings (audience, tone, industry) | | update_criteria | Update relevancy criteria | | save_topic | Save a content topic for later | | delete_saved_topic | Delete a saved topic | | add_story_from_url | Add a story by URL | | unhide_story | Unhide a previously hidden story | | update_scheduled_post | Modify an existing scheduled post | | update_content_type_settings | Set per-channel instructions and word limits | | delete_content | Delete generated content |

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?"
• "Update my project's target audience to 'startup founders and CTOs'"
• "Set a 500-word limit for LinkedIn posts"
• "Save the topic 'AI in healthcare' for later"
• "Add this article to my project: https://example.com/article"
• "Change my Tuesday newsletter to use trending topics instead of recent stories"

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.