Recaudo Docs

MCP & agents

MCP server

Integrate Recaudo with artificial intelligence assistants

Recaudo includes a MCP (Model Context Protocol) server that lets artificial intelligence assistants such as Claude Desktop, Cursor, Windsurf, Claude Code and other MCP clients work directly with your account: manage customers, create invoices, charge, send WhatsApp, CRM, automations and more.

Remote connection with your account (recommended)

Add this address as an MCP server or custom connector. The app sends you to Recaudo to sign in and choose which permissions to grant: read, or read and write. There are no keys to copy, and you can remove access anytime in Settings → API.

https://recaudo.app/mcp
  • Claude (web, desktop and mobile): Settings → Connectors → Add custom connector, and paste the address.
  • ChatGPT: in Settings → Apps & Connectors, turn on developer mode and create a connector with the address.
  • Claude Code, Cursor and other clients that accept a URL:
claude mcp add --transport http recaudo https://recaudo.app/mcp

Note

The app only sees the tools your role allows and acts on your behalf.

Agents on a server, with an API key

If the agent runs on a server and nobody will sign in, use the same address and send your Secret Key (sk_live_ or sk_test_) in the Authorization header. With the key the agent can do what the API allows, within the limits you set in Agents and payments.

claude mcp add --transport http recaudo https://recaudo.app/mcp --header "Authorization: Bearer sk_live_tu_secret_key"
Keep the Secret Key on the server only, never in browser or app code. Create it in API keys.

Note

The npm package @recaudo/mcp-server no longer gets new tools. If you use it, switch to this address with the same API key.

Available tools

The server has 190 tools, the same ones as the Recaudo assistant: customers, charges, payment links, invoices, orders, WhatsApp conversations, collections, calendar, reports and more. Each person sees the ones their role allows.

Usage example

Once configured, you can talk to your assistant in natural language:

Conversation with Claude

User: List my customers with an active subscription

Claude: I found 24 customers with an active subscription...

User: Create a $500 payment link for Juan Pérez

Claude: Link created: https://recaudo.app/pay/abc123...

User: How many pending invoices do I have?

Claude: You have 12 pending invoices for a total of $45,300.00...

Note

The MCP Server uses your Secret Key to authenticate. Every operation follows the same permissions and limits as the REST API.
Was this page helpful? Thanks for letting us know.
Esc