RecaSmart MCP Server

AI-powered integration for RecaSmart payment platform. Connect your AI coding assistant to create checkouts, query transactions, and read integration docs — all via MCP.

Quick Start

1. Install Dependencies

cd mcp-server
npm install
npm run build

2. Configure in Your AI Tool

Add to your MCP config file:

Claude Code / Antigravity (settings.json or MCP config):

{
  "mcpServers": {
    "recasmart": {
      "command": "node",
      "args": [
        "C:/path/to/recasmart/mcp-server/dist/index.js",
        "--api-key",
        "sk_live_your_api_key_here"
      ]
    }
  }
}

Environment variable alternative:

{
  "mcpServers": {
    "recasmart": {
      "command": "node",
      "args": ["C:/path/to/recasmart/mcp-server/dist/index.js"],
      "env": {
        "RECASMART_API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}

3. Use It!

Once configured, your AI assistant can:

"Create a checkout for $1500 ARS with description 'Plan Premium'"
→ AI calls create_checkout tool

"Show me today's transactions"
→ AI calls list_transactions tool

"How do I integrate RecaSmart webhooks in Express?"
→ AI reads webhook docs + uses setup_webhooks prompt

What's Included

🔧 Tools (API Interaction)

| Tool | Description | |------|-------------| | create_checkout | Create a payment order | | list_checkouts | List orders with filters | | get_checkout_status | Check payment status | | create_payment_intent | Start PIX/transfer payment | | list_transactions | List transactions | | get_transaction | Get transaction details | | list_settlements | List settlements | | get_settlement | Get settlement details |

📚 Resources (Documentation)

| Resource | Content | |----------|---------| | recasmart://docs/overview | API overview & authentication | | recasmart://docs/checkout | Checkout API reference | | recasmart://docs/webhooks | Webhooks & HMAC verification | | recasmart://docs/pix | PIX payments guide | | recasmart://docs/errors | Error codes & troubleshooting |

🤖 Prompts (AI-Assisted Integration)

| Prompt | Description | |--------|-------------| | integrate_recasmart | Full integration guide for any framework | | setup_webhooks | Generate webhook handler with HMAC | | generate_checkout_form | Create payment form + backend |

Configuration

| Option | CLI Flag | Env Variable | Default | |--------|----------|-------------|---------| | API Key | --api-key | RECASMART_API_KEY | (required) | | Base URL | --base-url | RECASMART_BASE_URL | https://api.recasmart.com |

Development

npm run dev    # Watch mode
npm run build  # Build for production
npm start      # Run the server

License

MIT — RecaSmart