Skip to content
SumUpSumUp Developer

MCP Server

Connect MCP-compatible clients and assistants to SumUp APIs and tools.

MCP is an open protocol that standardizes how applications provide context and tools to LLMs. SumUp provides a managed MCP server for AI-powered code editors such as Cursor and general-purpose clients such as Claude Desktop.

The MCP server gives AI agents tools for calling the SumUp API. It also exposes the SumUp developer documentation index and OpenAPI specification as resources.

SumUp runs a managed MCP server at https://mcp.sumup.com/mcp. This endpoint allows your MCP client to interact with SumUp APIs to manage your account, create checkouts, or process payments using Cloud API. The server supports Streamable HTTP1 via /mcp and the deprecated SSE transport via /sse.

Hosted MCP (managed)

Section titled “Hosted MCP (managed)”

If your MCP client supports Streamable HTTP and OAuth, connect it directly to https://mcp.sumup.com/mcp. The client can discover the SumUp authorization server from the endpoint’s protected resource metadata and ask you to authorize access.

The hosted server accepts OAuth access tokens issued for the MCP resource. Do not send a SumUp API key such as sup_sk_... as its Bearer token.

CLI

Section titled “CLI”

The local MCP CLI requires Node.js 22 or later and uses a SumUp API key. Run it with:

SUMUP_API_KEY='sup_sk_MvxmLOl0...' npx -y @sumup/mcp

The local MCP server reads the API key from the SUMUP_API_KEY environment variable.

Cursor

Section titled “Cursor(Opens in a new tab)”
  1. Go to Cursor Settings > MCP
  2. Click + Add new Global MCP Server
  3. Add the following configuration to your global .cursor/mcp.json file.

See the Cursor documentation for more details. You can also add this to your project-specific Cursor configuration (supported in Cursor 0.46+).

{
  "mcpServers": {
    "sumup": {
      "command": "npx",
      "args": ["-y", "@sumup/mcp"],
      "env": {
        "SUMUP_API_KEY": "sup_sk_..."
      }
    }
  }
}

Claude

Section titled “Claude(Opens in a new tab)”

Add the following to your claude_desktop_config.json file. See the Claude Desktop documentation for more details.

{
  "mcpServers": {
    "sumup": {
      "command": "npx",
      "args": ["-y", "@sumup/mcp"],
      "env": {
        "SUMUP_API_KEY": "sup_sk_..."
      }
    }
  }
}

The code editor agent automatically detects available tools and calls the relevant tool when you ask related questions.

Footnotes

Section titled “Footnotes”

  1. https://modelcontextprotocol.io/specification/2025-11-25/basic/transports#streamable-http ↩