io.github.codespar/mcp-epayco

Official

by codespar · TypeScript

MCP server for ePayco — Colombian gateway: cards, PSE, Daviplata and cash networks

MCP server for ePayco, a Colombian payment gateway (Davivienda-owned). It provides capabilities aligned with official ePayco SDKs: card tokenization and charges via api.secure.payco.co, plus PSE bank debit and cash network interactions via secure.payco.co.

🛠️ Key Features

Card tokenization and charges (card/token API)
PSE bank debit support (restpagos API)
Cash networks: Efecty, Gana, Red Servi, Punto Red, Su Red
Tooling mirrors ePayco SDK structure (epayco-node)

🚀 Use Cases

Integrate agentic-commerce flows with Colombian payment methods
Route transactions through PSE and cash networks
Use LLM tooling through MCP for payment operations

⚡ Developer Benefits

Consistent API coverage matching official ePayco SDKs
Works within the Model Context Protocol (MCP) tool ecosystem
Focused on payments for Latin America (Colombia)

⚠️ Limitations

Source material describes card/token, PSE, and cash networks only; no additional payment channels are listed

Topics

agentic-commerceai-agentsbrazilclaudefintechlatin-americallm-toolsmcpmodel-context-protocolnfeopen-financepaymentspix

packages/colombia/epayco/README.md2 KBView on GitHub

@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:

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

bash

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

Install

Configuration

Environment variables

EPAYCO_PUBLIC_KEYrequired

ePayco public key

EPAYCO_PRIVATE_KEYrequiredsecret

ePayco private key

EPAYCO_TEST

"true" flags payloads as test mode. Defaults to "true" — set "false" for production.

Add to VS Code Add to Cursor

claude_desktop_config.json