mcp-stp-spei

Name: mcp-stp-spei
Author: codespar

本地服务

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

代码仓库

关于 mcp-stp-spei

mcp-stp-spei 是用于墨西哥 STP/SPEI 即时银行转账系统的 MCP 服务，面向需要在智能体流程中处理转账、余额与对账的开发者。项目目前为 alpha 版本，端点路径尚未完整实机验证。

主要功能

01覆盖 18 个 SPEI 相关工具
02支持转账创建、查询、取消与退款
03提供 CLABE 账号与结构校验
04支持余额查询与对账报表
05支持 webhook 事件注册与管理

适用场景

01在智能体中发起与跟踪 SPEI 转账
02核对每日收付款与已发送订单
03在转账前校验收款方 CLABE 账号

MCP 相关

该项目是 MCP 服务，向 MCP 客户端暴露 STP/SPEI 的转账、余额、银行与 webhook 相关工具。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "codespar-mcp-stp-spei": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-stp-spei"
      ],
      "env": {
        "STP_API_KEY": "<STP_API_KEY>",
        "STP_COMPANY": "<STP_COMPANY>"
      }
    }
  }
}

启动命令npx -y @codespar/mcp-stp-spei

需要配置的环境变量

STP_API_KEY密钥API key for STP

STP_COMPANYCompany identifier for STP

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

安装包

npm@codespar/mcp-stp-spei0.2.0-alpha.3stdio

工具

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

参数	类型	必填	说明
amount	number	是	以 MXN 计价的转账金额
concept	string	是	转账用途／说明
reference	string	是	数字参考编号（最多 7 位）
sender_rfc	string	否	发送方 RFC
sender_name	string	否	发件人姓名
sender_clabe	string	否	发送方 CLABE 账户
beneficiary_rfc	string	否	受益人 RFC（税务 ID）
beneficiary_name	string	是	受益人名称
beneficiary_clabe	string	是	受益人 CLABE（18 位数字）

详细介绍

MCP STP/SPEI

Alpha 版本 — 通过 alpha npm dist-tag 发布。端点路径遵循公开文档和 BACEN/提供商惯例，但尚未经过完整的线上验证。在 0.x.x-alpha 阶段，请固定使用确切版本。使用 npm install <pkg>@alpha 安装。

STP/SPEI 的 MCP 服务——墨西哥即时银行转账系统（相当于巴西的 PIX）。

快速开始

# Set your credentials
export STP_API_KEY="your-api-key"
export STP_COMPANY="your-company-id"

# Run via stdio
npx tsx packages/mexico/stp-spei/src/index.ts

# Run via HTTP
npx tsx packages/mexico/stp-spei/src/index.ts --http

环境变量

变量	必填	描述
`STP_API_KEY`	是	STP 的 API 密钥
`STP_COMPANY`	是	公司标识符
`MCP_HTTP`	否	设置为 `"true"` 以启用 HTTP 传输
`MCP_PORT`	否	HTTP 端口（默认：3000）

工具（18 个）

工具	用途
`create_transfer`	创建 SPEI 转账
`get_transfer`	按 ID 获取转账详情
`list_transfers`	按筛选条件列出转账
`cancel_transfer`	按 clave_rastreo 取消待处理的 SPEI orden（仅在 orden 处于待处理状态时有效）
`get_balance`	获取账户余额
`list_account_balances`	列出公司所有账户的余额
`validate_account`	向收款银行验证 CLABE 账号（在线检查）
`validate_clabe`	在本地验证 CLABE 结构和校验和（不调用 API）。
`list_banks`	列出参与 SPEI 的银行
`lookup_bank_by_code`	按 ABM/SPEI 代码（CLABE 的前 3 位数字）查找参与的银行
`get_cep`	获取用于验证转账的 CEP（Comprobante Electronico de Pago）
`register_beneficiary`	注册受益人账户
`create_refund`	为先前收到的转账创建 SPEI 退款/devolución
`list_refunds`	按日期范围列出 devoluciones（退款）
`conciliation_report`	按日期获取交易对账报告（所有已接收和已发送的 ordenes）
`register_webhook`	注册 Webhook URL，以接收 STP 事件通知
`list_webhooks`	列出公司已注册的 Webhook
`delete_webhook`	按 ID 删除已注册的 Webhook