mcp-conekta

Name: mcp-conekta
Author: codespar

本地服务

github.com/codespar金融数据2754 周前更新

代码仓库

关于 mcp-conekta

mcp-conekta 是面向 Conekta 支付网关的 MCP 服务，Conekta 是墨西哥的支付网关，支持银行卡、OXXO 现金支付和 SPEI 银行转账。该服务适合需要在 Agent 中处理订单、客户与支付的开发者。

主要功能

01订单的创建、查询、更新与取消
02客户及付款来源（卡令牌）管理
03收款的创建与预授权收款捕获
04退款处理
05Webhook 事件查询与端点管理

适用场景

01让 Agent 为墨西哥客户创建订单并生成收款
02查询订单与收款状态并处理退款
03通过 Webhook 事件跟踪支付状态变化

MCP 相关

该项目是一个 MCP 服务，向 MCP 客户端暴露 21 个工具，用于调用 Conekta API 完成订单、客户、收款和 Webhook 等操作。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "codespar-mcp-conekta": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-conekta"
      ],
      "env": {
        "CONEKTA_API_KEY": "<CONEKTA_API_KEY>"
      }
    }
  }
}

启动命令npx -y @codespar/mcp-conekta

需要配置的环境变量

CONEKTA_API_KEY密钥API key for Conekta

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@codespar/mcp-conekta0.2.2stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
charges	array	否	订单费用
currency	string	是	货币代码（例如 MXN）
line_items	array	是	订单行项目
customer_info	object	是	客户信息
customer_info.name	string	是	客户名称
customer_info.email	string	是	客户电子邮件
customer_info.phone	string	是	客户电话号码

详细介绍

@codespar/mcp-conekta

面向 Conekta 的 MCP 服务。Conekta 是墨西哥领先的支付网关，支持银行卡、OXXO 现金支付和 SPEI 银行转账。

快速开始

# Set your API key
export CONEKTA_API_KEY="key_..."

# Run via stdio
npx -y @codespar/mcp-conekta

# Run via HTTP
MCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-conekta

环境变量

变量	必需	描述
`CONEKTA_API_KEY`	是	Conekta 控制面板中的 API 密钥
`MCP_HTTP`	否	设置为 `"true"` 以启用 HTTP 传输
`MCP_PORT`	否	HTTP 端口（默认值：3000）

工具（21）

工具	用途
`create_order`	创建新订单
`get_order`	根据 ID 获取订单详情
`list_orders`	按筛选条件列出订单
`create_customer`	创建客户
`get_customer`	根据 ID 获取客户
`list_customers`	列出客户
`create_charge`	为现有订单创建扣款
`refund_charge`	退款
`list_payment_sources`	列出客户的支付来源
`get_webhook_events`	列出 Webhook 事件（Conekta Events）
`get_webhook_event`	根据 ID 获取单个 Webhook 事件
`update_customer`	更新客户
`delete_customer`	删除客户
`create_payment_source`	为客户创建支付来源（银行卡令牌）
`delete_payment_source`	从客户处删除支付来源
`update_order`	更新订单（line_items、metadata 等）
`cancel_order`	取消订单
`capture_charge`	扣款预授权订单（pre_authorized → paid）
`create_webhook`	创建 Webhook 端点
`update_webhook`	更新 Webhook 端点
`delete_webhook`	删除 Webhook 端点