Beta

MCP Server

Connect Bolta to AI clients through the Model Context Protocol. The server uses StreamableHTTP, is stateless between calls, and exposes 58 tools mapped from the public REST API — posts, accounts, workspaces, brand voice, agents, reviews, and more.

How it works

Your client signs in with OAuth or connects with an API key, discovers tools, and calls them on your behalf. Each tool invocation is authorized like a normal API request.

MCP request flow — agent → MCP server → backend

Authentication

Option 1: Sign in with OAuth (ChatGPT & connector-style clients)

Nothing to copy. Clients that support OAuth, ChatGPT among them, register themselves, send you to Bolta to sign in, and let you pick which workspace the connection acts in. Access is scoped to that workspace and limited by your role, so the client can never do more in Bolta than you can. Uses authorization code flow with PKCE.

Option 2: API key (agents, scripts & hand-configured clients)

Create a key in Settings → API Keys. Keys start with bolta_sk_ and are scoped to permissions you choose. Use this for clients you configure by hand, or for anything running unattended.

text

Authorization: Bearer bolta_sk_your_api_key

Option 3: OAuth2 access token (your own Developer App)

If you built a Developer App, exchange the authorization code for an access token. Use that token as the same Bearer credential — it works on the API and MCP.

Precedence

If you configure multiple credentials, follow your client's rules — typically the explicit header you set wins. Use one credential per profile to avoid confusion.

Connecting

Server URL

StreamableHTTP endpoint (same URL as in Settings → Integrations → MCP).

text

https://mcp.bolta.ai/mcp

Client configuration

Paste into Claude Desktop, Cursor, or any MCP client that supports StreamableHTTP with custom headers.

json

{
  "mcpServers": {
    "bolta": {
      "url": "https://mcp.bolta.ai/mcp",
      "headers": {
        "Authorization": "Bearer bolta_sk_your_api_key"
      }
    }
  }
}

Tip

Replace bolta_sk_your_api_key with your real key. Store it in a password manager or secure env — never commit keys to git.

Quick example

You do not call JSON-RPC yourself — the agent does. A typical automation looks like this:

list-workspaces — confirm the workspace your key can access.
list-accounts — pick the social account IDs you want to post to.
create-post or schedule-post — publish or schedule with the right workspace_id and account IDs.

Permissions

Your API key must include scopes for each action (e.g. posts:write). Missing scopes return 403 — same as the REST API.

Available tools

58 tools, grouped by area. Each id maps to a public API route (see API reference). Regenerate this list from the server with pnpm run generate:mcp-tools.

Posts

12 tools

Create, schedule, publish, and inspect posts across connected accounts.

bulk-create-postsbulk-create-statuscreate-postdelete-postget-postget-post-platform-detailslist-scheduled-postslist-workspace-postspublish-postschedule-postupdate-postupdate-post-platform-details

Accounts

2 tools

List the connected social accounts for the active workspace.

get-connect-linklist-accounts

Workspaces

3 tools

Inspect workspaces and the caller's capabilities within them.

get-my-capabilitiesget-workspacelist-workspaces

Brand voice & DNA

10 tools

Generate copy in a brand voice, extract business DNA, and manage profiles.

create-voice-profileextract-business-dnaget-business-dnaget-voice-contextget-voice-profilelist-business-dnalist-voice-profilesupdate-business-dnaupdate-voice-profilevoice-generate

Agents

16 tools

Create, schedule, and run agent jobs that automate recurring work.

create-agentcreate-agent-jobdelete-agentdelete-agent-jobget-agentget-agent-jobget-agent-runhire-agent-presetlist-agent-job-runslist-agent-jobslist-agent-presetslist-agent-runslist-agentsrun-agent-job-nowupdate-agentupdate-agent-job

Reviews & approvals

6 tools

Move drafts through the review workflow.

approve-postapprove-recurring-reviewlist-recurring-reviewslist-reviewsreject-recurring-reviewsubmit-for-review

Analytics

6 tools

Pull cross-platform performance data for the workspace.

cross-platform-analyticsget-account-analyticslist-account-insightslist-inbox-itemssend-hunter-replyupdate-hunter-reply

Workspace ops

3 tools

Quotas, capabilities, audit logs, and webhook configuration.

create-social-bucketlist-bucketsupdate-social-bucket

Compatible clients

ChatGPT
Find Bolta at chatgpt.com/plugins. Signs in with OAuth, no API key.
Claude Desktop
Add Bolta to your mcpServers config (Streamable HTTP).
Cursor
MCP settings in Cursor — use the JSON below with your API key.
Continue
Reference Bolta in continueconfig.json under mcpServers.
Custom agents
Any client that speaks MCP over StreamableHTTP with Bearer auth.

Get an API key OAuth for third-party apps