About mcp-nequi
mcp-nequi is an MCP server for Nequi, a Colombian digital wallet by Bancolombia. It exposes push payment, QR payment and subscription tools for merchants. The README marks it as an alpha release whose endpoints are not fully live-validated.
Key features
- 01Push payment notification and status checks
- 02Dynamic and static QR payment generation
- 03Subscription lookup and cancellation
- 04Payment and transaction reversal
- 05Merchant balance, settlement and transaction listing
- 06Sandbox and production environment switch
Use cases
- 01Send Nequi push payment requests to customers and track status
- 02Generate a reusable static QR code for a merchant
- 03Reconcile settlements and transaction lists
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @codespar/mcp-nequiNEQUI_API_KEYSecretAPI key for NequiNEQUI_CLIENT_IDOAuth2 client IDNEQUI_CLIENT_SECRETSecretOAuth2 client secretLocal servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
16Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| code | string | Yes | Merchant payment code |
| value | string | Yes | Payment amount in COP |
| message | string | No | Payment message/description |
| merchant_id | string | No | Merchant ID |
| phone_number | string | Yes | Nequi phone number (10 digits) |
Details
From the project READMEMCP Nequi
Alpha release — published under the
alphanpm dist-tag. Endpoint paths follow public docs and BACEN/provider conventions but have not been fully live-validated. Pin exact versions during0.x.x-alpha. Install withnpm install <pkg>@alpha.
MCP server for Nequi — Colombia's leading digital wallet with 50M+ users, powered by Bancolombia. Supports push payments, QR payments, and subscriptions.
Quick Start
# Set your credentials
export NEQUI_API_KEY="your-api-key"
export NEQUI_CLIENT_ID="your-client-id"
export NEQUI_CLIENT_SECRET="your-client-secret"
# Run via stdio
npx tsx packages/colombia/nequi/src/index.ts
# Run via HTTP
npx tsx packages/colombia/nequi/src/index.ts --http
Environment Variables
| Variable | Required | Description |
|---|---|---|
NEQUI_API_KEY | Yes | API key from Nequi developer portal |
NEQUI_CLIENT_ID | Yes | OAuth2 client ID |
NEQUI_CLIENT_SECRET | Yes | OAuth2 client secret |
NEQUI_ENV | No | "sandbox" or "production" (default: sandbox) |
MCP_HTTP | No | Set to "true" to enable HTTP transport |
MCP_PORT | No | HTTP port (default: 3000) |
Tools (16)
| Tool | Purpose |
|---|---|
create_push_payment | Send a push payment notification to a Nequi user |
get_payment_status | Check the status of a payment |
create_qr_payment | Generate a QR code for payment |
reverse_payment | Reverse a completed payment |
get_subscription | Get subscription details for a phone number |
unsubscribe | Cancel a subscription |
create_static_qr | Generate a static (reusable) Nequi QR code for a merchant |
reverse_transaction | Reverse any Nequi transaction by transaction ID (refund flow) |
validate_phone | Check whether a phone number is enrolled in Nequi |
notify_unregistered_payment | Notify a non-Nequi recipient with instructions to claim a payment |
list_transactions | List transactions for a merchant within a date range |
get_balance | Get the merchant's own Nequi account balance |
schedule_payment | Schedule a Nequi push payment for a future date |
authorize_recurring_charge | Authorize a recurring charge agreement against a Nequi user |
get_merchant_info | Retrieve registered merchant business profile |
get_settlement | Query settlement (liquidation) for a given date |
Auth
Uses OAuth2 client credentials flow. The server obtains an access token using client ID and secret, and includes the API key in every request header.
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:
NEQUI_API_KEY(required, secret) — API key for NequiNEQUI_CLIENT_ID(required) — OAuth2 client IDNEQUI_CLIENT_SECRET(required, secret) — OAuth2 client secret
Issue credentials at the provider's developer portal: https://api.nequi.com.co.
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.