ePayco

What your agent can do

ePayco gives your agent 8 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.

• →tokenize_card — Create a one-time card token (POST /v1/tokens on api.secure.payco.co). The token is then bound to a customer via create_customer and charged via charge_card.
• →create_customer — Create an ePayco customer bound to a card token (POST /payment/v1/customer/create). Returns customer_id used by charge_card.
• →charge_card — Charge a tokenized card (POST /payment/v1/charge/create). Amounts in COP unless currency says otherwise. Test mode is controlled by EPAYCO_TEST.

// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("tokenize_card", { /* ... */ });

Install

$ npm install @codespar/mcp-epayco

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

{
  "mcpServers": {
    "epayco": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-epayco"
      ],
      "env": {
        "EPAYCO_PUBLIC_KEY": "<your_epayco_public_key>",
        "EPAYCO_PRIVATE_KEY": "<your_epayco_private_key>"
      }
    }
  }
}

After restart, your agent can call any of the 8 tools below — try tokenize_card first.

Environment variables · 3

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

Available tools · 8

Each tool is independent — your agent loads only what it needs to reduce context and response time.

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Frequently asked questions