Mcp Nequi

io.github.codesparPublished by GitHub account codesparv0.2.0-alpha.3Updated Oct 24, 2026

Nequi — Colombian digital wallet (50M+ users, by Bancolombia)

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Local MCP server for the Nequi Colombian digital wallet, letting an assistant create payments, QR codes and subscriptions and query balances and settlements.

What you can do
Create and schedule push payments, generate QR payments and static merchant QR codes, and notify unregistered recipients to claim funds. Check payment status, validate phone numbers, list merchant transactions, and retrieve account balance, merchant profile and settlement data. Reverse payments and transactions, and manage subscriptions by fetching details or cancelling them. Authorize recurring charge agreements against a Nequi user.
When to use it
Use it when an assistant needs to work with Nequi merchant payments in Colombia: taking or scheduling payments, issuing QR codes, checking balances and settlements, or handling refunds and subscriptions. It is an early alpha, so it suits evaluation and sandbox testing rather than unattended production use.
Requirements
Runs locally over stdio as an npm package, so Node.js is needed; an optional HTTP mode is available. Requires a Nequi developer account and three environment variables: NEQUI_API_KEY, NEQUI_CLIENT_ID and NEQUI_CLIENT_SECRET. Optional NEQUI_ENV selects sandbox or production, defaulting to sandbox. Network access to the Nequi API is required.
Before you install
Handles real money: tools can send payments, schedule future payments, authorize recurring charges, reverse transactions and cancel subscriptions, so mistakes move funds. The README warns the release is alpha and endpoint paths are not fully live-validated; pin exact versions and test in sandbox first. It needs three credentials, including the secret NEQUI_API_KEY and NEQUI_CLIENT_SECRET, which should be kept out of logs and shared configs. Setting NEQUI_ENV to production points it at live funds

Installation

In SourceWeft

  1. Open Mcp Nequi 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

MCP Nequi

Alpha release — published under the alpha npm dist-tag. Endpoint paths follow public docs and BACEN/provider conventions but have not been fully live-validated. Pin exact versions during 0.x.x-alpha. Install with npm 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

bash
# Set your credentialsexport NEQUI_API_KEY="your-api-key"export NEQUI_CLIENT_ID="your-client-id"export NEQUI_CLIENT_SECRET="your-client-secret"
# Run via stdionpx tsx packages/colombia/nequi/src/index.ts
# Run via HTTPnpx tsx packages/colombia/nequi/src/index.ts --http

Environment Variables

VariableRequiredDescription
NEQUI_API_KEYYesAPI key from Nequi developer portal
NEQUI_CLIENT_IDYesOAuth2 client ID
NEQUI_CLIENT_SECRETYesOAuth2 client secret
NEQUI_ENVNo"sandbox" or "production" (default: sandbox)
MCP_HTTPNoSet to "true" to enable HTTP transport
MCP_PORTNoHTTP port (default: 3000)

Tools (16)

ToolPurpose
create_push_paymentSend a push payment notification to a Nequi user
get_payment_statusCheck the status of a payment
create_qr_paymentGenerate a QR code for payment
reverse_paymentReverse a completed payment
get_subscriptionGet subscription details for a phone number
unsubscribeCancel a subscription
create_static_qrGenerate a static (reusable) Nequi QR code for a merchant
reverse_transactionReverse any Nequi transaction by transaction ID (refund flow)
validate_phoneCheck whether a phone number is enrolled in Nequi
notify_unregistered_paymentNotify a non-Nequi recipient with instructions to claim a payment
list_transactionsList transactions for a merchant within a date range
get_balanceGet the merchant's own Nequi account balance
schedule_paymentSchedule a Nequi push payment for a future date
authorize_recurring_chargeAuthorize a recurring charge agreement against a Nequi user
get_merchant_infoRetrieve registered merchant business profile
get_settlementQuery 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 Nequi
  • NEQUI_CLIENT_ID (required) — OAuth2 client ID
  • NEQUI_CLIENT_SECRET (required, secret) — OAuth2 client secret

Issue credentials at the provider's developer portal: https://api.nequi.com.co.

License

MIT

Source: packages/colombia/nequi/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.0-alpha.3LatestSep 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