# mcp-epayco

Connects ePayco to your coding assistant to process card transactions, handle PSE debits, and generate offline cash vouchers.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/colombia/epayco
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-epayco

## What it does

This MCP server exposes eight tools for ePayco. It manages card token generation, direct charges, and transaction status queries using referencePayco identifiers. The toolset also handles PSE bank transfers by retrieving bank directories and checkout redirect URLs.

Offline payments run through voucher generation for Efecty, Gana, Red Servi, Punto Red, and Su Red networks. Card calls go to `api.secure.payco.co`. PSE and cash operations target `secure.payco.co` instead.

Calls will fail without valid API credentials. You must supply both `EPAYCO_PUBLIC_KEY` and `EPAYCO_PRIVATE_KEY`. Testing uses regular endpoints, as `EPAYCO_TEST="true"` merely marks payloads as sandbox traffic.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `EPAYCO_PUBLIC_KEY`, `EPAYCO_PRIVATE_KEY`, `EPAYCO_TEST` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env EPAYCO_PUBLIC_KEY=<EPAYCO_PUBLIC_KEY> --env EPAYCO_PRIVATE_KEY=<EPAYCO_PRIVATE_KEY> --env EPAYCO_TEST=<EPAYCO_TEST> --transport stdio epayco -- npx -y @codespar/mcp-epayco
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add epayco --env EPAYCO_PUBLIC_KEY=<EPAYCO_PUBLIC_KEY> --env EPAYCO_PRIVATE_KEY=<EPAYCO_PRIVATE_KEY> --env EPAYCO_TEST=<EPAYCO_TEST> -- npx -y @codespar/mcp-epayco
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "epayco": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-epayco"
            ],
            "env": {
                "EPAYCO_PUBLIC_KEY": "<EPAYCO_PUBLIC_KEY>",
                "EPAYCO_PRIVATE_KEY": "<EPAYCO_PRIVATE_KEY>",
                "EPAYCO_TEST": "<EPAYCO_TEST>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "epayco": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-epayco"
            ],
            "env": {
                "EPAYCO_PUBLIC_KEY": "<EPAYCO_PUBLIC_KEY>",
                "EPAYCO_PRIVATE_KEY": "<EPAYCO_PRIVATE_KEY>",
                "EPAYCO_TEST": "<EPAYCO_TEST>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e EPAYCO_PUBLIC_KEY=<EPAYCO_PUBLIC_KEY> -e EPAYCO_PRIVATE_KEY=<EPAYCO_PRIVATE_KEY> -e EPAYCO_TEST=<EPAYCO_TEST> epayco npx -y @codespar/mcp-epayco
```
Replace <…> with your own values

## When to use it
- tokenize credit cards and execute payment charges
- fetch the active directory of Colombian PSE banks
- initiate a PSE bank debit transaction with a redirect URL
- generate cash vouchers for Efecty, Gana, or Punto Red
- retrieve transaction details using a referencePayco identifier

## Example prompts
- Generate a cash payment receipt for Efecty for 45000 COP
- List all available PSE banks and initiate a transfer for customer 42
- Check the payment status for transaction referencePayco 102938

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md