sumup-mcp skill
✓ VerifiedConfigure, authenticate, and troubleshoot the SumUp Model Context Protocol server for merchant account queries and documentation access.
- GitHub stars
- 6
- Files
- 5
- Last commit
- Nov 4, 2026
- License
- Apache-2.0
- Allowed tools
- —
What does the sumup-mcp skill do?
sumup-mcp is an agent skill. Configure, authenticate, and troubleshoot the SumUp Model Context Protocol server for merchant account queries and documentation access.
Summary generated from the skill's SKILL.md.
About the sumup-mcp skill
Managing merchant account queries and accessing SumUp technical documentation is what this skill enables for developers and merchants. It provides two distinct connection methods: a hosted HTTP endpoint using OAuth authorization or a local stdio process requiring Node.js 22 or later and a SUMUP_API_KEY. An agent should load this skill when a user needs to inspect a merchant profile, troubleshoot connection failures like unauthorized access, or retrieve specific API details from the OpenAPI specification and documentation index.
Users can interact with the SumUp ecosystem to check account states using stable identifiers, but the skill does not support taking payments or collecting card details. Instead, it assists in implementing SumUp API or SDK integrations. When tools are missing or servers are unreachable, the skill helps diagnose issues related to transport, outbound HTTPS access, or incorrect Bearer tokens. It relies on the provided documentation resources to ensure tool parameters and names are used accurately without guesswork.
What an agent can do with it
- 1Verify merchant account statusAn agent can retrieve specific details about a user's merchant profile to confirm account settings.
- 2Troubleshoot authentication errorsDevelopers can use the skill to resolve OAuth connection failures or incorrect API key configurations.
- 3Implement payment SDK integrationsThe skill helps guide users through setting up SumUp SDKs in their own applications rather than processing payments directly.
Written from the skill's SKILL.md. Every use case is checked against a quote from it.
How to install the sumup-mcp skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the sumup-mcp skill in Plugin
/plugin marketplace add sumup/sumup-skills /plugin install sumup@sumup
Install the sumup-mcp skill in Claude Code
~/.claude/skills/sumup-mcp/SKILL.md
$ npx degit sumup/sumup-skills/skills/sumup-mcp ~/.claude/skills/sumup-mcpInstall the sumup-mcp skill in Claude Code (project)
.claude/skills/sumup-mcp/SKILL.md
$ npx degit sumup/sumup-skills/skills/sumup-mcp .claude/skills/sumup-mcpInstall the sumup-mcp skill in Codex
~/.agents/skills/sumup-mcp/SKILL.md
$ npx degit sumup/sumup-skills/skills/sumup-mcp ~/.agents/skills/sumup-mcpInstall the sumup-mcp skill in Gemini CLI
~/.gemini/skills/sumup-mcp/SKILL.md
$ npx degit sumup/sumup-skills/skills/sumup-mcp ~/.gemini/skills/sumup-mcpInstall the sumup-mcp skill in Claude.ai
npx degit sumup/sumup-skills/skills/sumup-mcp sumup-mcp && zip -r sumup-mcp.zip sumup-mcp # claude.ai → Customize → Skills → + → Create skill → Upload a skill → sumup-mcp.zip
Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the scripts before you let an agent run them. How checks work
- Source repository linked and reachablesumup/sumup-skills/skills/sumup-mcp is public and reachablegithub.com/sumup/sumup-skills/tree/HEAD/skills/sumup-mcp ↗Pass
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit 2026-11-04github.com/sumup/sumup-skills/commits ↗Pass
- No download-and-run or credential theft in scriptsNo scripts in the skill folderPass
- No hidden instructions in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/sumup/sumup-skills/blob/HEAD/skills/sumup-mcp/SKI ↗Pass
- Pre-approved tools are scopedNo pre-approved tools; the agent asks before using onegithub.com/sumup/sumup-skills/blob/HEAD/skills/sumup-mcp/SKI ↗Pass
- SKILL.md follows the Agent Skills formatValid name and description; says when to use it; 37 linesgithub.com/sumup/sumup-skills/blob/HEAD/skills/sumup-mcp/SKI ↗Pass
SKILL.md
View on GitHubUse SumUp MCP
First determine whether the request is to use available tools or to configure a connection. If SumUp tools are already available, use them for the requested task; do not reinstall the plugin, add a duplicate server, or repeat setup instructions.
Connection choices
| Connection | Authentication and requirements |
|---|---|
Hosted https://mcp.sumup.com/mcp |
Streamable HTTP with OAuth authorization through the client. A SumUp secret API key is not a valid Bearer token for this endpoint. |
Local @sumup/mcp process |
stdio with SUMUP_API_KEY; Node.js 22 or later. Use when API-key authentication or a stdio-only client is required. |
For a new setup, prefer the packaged integration when the client supports it. Use its bundled connection if already installed. For direct configuration, read client setup and only the section for the user's client and transport. Merge configuration with existing servers instead of replacing it.
Complete OAuth in the client's browser flow. Verify a new connection with a read-only request such as: "Use the SumUp MCP tools to show my merchant profile." Keep secret keys and tokens in private client configuration or the process environment.
Documentation resources
When the client supports MCP resources, read the documentation index and OpenAPI specification. Otherwise fetch those URLs directly; the API index links to endpoint pages and SDK samples. Use the installed tools and current contract rather than guessing tool names or parameters.
Connection failures
- Unreachable server: check the exact endpoint, transport, and outbound HTTPS access.
- Unauthorized or repeated login: for hosted MCP, remove any manually configured API-key Bearer header and repeat OAuth; for local stdio, check the private
SUMUP_API_KEYenvironment. Confirm the intended merchant account and required permissions. - Missing tools: inspect the active connection and client-supported capabilities, refresh it if needed, and report an absent capability instead of inventing a tool.
Account operations
Use tools only for the requested account and operation. Taking payments through SumUp MCP is not supported. For payment collection, help the user implement a SumUp API or SDK integration in their application; do not collect card details or invoke tools to process a payment or start a reader payment.
For account queries, report the returned state with stable identifiers and relevant limits. A working query needs its result, not another setup guide. Do not infer payment success from a callback; use authorized reads to check the current state.
Files in this skill
5sumup-mcp skill questions
How do I install the sumup-mcp skill in Claude Code?
Run npx degit sumup/sumup-skills/skills/sumup-mcp ~/.claude/skills/sumup-mcp. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the sumup-mcp skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.
Can I use SumUp MCP to process payments?
No, taking payments through SumUp MCP is not supported. You should instead help the user implement a SumUp API or SDK integration for payment collection.
What are the requirements for the local SumUp MCP process?
The local process requires Node.js version 22 or later and uses stdio with a SUMUP_API_KEY.