Skip to main content

Use PostBoost with Cursor

Connect Cursor to PostBoost's MCP server so the Cursor agent can schedule social media posts and manage accounts.

note

PostBoost's MCP server uses an API token today. OAuth sign-in is in progress; when it ships, this page will show it first and keep the token setup as an advanced option.

Before you start​

  • A PostBoost account. The Free plan works: API, webhooks and MCP are on every plan.
  • An API token: in the dashboard go to Settings → Access Tokens → Create Token and copy it (it is shown once).
  • At least one connected social account, so there is something to post to.

The examples use YOUR_API_TOKEN. Never commit a real token; where the client supports it, read it from an environment variable such as POSTBOOST_API_TOKEN.

Connect​

Add PostBoost to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

~/.cursor/mcp.json
{
  "mcpServers": {
    "postboost": {
      "url": "https://postboost.co/mcp/postboost",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Remote servers only need url; Cursor picks the Streamable HTTP transport itself.

Verify​

Open Cursor's MCP settings and check that postboost is enabled and lists its tools. If it does not, open the Output panel, choose MCP Logs, and look for the connection error.

Try it​

Ask the agent things like:

  1. "List my PostBoost social accounts."
  2. "Schedule a LinkedIn and X post for tomorrow at 9:00 saying our 1.8 release is live, with a link to https://postboost.co/docs/changelog."
  3. "Show me posts that failed in the last 7 days and tell me why each one failed."

The agent calls PostBoost tools (list accounts, create post, list posts) and shows you each call before running it, depending on your client's approval settings.

Troubleshooting​

ProblemWhat to check
401 UnauthenticatedThe header must be exactly Authorization: Bearer <token>. Create a new token if the old one was deleted.
403 on a toolAdmin-only tools (workspaces, users, subscriptions) need a token from an admin user.
Tool list is emptyThe server did not connect. Check the URL is https://postboost.co/mcp/postboost (no trailing path), then restart or reload the client.
Network or timeout errorsThe endpoint uses Streamable HTTP. Make sure your client version supports remote HTTP MCP servers and that a proxy is not blocking postboost.co.