Mcp Nequi

io.github.codespar由 GitHub 账号 codespar 发布v0.2.0-alpha.3更新于 Oct 24, 2026

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

已验证STDIO仅桌面金融商业与电商

概览

AI 生成的概览

面向哥伦比亚数字钱包 Nequi 的本地 MCP 服务器，让助手创建支付、二维码和订阅，并查询余额与结算。

可以做什么
创建和定时推送付款、生成二维码付款与商户静态二维码，并通知未注册收款人领取款项。查询付款状态、校验手机号、列出商户交易，并获取账户余额、商户资料和结算数据。冲正付款与交易，并获取或取消订阅。授权针对 Nequi 用户的周期性扣款协议。
适用场景
当助手需要处理哥伦比亚的 Nequi 商户支付时使用：收款或预约付款、生成二维码、查看余额与结算，或处理退款和订阅。目前为早期 alpha 版本，适合评估和沙箱测试，而非无人值守的生产使用。
运行要求
以 npm 包形式通过 stdio 在本地运行，需要 Node.js；也可选用 HTTP 模式。需要 Nequi 开发者账户和三个环境变量：NEQUI_API_KEY、NEQUI_CLIENT_ID 和 NEQUI_CLIENT_SECRET。可选 NEQUI_ENV 选择沙箱或生产，默认沙箱。需要访问 Nequi API 的网络连接。
安装前请注意
涉及真实资金：工具可发起付款、预约未来付款、授权周期性扣款、冲正交易和取消订阅，出错会造成资金变动。README 说明这是 alpha 版本，接口路径尚未完全经过实际验证；应固定精确版本并先在沙箱测试。需要三个凭据，包括机密 NEQUI_API_KEY 和 NEQUI_CLIENT_SECRET，应避免出现在日志和共享配置中。将 NEQUI_ENV 设为生产会指向真实资金

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Nequi，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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

来源：packages/colombia/nequi/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.0-alpha.3最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分