# mcp-wompi

Connects the Colombian Wompi payment gateway to AI assistants for handling transactions across PSE bank transfers and Nequi wallets.

- 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/wompi
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-wompi

## What it does

This server exposes 22 tools for interacting with Bancolombia's Wompi platform. It lets your coding assistant produce payment links, look up existing transactions, and process refunds directly during chat sessions. It also supports customer profile queries and PSE financial institution lookups.

Execution works over standard I/O or an HTTP interface listening on port 3000. You need `WOMPI_PUBLIC_KEY` and `WOMPI_PRIVATE_KEY` for server operations. Validating inbound event notifications requires `WOMPI_EVENTS_SECRET`. Without active credentials issued in Wompi's developer console, all gateway requests fail.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `WOMPI_PUBLIC_KEY`, `WOMPI_PRIVATE_KEY`, `WOMPI_EVENTS_SECRET` — 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 mcp-wompi -e WOMPI_PUBLIC_KEY=<WOMPI_PUBLIC_KEY> -e WOMPI_PRIVATE_KEY=<WOMPI_PRIVATE_KEY> -e WOMPI_EVENTS_SECRET=<WOMPI_EVENTS_SECRET> -- npx -y @codespar/mcp-wompi
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add wompi --env WOMPI_PUBLIC_KEY=<WOMPI_PUBLIC_KEY> --env WOMPI_PRIVATE_KEY=<WOMPI_PRIVATE_KEY> --env WOMPI_EVENTS_SECRET=<WOMPI_EVENTS_SECRET> -- npx -y @codespar/mcp-wompi
```
Replace <…> with your own values

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e WOMPI_PUBLIC_KEY=<WOMPI_PUBLIC_KEY> -e WOMPI_PRIVATE_KEY=<WOMPI_PRIVATE_KEY> -e WOMPI_EVENTS_SECRET=<WOMPI_EVENTS_SECRET> wompi npx -y @codespar/mcp-wompi
```
Replace <…> with your own values

## When to use it
- generate Wompi payment links without opening the merchant dashboard
- track transaction progress and trigger refunds
- handle card tokenization and async Nequi wallet registration
- verify incoming webhook signatures against payment events

## Example prompts
- Create a Wompi checkout link for order #902 with an amount of 120000 COP
- Look up transaction details for reference `tx_12345`
- Fetch the list of financial institutions supporting PSE transfers

## 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