Connect SumUp to Gemini CLI via MCP: Payments

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → SumUp, paste your credentials, mint an MCP API key — done. No Docker, no git clone, no local server.

SumUp + Gemini

Read SumUp merchant accounts, transactions, payouts, checkouts, receipts, card readers, team members and subaccounts from any AI agent. Read-only, with Bearer-token authentication.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

SUMUP_API_KEY

Step 1 — Get credentials

Setting up takes about 2 minutes. You need a SumUp merchant account and an API key from it.

1. Sign in to the SumUp Dashboard at https://me.sumup.com.
2. Open Settings → For Developers (or the Developer Portal).
3. Generate an API key (Personal Access Token) and paste it into SUMUP_API_KEY. It is sent as a Bearer token on every call.
4. Install the connector and run sumup_get_merchant_profile: it returns the merchant code, company name, currency and country of the account behind the key, which shows the key works.

What it reads: the merchant profile; the transaction history, newest first by default, filtered by status (such as SUCCESSFUL, CANCELLED or FAILED) or to the transactions changed since an ISO 8601 timestamp, up to 100 per page; one transaction by its id or its transaction code (such as TD6Q7P2); the payouts to your bank account between two dates (YYYY-MM-DD); the online checkouts and payment links, filtered by your own checkout reference; and the operator subaccounts under the main account.

Merchant code, receipts, team and card readers: the current SumUp API versions address an account by its merchant code, which sumup_get_merchant_profile returns; if the key reaches several accounts, sumup_list_memberships lists them and sumup_get_merchant shows one. With that code the AI also reads the transactions and payouts on the current API versions (payouts include deductions such as refunds and chargebacks), the receipt of a transaction, a single online checkout, the payment methods offered online, saved customers and their tokenized cards (last four digits only), the members, custom roles and registered persons (owners, legal representatives), and the paired card readers with their live status and the checkout sent to them. The older transaction and payout tools stay for existing setups. A 403 means the key's user lacks the permission for that account in SumUp.

Read only: all 26 tools only read. Nothing in your SumUp account is changed; refunds, new checkouts, reader payments and member changes stay in the SumUp Dashboard.

Already installed? The new tools reach a connector you installed earlier through its catalog update: open the connector in AnythingMCP and, under Catalog update available, check the list of new tools and click Apply update. Your credentials and any tools you added yourself stay as they are.

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Gemini

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Gemini CLI reads MCP servers from ~/.gemini/settings.json (on Windows %USERPROFILE%\.gemini\settings.json). Add:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of YOUR_MCP_API_KEY.
2. Save the file and restart gemini.
3. Run /mcp inside Gemini CLI (or gemini mcp list in your shell) — anythingmcp should show as connected.
4. Start prompting — Gemini CLI can now call the SumUp tools.

Available tools

FAQ

Where does Gemini CLI look for MCP servers? In ~/.gemini/settings.json for your user, or in .gemini/settings.json inside a project. gemini mcp list shows each server and whether it connects.

Next steps

• Connector landing page
• Connect to Claude
• Connect to ChatGPT