@codespar/mcp-epayco

@codespar/mcp-epayco

MCP server for ePayco — Colombian payment gateway (Davivienda-owned): card tokenization and charges, PSE bank debit, and cash networks (Efecty, Gana, Red Servi, Punto Red, Su Red).

The tool set mirrors the official ePayco SDKs (epayco-node): the card/token API on api.secure.payco.co and the restpagos API on secure.payco.co for PSE and cash. Test mode is a payload flag (EPAYCO_TEST), not a separate host.

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "epayco": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-epayco"],
      "env": {
        "EPAYCO_PUBLIC_KEY": "your-public-key",
        "EPAYCO_PRIVATE_KEY": "your-private-key",
        "EPAYCO_TEST": "true"
      }
    }
  }
}

Claude Code

claude mcp add epayco --env EPAYCO_PUBLIC_KEY=pk --env EPAYCO_PRIVATE_KEY=sk -- npx -y @codespar/mcp-epayco

Tools (8)

Tool	Description
tokenize_card	Create a card token (POST /v1/tokens)
create_customer	Create a customer bound to a card token
charge_card	Charge a tokenized card (POST /payment/v1/charge/create)
get_transaction	Transaction detail by referencePayco
create_pse_payment	PSE bank debit — returns the bank redirect URL
get_pse_transaction	PSE transaction status by transaction id
list_pse_banks	PSE bank list
create_cash_payment	Cash voucher on efecty / gana / redservi / puntored / sured

Environment

Variable	Required	Description
EPAYCO_PUBLIC_KEY	yes	Public key
EPAYCO_PRIVATE_KEY	yes	Private key
EPAYCO_TEST	no	"true" (default) flags payloads as test mode

Docs

• Provider docs: https://docs.epayco.com
• Managed tier (one interface across every LATAM provider, governance + audit): https://codespar.dev/agents

Enterprise

Need governance, budget limits, and audit trails for agent-driven payments on ePayco? CodeSpar Enterprise adds a policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT