mcp-mercado-pago

Name: mcp-mercado-pago
Author: codespar

本地服务

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

代码仓库

关于 mcp-mercado-pago

MCP 服务，用于接入 Mercado Pago 支付平台，面向拉丁美洲的支付与收款场景。它通过 MCP 工具覆盖支付、Checkout Pro、PIX、退款、订阅和商户订单等操作。

主要功能

01支付创建、查询与退款
02Checkout Pro 偏好设置管理
03PIX 支付创建
04订阅（preapproval）管理
05平台分账与卖家授权
06争议退单证据上传

适用场景

01在智能体中发起 PIX 或卡支付
02为电商结账生成 Checkout Pro 链接
03处理全额或部分退款及退单争议

MCP 相关

该项目是 MCP 服务，向 MCP 客户端暴露 30 个工具，用于调用 Mercado Pago 的 API。通过环境变量 MERCADO_PAGO_ACCESS_TOKEN 完成 Bearer Token 认证。

配置

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

mcp.json · 通用配置

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

启动命令npx -y @codespar/mcp-mercado-pago

需要配置的环境变量

MERCADO_PAGO_ACCESS_TOKEN密钥API key/token for mercado-pago

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

安装包

npm@codespar/mcp-mercado-pago0.2.2stdio

工具

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

参数	类型	必填	说明
token	string	否	银行卡令牌（用于信用卡付款）
amount	number	是	付款金额
description	string	是	付款说明
payer_email	string	是	付款人电子邮件地址
installments	number	否	分期期数（默认为 1）
payment_method_id	string	是	付款方式 ID（例如：pix、credit_card、bolbradesco）

详细介绍

@codespar/mcp-mercado-pago

面向拉丁美洲领先支付平台 Mercado Pago 的 MCP 服务

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "mercado-pago": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-mercado-pago"],
      "env": {
        "MERCADO_PAGO_ACCESS_TOKEN": "APP_USR-..."
      }
    }
  }
}

Claude Code

claude mcp add mercado-pago -- npx @codespar/mcp-mercado-pago

CLI

# Set your access token
export MERCADO_PAGO_ACCESS_TOKEN="APP_USR-..."

# Run via stdio
npx -y @codespar/mcp-mercado-pago

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

工具（30）

工具	用途
`create_payment`	创建新支付
`get_payment`	按 ID 获取支付详情
`search_payments`	使用筛选条件搜索支付
`create_refund`	退款（全额或部分）
`create_preference`	为 Checkout Pro 创建结账偏好设置
`get_preference`	按 ID 获取结账偏好设置
`create_customer`	创建客户
`list_customers`	列出客户
`get_payment_methods`	列出可用的支付方式
`create_pix_payment`	创建 PIX 支付
`get_merchant_order`	按 ID 获取商户订单
`get_balance`	获取账户余额
`create_subscription`	创建定期订阅（preapproval）
`get_subscription`	按 ID 获取订阅（preapproval）详情
`cancel_subscription`	取消订阅（preapproval）
`create_card_token`	将银行卡标记化，以实现安全支付
`get_payment_method_details`	按 ID 获取特定支付方式的详情
`create_store`	创建商店（实体地点或 POS 组）
`list_stores`	列出商店
`create_pos`	创建与商店关联的销售点（POS）
`update_subscription`	更新订阅（preapproval）：金额、状态、原因、银行卡令牌等
`oauth_token_exchange`	将授权码交换为卖家访问令牌（市场平台入驻）。
`create_advanced_payment`	创建市场平台分账支付，并向各收款方分别拨款（application_fee、money_release_days、c...
`get_advanced_payment`	按 ID 获取高级（分账）支付
`get_chargeback`	按 ID 获取拒付详情
`upload_chargeback_evidence`	上传拒付争议的文档／证据。
`get_identification_types`	获取各国家／地区可用的证件／身份类型（CPF、CNPJ、DNI、RUT 等）。
`get_payment_methods_by_site`	列出特定 Mercado Pago 站点可用的支付方式（MLB=巴西、MLA=阿根廷、MLM=墨西哥、MLC...
`create_settlement_report`	手动生成指定日期范围的结算（账户资金）报告。
`search_merchant_orders`	使用筛选条件搜索商户订单（最近 90 天）。

环境变量

变量	必需	描述
`MERCADO_PAGO_ACCESS_TOKEN`	是	Mercado Pago 控制面板中的访问令牌
`MCP_HTTP`	否	设置为 `"true"` 以启用 HTTP 传输
`MCP_PORT`	否	HTTP 端口（默认值：3000）