SumUp MCP Server — Claude Code MCP server: install
Connects Claude Code to SumUp accounts, payments, customers, and payouts through MCP. Use it to query SumUp data in plain language.
claude mcp add --transport http sumup-mcp-server https://mcp.sumup.com/mcpWhat SumUp MCP Server does
SumUp MCP Server connects an MCP client with SumUp services. An agent can inspect merchant account data, payments, customers, and payouts through natural-language requests. The hosted service runs as a Cloudflare Worker.
The main endpoint is https://mcp.sumup.com/mcp, using Streamable HTTP; /sse supports the legacy SSE transport. A Durable Object keeps MCP session state across requests. Access uses OAuth: the client obtains a JWT access token and sends it as a Bearer token to /mcp.
SumUp keys such as sup_sk_... cannot authenticate against the hosted server. After adding the connection, open /mcp in Claude Code and finish the SumUp sign-in flow.
What it helps with
- inspect a SumUp merchant profile
- find payments in an account
- look up customer records
- review SumUp payouts
- query SumUp data from an agent
Example prompts for the agent
- Show me my SumUp merchant profile.
- Find the payments connected to this SumUp account and summarize their details.
- Check the payouts available in SumUp for the selected period.
How to install SumUp MCP Server
Platform CLI: remote server
claude mcp add --transport http sumup-mcp-server https://mcp.sumup.com/mcpPlatform CLI: remote server
codex mcp add sumup-mcp-server --url https://mcp.sumup.com/mcpConfig file
{
"mcpServers": {
"sumup-mcp-server": {
"url": "https://mcp.sumup.com/mcp"
}
}
}Config file
{
"servers": {
"sumup-mcp-server": {
"type": "http",
"url": "https://mcp.sumup.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http sumup-mcp-server https://mcp.sumup.com/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about SumUp MCP Server
How do I install SumUp MCP Server in Claude Code?
Run claude mcp add --transport http sumup-mcp-server https://mcp.sumup.com/mcp. Then open /mcp in Claude Code and complete SumUp authorization.
What does SumUp MCP Server do?
It links an MCP client with SumUp services so an agent can inspect accounts, payments, customers, and payouts using natural-language requests.
Can I use a sup_sk_... key with the hosted server?
No. The hosted endpoint requires a JWT Bearer token issued by SumUp’s authorization server; sup_sk_... API keys are not accepted there.
