Tolt MCP Server

What is Tolt MCP Server?

Tolt MCP Server is the official hosted MCP endpoint for Tolt, the affiliate marketing software for SaaS startups, letting Claude, ChatGPT and other MCP clients answer questions about your affiliate program from live Tolt data.

Tolt runs affiliate and partner programs for SaaS companies: a branded affiliate portal, referral tracking, commissions and payouts. The Tolt MCP connects that data to an AI assistant, so instead of logging into the dashboard, searching reports or exporting CSVs, you can ask "Who are my top 10 partners by revenue this month?" and get an answer pulled from your account. Tolt describes the current release as v1; the actions it has announced for v2 (inviting partners, approving or rejecting commissions from chat, auto-generated partner reports) are not part of the server yet.

How to use Tolt MCP Server?

You need a Tolt account with an affiliate program. The server URL is:

https://mcp.tolt.com/

The server uses Streamable HTTP and OAuth. There is no API key to copy: when your client connects, a browser window opens, you sign in to Tolt and click Allow to grant access to your account.

Claude Code

claude mcp add --transport http tolt https://mcp.tolt.com/

Then run /mcp inside Claude Code and choose to authenticate; the Tolt sign-in opens in your browser.

Claude Desktop and claude.ai

Tolt's guide: open Settings > Connectors, click Add custom connector, enter a name and the URL https://mcp.tolt.com/. Keep the default settings (Authentication: Sign in now, OAuth client: Use Claude's published identity, no request headers, Transport: Streamable HTTP) and click Add. Continue in the browser window, review the request and click Allow. Make sure the Tolt connector toggle is on before you start a new chat.

Cursor

Add the server to ~/.cursor/mcp.json (or a project's .cursor/mcp.json), then authenticate from Cursor's MCP settings:

{
  "mcpServers": {
    "tolt": {
      "url": "https://mcp.tolt.com/"
    }
  }
}

VS Code

Add it to .vscode/mcp.json; VS Code starts the OAuth flow the first time the server is used:

{
  "servers": {
    "tolt": {
      "type": "http",
      "url": "https://mcp.tolt.com/"
    }
  }
}

ChatGPT

Tolt also documents ChatGPT: add an MCP server with Streamable HTTP and the URL https://mcp.tolt.com/, leave the bearer token and headers empty, save, then click Authenticate and Allow.

Key features of Tolt MCP Server

• Official, hosted by Tolt: nothing to install or run locally.
• OAuth sign-in with your Tolt account; no API keys in config files.
• Answers questions about partners, referred revenue, clicks, customers, commissions and transactions from your own program.
• Server-side aggregation tools: Tolt's engineering write-up names top_partners, partner_performance_snapshot, commission_reconciliation and get_program_summary, which compute totals on the server instead of making the agent page through every record.
• Async exports for large pulls (export_job_start, export_job_status, export_job_result), so a full year of commissions does not have to fit in one tool response.
• A schema_introspect tool that tells the agent which fields exist before it queries data.
• Works in Claude, ChatGPT and other MCP clients; in Claude you can set each tool to run automatically, need approval or be disabled.

Use cases of Tolt MCP Server

• Partner rankings: "Who are my top 10 partners by revenue this month, and how does that compare to last month?"
• Funnel problems: "Are there any partners with high clicks but low conversions?"
• Commission review: "Show me all pending commissions over $500 and flag anything unusual."
• Inactive partners: "Which partners haven't generated a referral in 90 days?"
• Partner deep-dives: ask for a full overview of one partner's customers, transactions and commissions before a call.
• Recurring summaries: combined with other connectors, pull weekly top-partner performance and post it to Slack, or create a task when a partner crosses a revenue threshold.

Troubleshooting Tolt MCP Server

• Tolt tools don't show up in a chat: in Claude, check that the Tolt connector toggle is enabled before starting the chat.
• Connection asks for a token: none is needed. Leave the bearer token and request headers empty and complete the OAuth sign-in instead.
• Numbers look off: AI assistants can make mistakes. Tolt recommends double-checking important figures in the Tolt dashboard.
• You want write actions: inviting partners and approving commissions are announced for v2, not available in v1.