Recaudo Docs
Sign up

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.

Requirements

  • Node.js 18 or later
  • An API Secret Key (sk_live_ o sk_test_)

Setup in Claude Desktop

Edit the file claude_desktop_config.json (Mac: ~/Library/Application Support/Claude/claude_desktop_config.json | Windows: %APPDATA%\Claude\claude_desktop_config.json):

claude_desktop_config.json 
{
  "mcpServers": {
    "recaudo": {
      "command": "npx",
      "args": ["-y", "@recaudo/mcp-server"],
      "env": {
        "RECAUDO_API_KEY": "sk_live_tu_secret_key"
      }
    }
  }
}
Replace sk_live_tu_secret_key with your Secret Key. You can generate it in API keys. Restart Claude Desktop after saving the configuration.

Setup in Claude Code

Terminal 
claude mcp add recaudo -e RECAUDO_API_KEY=sk_live_tu_secret_key -- npx -y @recaudo/mcp-server

Setup in Cursor / Windsurf

Create the file .cursor/mcp.json at the root of your project:

.cursor/mcp.json 
{
  "mcpServers": {
    "recaudo": {
      "command": "npx",
      "args": ["-y", "@recaudo/mcp-server"],
      "env": {
        "RECAUDO_API_KEY": "sk_live_tu_secret_key"
      }
    }
  }
}

Available tools

The MCP Server exposes 110 tools organized in 20 modules:

Group Tools Description
Customers 7 CRUD, payment methods, subscriptions
Invoices 9 CRUD, installments, late fees
Payment links 5 Create, cancel, view payments
Charges 3 Direct charges, refunds
Products 10 Catalog: categories and products with inventory
Orders 8 Create, ship, deliver, complete orders
Conversations 7 WhatsApp, Messenger, Instagram: messages and templates
Plans 3 List and create subscription plans
Subscriptions 7 Full cycle: create, pause, cancel
Flows 6 Deploy conversational flows
Webhooks 4 Configure and test webhooks

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...

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