io.github.codespar/mcp-epayco

io.github.codespar/mcp-epayco · 273 stars · TypeScript · MIT

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

Install

The repo has no one-line install. Follow its README.

Published as

npm@codespar/mcp-epaycostdio

From the server's entry in the official MCP Registry.

Open the repo

Configuration

Name	Set as	What it is
`EPAYCO_PUBLIC_KEY`Required	Env var	ePayco public key
`EPAYCO_PRIVATE_KEY`Required · Secret	Env var	ePayco private key
`EPAYCO_TEST`Optional	Env var	"true" flags payloads as test mode. Defaults to "true" — set "false" for production.

Files

packages/colombia/epayco/README.md

@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

Facts

Kind: MCP server
Repo: codespar/mcp-dev-latam
Group: Uncategorized
Stars: 273
License: MIT
Language: TypeScript
Last push: 2026-09-27
Forks: 50
MCP Registry: io.github.codespar/mcp-epayco
Homepage: codespar.dev/servers
Topics: agentic-commerce, ai-agents, brazil, claude, fintech, latin-america, llm-tools, mcp, model-context-protocol, nfe, open-finance, payments, pix