mcp-wompi — Claude Code MCP server: what it does, how to install
Connects the Colombian Wompi payment gateway to AI assistants for handling transactions across PSE bank transfers and Nequi wallets.
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-wompiWhat mcp-wompi 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.
What it helps with
- 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 for the agent
- 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
How to install mcp-wompi
Platform CLI
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-wompiReplace <…> with your own values
Platform CLI
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-wompiReplace <…> with your own values
Config file
{
"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
Config file
{
"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
Platform CLI
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-wompiReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-wompi
How to install mcp-wompi in Claude Code?
Run `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` in your CLI.
What does mcp-wompi do?
It provides MCP tools that let language models communicate with Wompi APIs to handle merchant checkout operations and transaction states.
Which payment channels in Colombia are supported?
The server covers Colombian banking rails through PSE transfers, Nequi phone-based tokenization, and debit or credit cards.
