SumUp MCP server
Commit Nov 9, 2026Enables AI clients to interact with SumUp accounts, payments, customers, and payouts using natural language.
Also known as sumup/sumup-mcp, sumup-mcp
- Stars
- 8
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.2
- Last commit
- Nov 9, 2026
- License
- Apache-2.0
What is SumUp MCP?
SumUp enables AI clients to interact with SumUp accounts, payments, customers, and payouts using natural language.
Summary generated from the project's README
About SumUp MCP server
Managing merchant accounts and financial data through natural language is what this server enables for users of AI clients like Claude, Cursor, or Codex. It connects large language models directly to SumUp services, allowing you to interact with payments, customers, and payouts without leaving your chat interface. The server runs as a Cloudflare Worker and supports both Streamable HTTP and legacy SSE transports.
To use the hosted version, you connect via an OAuth-capable client and sign in through your browser to authorize the connection. This process uses the MCP OAuth resource-server flow rather than standard API keys. For developers who prefer a local setup with Node.js 22 or later, a local MCP CLI is available for stdio clients and API-key workflows. This setup ensures that session state is preserved across requests using Durable Objects.
What you can do with it
- 1View merchant profile detailsAsk your AI assistant to retrieve and display your specific merchant profile information.
- 2Integrate SumUp with coding assistantsAdd SumUp capabilities directly into your development environment using Cursor or Claude Code.
Written from the project's README. Every use case is checked against a quote from it.
How to install SumUp MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall SumUp MCP in Claude Code
$ claude mcp add --transport http sumup-mcp https://mcp.sumup.com/mcpInstall SumUp MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"sumup-mcp": {
"url": "https://mcp.sumup.com/mcp"
}
}
}Install SumUp MCP in VS Code
.vscode/mcp.json
{
"servers": {
"sumup-mcp": {
"type": "http",
"url": "https://mcp.sumup.com/mcp"
}
}
}Install SumUp MCP in VS Code CLI
$ code --add-mcp '{"name":"sumup-mcp","type":"http","url":"https://mcp.sumup.com/mcp"}'Install SumUp MCP in Codex
$ codex mcp add sumup-mcp --url https://mcp.sumup.com/mcpInstall SumUp MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.sumup-mcp] url = "https://mcp.sumup.com/mcp"
Install SumUp MCP in Gemini CLI
$ gemini mcp add -s user --transport http sumup-mcp https://mcp.sumup.com/mcpInstall SumUp MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"sumup-mcp": {
"url": "https://mcp.sumup.com/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablesumup/sumup-mcp is public and reachablegithub.com/sumup/sumup-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-09github.com/sumup/sumup-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubSumUp MCP Server
SumUp's Model Context Protocol (MCP) server for interactions between large language models (LLMs) and SumUp APIs. The MCP server allows you to connect to SumUp's services from an MCP client (e.g. Cursor, Claude) and use natural language to work with your SumUp account.
This package runs as a Cloudflare Worker and serves the MCP transport for SumUp.
Authentication follows the MCP OAuth resource-server flow:
- The worker publishes protected resource metadata that points clients to the SumUp authorization server.
- Clients send
Authorization: Bearer <access-token>to/mcp. - Bearer tokens must be JWT access tokens issued by
SUMUP_AUTH_HOSTand valid for the worker resource URL.
SumUp API keys such as sup_sk_... are not valid Bearer tokens for the hosted server.
The worker exposes /mcp for Streamable HTTP and /sse for the legacy SSE transport. Both routes are pinned to a Durable Object so MCP session state survives across requests within the same Worker deployment.
Using from an MCP client
Connect an OAuth-capable Streamable HTTP client to https://mcp.sumup.com/mcp and sign in with SumUp in your browser. The client discovers the authorization server from the protected resource metadata.
Install skills and MCP together
The SumUp plugin includes integration skills and hosted MCP configuration. For Codex:
codex plugin marketplace add sumup/sumup-skills
codex plugin add sumup@sumup
codex plugin list
Start a new session and complete authorization when prompted. For other assistants, see the assistant setup guide.
Connect directly
If you only need MCP tools, configure the hosted server directly. For Codex:
codex mcp add sumup --url https://mcp.sumup.com/mcp
codex mcp login sumup
codex mcp list
For Claude Code:
claude mcp add --transport http --scope user sumup https://mcp.sumup.com/mcp
claude mcp list
Open /mcp in Claude Code to authenticate. For Cursor, merge this entry into ~/.cursor/mcp.json:
{
"mcpServers": {
"sumup": {
"url": "https://mcp.sumup.com/mcp"
}
}
}
Complete authorization in Cursor's MCP settings. If you installed the SumUp plugin, use its bundled connection instead of adding a duplicate manual entry.
After connecting, try a read-only prompt: "Use the SumUp MCP tools to show my merchant profile."
See the assistant setup guide for Gemini CLI, VS Code, and Claude Desktop, or the MCP guide for troubleshooting. For stdio clients and API-key workflows, use the local MCP CLI, which requires Node.js 22 or later.
Development
Development setup, local testing, and contributor workflow live in CONTRIBUTING.md.
SumUp MCP questions
How do I add SumUp MCP to Claude Code?
Run claude mcp add --transport http sumup-mcp https://mcp.sumup.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add SumUp MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Can I use my SumUp API key to authenticate with the hosted server?
No, SumUp API keys like 'sup_sk_...' are not valid Bearer tokens for the hosted server.
How do I connect the SumUp MCP server to Cursor?
You can connect by merging the server configuration into your ~/.cursor/mcp.json file and completing authorization in the Cursor MCP settings.