io.github.codespar/mcp-wompi (MCP Server for Wompi)

This MCP server provides Model Context Protocol integration for Wompi, the Colombian payment gateway by Bancolombia. It supports payment methods including cards, PSE bank transfers, Nequi, and Bancolombia transfers. The project is published as @codespar/mcp-wompi and distributed under the MIT license.

🛠️ Key Features

MCP server for Wompi (Colombian payments)
Supports cards
Supports PSE bank transfers
Supports Nequi
Supports Bancolombia transfers
Topics include mcp, model-context-protocol, and payments

🚀 Use Cases

Build AI tools that interact with Colombian payment flows
Integrate payment actions for agentic-commerce systems
Support Latin America payment method coverage (including Pix-related topic context)

⚡ Developer Benefits

Install via npm package @codespar/mcp-wompi
Run via stdio (example uses npx -y @codespar/mcp-wompi)
Run in sandbox by setting WOMPI_SANDBOX=true
Configure with WOMPI_PUBLIC_KEY and WOMPI_PRIVATE_KEY

⚠️ Limitations

Credentials and environment variables (public/private keys, sandbox flag) are required to run.

# Set your credentials export WOMPI_PUBLIC_KEY="pub_test_..." export WOMPI_PRIVATE_KEY="prv_test_..." export WOMPI_SANDBOX="true" # Run via stdio npx -y @codespar/mcp-wompi # Run via HTTP MCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-wompi

Variable

Required

Description

WOMPI_PUBLIC_KEY

Yes

Public key from Wompi dashboard

WOMPI_PRIVATE_KEY

Yes

Private key for server-side operations

WOMPI_SANDBOX

Set to "true" for sandbox environment

MCP_HTTP

Set to "true" to enable HTTP transport

MCP_PORT

HTTP port (default: 3000)

Tools (22)

Tool

Purpose

create_transaction

Create a payment transaction

get_transaction

Get transaction details by ID

list_transactions

List transactions

search_transaction_by_reference

Find transaction(s) by merchant reference

void_transaction

Void a transaction

create_payment_link

Create a payment link

get_payment_link

Get payment link details

update_payment_link

Update a payment link

list_payment_links

List payment links

list_payment_methods

List available payment methods for the merchant

get_acceptance_token

Get merchant acceptance token (required for transactions)

create_tokenized_card

Tokenize a credit/debit card

create_tokenized_nequi

Tokenize a Nequi wallet (start async tokenization by phone number)

get_tokenization_status

Query async tokenization status (Nequi etc.) by tokenization id

create_payment_source

Create a reusable payment source (CARD/NEQUI/PSE) linked to a customer email

create_customer

Create a customer profile

get_customer

Get customer by ID

list_financial_institutions

List PSE banks (financial institutions)

create_refund

Create a refund for a transaction

get_refund

Get refund details by ID

get_merchant

Get merchant information

validate_webhook_signature

Validate a Wompi event signature.

Authentication

Set these environment variables before launching the server:

WOMPI_PUBLIC_KEY (required) — Public key for Wompi

WOMPI_PRIVATE_KEY (required, secret) — Private key for Wompi

WOMPI_EVENTS_SECRET (secret) — Events/webhook secret for signature validation

Issue credentials at the provider's developer portal: https://docs.wompi.co.

Install

Configuration

Environment variables

WOMPI_PUBLIC_KEYrequired

Public key for Wompi

WOMPI_PRIVATE_KEYrequiredsecret

Private key for Wompi

WOMPI_EVENTS_SECRETsecret

Events/webhook secret for signature validation

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-wompi": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-wompi@0.2.2"
      ],
      "env": {
        "WOMPI_PUBLIC_KEY": "<YOUR_WOMPI_PUBLIC_KEY>",
        "WOMPI_PRIVATE_KEY": "<YOUR_WOMPI_PRIVATE_KEY>",
        "WOMPI_EVENTS_SECRET": "<YOUR_WOMPI_EVENTS_SECRET>"
      }
    }
  }
}

io.github.codespar/mcp-wompi