# SumUp MCP Server

> Lets your agent work with your SumUp account: transactions, refunds, checkouts, payouts and card readers, plus SumUp's developer docs.

SumUp's own hosted MCP server. It connects your agent to the SumUp APIs, so you can explore your SumUp account, payments, customers and payouts in plain words, and it serves SumUp's developer documentation and API specification as resources.

What you can do with it
- Look up your merchant profile
- Review transactions and receipts, and refund a transaction in full or in part
- Create checkouts and check their status
- Save customers and see their payment instruments
- List payouts, including deductions for refunds and chargebacks
- Take payments on SumUp card readers through the Cloud API: list readers, check their status and start a checkout on one
- Manage your account's team members and roles
- Read SumUp's developer documentation and OpenAPI specification

How it connects
SumUp hosts it at https://mcp.sumup.com/mcp over Streamable HTTP. The first time your agent uses it, you sign in with SumUp in your browser (OAuth). SumUp API keys (sup_sk_...) don't work with the hosted server. SumUp documents setup for Claude Code, Claude Desktop (as a custom connector), Codex, Cursor, Gemini CLI, VS Code with GitHub Copilot and Kiro.

Good to know
- It can move money (checkouts, refunds, card reader payments), so SumUp suggests connecting a sandbox merchant account before you try payment workflows.
- For an API key or a stdio-only client, SumUp also publishes a local version: run npx -y @sumup/mcp with SUMUP_API_KEY set (Node.js 22 or later).
- The SumUp plugin (github.com/sumup/sumup-skills) bundles this server with SumUp's payment integration skills. If you install it, use its connection rather than adding the server twice.

- Type: Plugin
- Made by: sumup
- Category: Finance
- Formats: Remote MCP
- Version: 0.1.2
- Website: https://developer.sumup.com/tools/llms/mcp-server/
- Source: https://github.com/sumup/sumup-mcp
- Page: https://pluginboard.ai/plugins/sumup-mcp

## Works with

- ChatGPT
- Claude
- Muse
- Grok Bot
- Gemini
- Grok
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

You'll need:

- `Authorization` (required): OAuth bearer access token for authentication.

Replace each `<NAME>` placeholder with your own value.

### ChatGPT

In ChatGPT on the web: Plugins → + → Add custom MCP server, then paste https://mcp.sumup.com/mcp under Connection. Business and Enterprise plans; Pro can add read-only servers.

### Claude

In Claude (web or desktop): Customize → Connectors → Add custom connector, then paste https://mcp.sumup.com/mcp

### Muse

In Muse: In a Muse chat, ask it to create a custom connector for the MCP server at https://mcp.sumup.com/mcp. Then tap Connect on the card it shows and sign in, or add your key.

### Grok Bot

In Grok Bot: In a chat with your Bot, say "Add this MCP server: https://mcp.sumup.com/mcp". It confirms the details with you and sets it up, and the tools are ready from your next message.

### Grok

In Grok on the web: At grok.com/connectors: New Connector → Custom, then enter https://mcp.sumup.com/mcp and sign in if it asks.

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22sumup-mcp-server%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.sumup.com%2Fmcp%22%7D

Copilot CLI:

```shell
copilot mcp add --transport http --header 'Authorization: <Authorization>' sumup-mcp-server https://mcp.sumup.com/mcp
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=sumup-mcp-server&config=eyJ1cmwiOiJodHRwczovL21jcC5zdW11cC5jb20vbWNwIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiPEF1dGhvcml6YXRpb24%2BIn19

Add to .cursor/mcp.json:

```json
{
  "mcpServers": {
    "sumup-mcp-server": {
      "url": "https://mcp.sumup.com/mcp",
      "headers": {
        "Authorization": "<Authorization>"
      }
    }
  }
}
```

### Claude Code

Run in your terminal:

```shell
claude mcp add --transport http --header 'Authorization: <Authorization>' sumup-mcp-server https://mcp.sumup.com/mcp
```

### Codex

Run in your terminal:

```shell
codex mcp add sumup-mcp-server --url https://mcp.sumup.com/mcp
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

```json
{
  "mcpServers": {
    "sumup-mcp-server": {
      "url": "https://mcp.sumup.com/mcp",
      "headers": {
        "Authorization": "<Authorization>"
      }
    }
  }
}
```

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add --transport http --header 'Authorization: <Authorization>' sumup-mcp-server https://mcp.sumup.com/mcp
```

### Replit

In Replit: At replit.com/integrations, open MCP Servers → + Add MCP server, paste https://mcp.sumup.com/mcp (add any headers under Advanced settings), then click Test & save.

### OpenClaw

Run in your terminal:

```shell
openclaw mcp add sumup-mcp-server --url https://mcp.sumup.com/mcp --transport streamable-http
```

If it needs a key or sign-in: For https://mcp.sumup.com/mcp, add --header NAME=value for each header it needs, or --auth oauth and then run openclaw mcp login sumup-mcp-server.

### OpenCode

Run in your terminal:

```shell
opencode mcp add sumup-mcp-server --url https://mcp.sumup.com/mcp
```

If it needs a key: For https://mcp.sumup.com/mcp, add --header 'NAME=value' for each header it needs. Add --global to use it in every project.

### Hermes Agent

Run in your terminal:

```shell
hermes mcp add sumup-mcp-server --url https://mcp.sumup.com/mcp
```

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "sumup-mcp-server": {
      "url": "https://mcp.sumup.com/mcp",
      "headers": {
        "Authorization": "<Authorization>"
      }
    }
  }
}
```

If it signs in with OAuth: If https://mcp.sumup.com/mcp asks you to sign in, add --auth oauth to the command, or auth: oauth to its entry.

---
From Pluginboard (https://pluginboard.ai).