Skip to main content
MCP connects your AI app to your Machines account.

​
What you need first

  • a Machines account
  • access to Identity/KYC in Machines
  • your AI app open

​
Copy this value

https://mcp.machines.cash/mcp
1

1) Add a remote MCP server

In your AI app settings, add a new remote MCP server (or connector).
2

2) Paste the MCP URL

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

3) Connect and approve

Click connect/authorize, sign in on the Machines page, then approve access.
4

4) Test it

Ask: list my cards

​
If your app asks for manual credentials

1

1) Create an API key in Machines

Go to Identity/KYC and click Create API Key.
2

2) Paste that key in your AI app

Your app may call this token, API key, or credential.
3

3) Use one of these accepted formats

Authorization: Bearer <YOUR_USER_API_KEY>

X-Consumer-Key: <YOUR_USER_API_KEY>

​
If your app asks for transport

Use a remote Streamable HTTP connection with: 
https://mcp.machines.cash/mcp
Do not use localhost or stdio for this hosted server.

​
Good first prompts

  • “list my cards”
  • “show my balances”
  • “reveal full details for my newest card”

​
Troubleshooting

  • wrong URL: use exactly https://mcp.machines.cash/mcp
  • error says “missing bearer token or x-consumer-key”: reconnect with OAuth or add your API key
  • labels look raw or not friendly: ask for machines.user.cards.list (or machines.consumer.read with presentation: "end_user")
  • full card numbers are refused by host chat: ask the AI to use reveal_card_details
  • still failing: remove the Machines MCP connection and add it again

​
Keep your account safe

  • never share API keys in chats, screenshots, or tickets
  • revoke and replace a key immediately if exposed
  • only approve access on trusted Machines pages