Toffu

What the toffu MCP server does

The toffu MCP server exposes Toffu’s hosted AI marketing platform through Model Context Protocol. It gives an agent access to marketing operations associated with connected Google, Meta, and LinkedIn ad accounts, along with analytics, content, campaigns, and reports.

The service is designed for agents that need to handle marketing requests in plain language or retrieve structured campaign information. The send_message tool delegates a marketing task to Toffu. Reporting tools provide campaign performance across connected ad platforms and creative performance for Meta Ads. The server also includes tools for searching the company’s marketing memory and for making campaign changes through a staged workflow.

How it works

The toffu MCP server is hosted by Toffu rather than run as a local process from this repository. Clients connect to the streamable HTTP endpoint at https://mcp.toffu.ai/mcp. After the connection is configured with authentication, the client loads the available MCP tools.

An agent can create a Toffu account without a human-operated signup flow by sending a POST request to https://mcp.toffu.ai/agent/signup with a company name. The response supplies an API key and company ID. Including a real email address allows a person to claim the account later.

Campaign modifications use three separate operations: propose_change, apply_change, and undo_change. This supports a sequence in which a change is proposed, applied, or reversed, rather than treating every modification as a single action. The repository also publishes capability and machine-readable documentation at https://toffu.ai/.well-known/toffu.json and https://toffu.ai/llms.txt.

Setup and configuration

Configure the toffu MCP server as a streamable HTTP server in the MCP client. A bearer token is passed through the Authorization header:

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

Claude Code can be configured with its HTTP transport command instead of manually writing JSON-RPC. After adding the server, reload the client so its tools become available. Toffu also supports OAuth 2.1 with PKCE and Dynamic Client Registration for clients that use a consent-based authorization flow.

Tools and capabilities

The toffu MCP server exposes these tools:

• send_message: delegates a marketing task in plain language.
• query_campaign_performance: retrieves performance across connected advertising platforms.
• creative_report: reports on Meta Ads creative performance.
• propose_change: stages a campaign change for review or later application.
• apply_change: applies a proposed campaign change.
• undo_change: reverses a campaign change.
• fetch_memory: searches the company’s marketing memory.

The repository is MIT-licensed, while the hosted Toffu service is proprietary and governed by Toffu’s terms.