Mcp Wompi

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Oct 24, 2026

Wompi — Colombian payment gateway (by Bancolombia)

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

MCP server for Wompi, Bancolombia's Colombian payment gateway, letting an assistant create and manage transactions, payment links, refunds and customers.

What you can do
  • Create, look up, list, search by reference and void payment transactions
  • Create, update and list payment links, and list available payment methods
  • Tokenize cards and Nequi wallets, check tokenization status, and create reusable payment sources
  • Create and retrieve customers, list PSE banks, and get merchant information
  • Create and retrieve refunds, and validate Wompi webhook event signatures
When to use it
Useful when an assistant needs to work with Wompi payments in Colombia: building or testing checkout flows, issuing refunds, managing payment links and customers, or checking transaction status from a chat session.
Requirements
Runs locally via npx from the npm package @codespar/mcp-wompi (Node.js). Requires WOMPI_PUBLIC_KEY and WOMPI_PRIVATE_KEY, and optionally WOMPI_EVENTS_SECRET for webhook signature validation. Optional WOMPI_SANDBOX and MCP_HTTP/MCP_PORT variables switch to sandbox or HTTP transport. Credentials come from the Wompi developer portal.
Before you install
The private key (WOMPI_PRIVATE_KEY) and events secret (WOMPI_EVENTS_SECRET) are sensitive credentials that authorize real payment operations. Tools can create transactions, payment links, payment sources, refunds and customers, and void transactions, which move or affect real money and customer data. Tokenizing cards and Nequi wallets sends payment details to Wompi. Start in sandbox mode before using live credentials.

Installation

In SourceWeft

  1. Open Mcp Wompi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-wompi

MCP server for Wompi, the Colombian payment gateway by Bancolombia, supporting cards, PSE bank transfers, Nequi, and Bancolombia transfers

[npm] [License: MIT]

Quick Start

bash
# Set your credentialsexport WOMPI_PUBLIC_KEY="pub_test_..."export WOMPI_PRIVATE_KEY="prv_test_..."export WOMPI_SANDBOX="true"
# Run via stdionpx -y @codespar/mcp-wompi
# Run via HTTPMCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-wompi

Environment Variables

VariableRequiredDescription
WOMPI_PUBLIC_KEYYesPublic key from Wompi dashboard
WOMPI_PRIVATE_KEYYesPrivate key for server-side operations
WOMPI_SANDBOXNoSet to "true" for sandbox environment
MCP_HTTPNoSet to "true" to enable HTTP transport
MCP_PORTNoHTTP port (default: 3000)

Tools (22)

ToolPurpose
create_transactionCreate a payment transaction
get_transactionGet transaction details by ID
list_transactionsList transactions
search_transaction_by_referenceFind transaction(s) by merchant reference
void_transactionVoid a transaction
create_payment_linkCreate a payment link
get_payment_linkGet payment link details
update_payment_linkUpdate a payment link
list_payment_linksList payment links
list_payment_methodsList available payment methods for the merchant
get_acceptance_tokenGet merchant acceptance token (required for transactions)
create_tokenized_cardTokenize a credit/debit card
create_tokenized_nequiTokenize a Nequi wallet (start async tokenization by phone number)
get_tokenization_statusQuery async tokenization status (Nequi etc.) by tokenization id
create_payment_sourceCreate a reusable payment source (CARD/NEQUI/PSE) linked to a customer email
create_customerCreate a customer profile
get_customerGet customer by ID
list_financial_institutionsList PSE banks (financial institutions)
create_refundCreate a refund for a transaction
get_refundGet refund details by ID
get_merchantGet merchant information
validate_webhook_signatureValidate a Wompi event signature.

Auth

Uses Bearer token authentication with the private key. The public key is used for client-side tokenization and merchant queries.

API Reference

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

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.

License

MIT

Source: packages/colombia/wompi/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts