Agent Skills
Use SumUp Agent Skills in AI coding assistants when building payment integrations.
Agent Skills(Opens in a new tab) let AI coding assistants load focused instructions for specific tasks. We publish SumUp skills in the sumup/sumup-skills(Opens in a new tab) repository to help you build terminal and online payment integrations faster and with fewer mistakes.
Available Skills
Section titled “Available Skills”sumup: Implementing SumUp checkout flows end-to-end across Checkouts API, Payment Widget, Hosted Checkout, recurring tokenization, and terminal flows.sumup-best-practices: Choosing the right integration path and security posture across online, mobile, terminal SDK, and Cloud API integrations.upgrade-sumup: Planning and executing SumUp API and SDK upgrades across server and mobile surfaces.sumup-debug: Diagnosing integration failures such as webhook signature mismatches, scope issues, session expiry, widget failures, and duplicate refs.sumup-mcp: Configuring and using the SumUp MCP server (https://mcp.sumup.com/mcp) from MCP-capable clients.sumup-testing: Setting up sandbox test merchants, running success and failure scenarios, and validating end-to-end checkout behavior.
Use Skills
Section titled “Use Skills”After installation, ask your assistant to use the relevant SumUp skill for checkout work, for example:
- “Use
$sumupto build a Cloud API payment flow for Solo.” - “Use
$sumupto implement a Payment Widget checkout with server-side checkout creation.” - “Use
$sumup-debugto troubleshoot 3DS and webhook handling for online payments.”
Install Standalone Skills
Section titled “Install Standalone Skills”To install skills together with MCP configuration, follow Set up your AI assistant. The instructions below install skills on their own; they do not configure an MCP connection or require SumUp credentials.
If your assistant supports standard Agent Skills folders, install the SumUp skills with:
npx skills add https://github.com/sumup/sumup-skillsYou can also clone the repository and copy the skill folders into your assistant’s skill directory.
| Agent | Skill directory |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Cursor | ~/.cursor/skills/ |
| OpenCode | ~/.config/opencode/skills/ |
| OpenAI Codex | ~/.codex/skills/ |
| Pi | ~/.pi/agent/skills/ |
Discover Skills
Section titled “Discover Skills”Agents and tools that support the Agent Skills Discovery RFC(Opens in a new tab) can discover the SumUp skills from:
https://developer.sumup.com/.well-known/agent-skills/index.jsonUse this URL in clients that accept a discovery index. Clients that automatically check well-known locations can start from:
https://developer.sumup.com