Toffu MCP Server

Toffu is a full AI marketing platform your agent can run end to end: ad accounts (Google, Meta, LinkedIn), analytics, content, campaigns, and reports. This repo describes Toffu's hosted MCP server and how an agent connects to it.

• Hosted endpoint: https://mcp.toffu.ai/mcp (streamable HTTP)

• Human guide: https://toffu.ai/agents

• Machine docs: https://toffu.ai/llms.txt

Onboard with no human

An agent can create an account and get a key in a single call, no email required:

curl -X POST https://mcp.toffu.ai/agent/signup \
  -H 'content-type: application/json' \
  -d '{"company_name": "Acme"}'

The response includes api_key and company_id. Pass a real email to make the account claimable by a human later.

Related MCP server: datavessel

Connect

Add Toffu as an MCP server in your client with the key as a Bearer token, then reload the client so its tools load. Do not hand-roll JSON-RPC.

Claude Code:

claude mcp add --transport http toffu https://mcp.toffu.ai/mcp \
  --header "Authorization: Bearer <api_key>"

Generic client config (Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "toffu": {
      "type": "streamable-http",
      "url": "https://mcp.toffu.ai/mcp",
      "headers": { "Authorization": "Bearer <api_key>" }
    }
  }
}

Toffu also supports OAuth 2.1 + PKCE with Dynamic Client Registration for clients that prefer a consent flow.

CLI

For local agents and terminals: npx toffu signup, then npx toffu ask "<task>". See cli/.

Tools

• send_message: delegate any marketing task in plain language

• query_campaign_performance: performance across connected ad platforms

• creative_report: Meta Ads creative performance

• propose_change / apply_change / undo_change: staged campaign changes

• get_account_context: the owner's rules and connected accounts (call first)

• account_health: Meta opportunity score, pixel quality, catalogs

• propose_ab_test: stage a Meta A/B test

• get_task_result: collect a long send_message answer

Discovery

• Capability doc: https://toffu.ai/.well-known/toffu.json

• llms.txt: https://toffu.ai/llms.txt

License

The contents of this repository are MIT-licensed. The Toffu service itself is proprietary; see https://toffu.ai/terms.