Skip to main content
MCP (Model Context Protocol) connects AI apps like Claude, ChatGPT, and Copilot to your Machines account. Once connected, your AI can check balances, manage cards, handle deposits, and place purchases directly. There is no separate setup for agentic payments. Once Machines MCP is connected, the shopping flow is available too.
Using Claude? The Machines plugin for Claude is the fastest setup. Use this page for other AI apps or as a manual fallback.

​
Prerequisites

  • A Machines account with identity verification complete
  • An AI app that supports remote MCP servers (Claude, ChatGPT, Copilot, Clawdbot, etc.)

​
Connect with OAuth

1

Add a remote MCP server

Open your AI app’s settings and add a new remote MCP server (sometimes called a connector or integration).
2

Paste the MCP URL

https://mcp.machines.cash/mcp
3

Authorize

Click connect, sign in on the Machines page, and approve access.
4

Verify it works

Ask your AI: list my cards

​
Connect with API key

Use this if your app does not support OAuth and asks for manual credentials instead.
1

Create an API key

Go to your Machines dashboard, open Identity, and click Create API Key.
2

Add the key to your AI app

Paste your API key where your app asks for a token, API key, or credential.
3

Use the correct header format

Your app needs one of these headers:
Authorization: Bearer <YOUR_USER_API_KEY>

X-Consumer-Key: <YOUR_USER_API_KEY>

​
Transport type

Use remote Streamable HTTP as the connection type with the URL above. Do not use localhost or stdio — this is a hosted server.

​
Example prompts

Once connected, try these:
  • “list my cards”
  • “show my balances”
  • “start a USDC deposit on Base”
  • “check my active deposits”
  • “reveal full details for my newest card”
  • “search apple airpods pro on amazon”
  • “buy these apple airpods pro on amazon using my default card”
  • “check the status of my latest purchase”
For agentic payments, the same purchase flow works everywhere. You can start a purchase in MCP and continue it later through API or CLI with the same actionId.

​
Troubleshooting

ProblemFix
Connection failsVerify you’re using exactly https://mcp.machines.cash/mcp
”Missing bearer token” errorReconnect with OAuth, or add your API key manually
Labels look raw or unfriendlyAsk for machines.user.cards.list or set presentation: "end_user"
Card numbers refused by hostAsk the AI to use reveal_card_details instead
Still not workingRemove the Machines MCP connection and add it again

​
Keep your account safe

Never share API keys in chats, screenshots, or support tickets. If a key is exposed, revoke it immediately and create a new one.
  • Only approve access on trusted Machines pages (machines.cash domain)
  • Reveal full card details only when you explicitly need them
  • Do not paste keys into shared documents or public channels

​
Next steps