Yes. The Mercado Pago MCP server is free to use with a Mercado Pago developer account; you only incur the normal Mercado Pago fees on real transactions your integration later processes.

Does it charge or refund payments directly?

No. It focuses on documentation and code generation, integration quality scoring, webhook configuration and simulation, and sandbox test-user tooling. It is an integration assistant, not a payment-execution server, so it does not move real money on its own.

Mercado Pago MCP server

OfficialMercado Pago16Config last verified Jun 1, 2026

Mercado Pago's official MCP server helps agents integrate it by searching docs, generating code, scoring integration quality, and testing webhooks.

Mercado Pago MCP Server is the official server from Mercado Pago (Mercado Libre) that connects AI coding agents to the Mercado Pago developer platform. Rather than directly moving money, it is built to accelerate and harden integrations: an agent can search Mercado Pago's documentation and generate project-tailored code, pull the quality checklist Mercado Pago uses to evaluate an integration, score a real production payment against those standards and get concrete fix suggestions, and diagnose notification history with delivery metrics and failure reports. It also handles the webhook lifecycle end to end — configuring or updating webhook URLs and topics, then simulating notifications so you can validate your backend's reception logic before real events arrive.

For testing, it can create sandbox test users with credentials and balance, top up a test user's account, and read details of the applications in your Mercado Pago account. It is a hosted remote server at https://mcp.mercadopago.com/mcp; clients with native remote support connect directly, and others bridge to it via npx mcp-remote, authenticating with an Authorization header carrying your application's access token. Because it focuses on documentation, code generation, quality scoring, and webhook tooling rather than direct charge or refund actions, it is a safer entry point than payment-execution servers, though you should still treat the access token as a secret and prefer test credentials while building.

Quick install

Copy-paste configs are provided for all 8 supported clients. Pick your client below.

Add to ~/.claude.json

~/.claude.json

json

{
  "mcpServers": {
    "mercadopago": {
      "type": "http",
      "url": "https://mcp.mercadopago.com/mcp",
      "headers": {
        "Authorization": "Bearer <AUTH_HEADER>"
      }
    }
  }
}

Or via CLI

bash

claude mcp add --transport http mercadopago https://mcp.mercadopago.com/mcp

Step-by-step guides

Available tools

Tool	Description
search_documentation	Performs code or text searches in Mercado Pago Developers documentation and generates code tailored to your project.
quality_checklist	Provides a detailed list of the fields Mercado Pago evaluates to optimize your integration quality.
quality_evaluation	Takes a production payment identifier and measures the quality of your integration, returning a score and adjustment suggestions.
save_webhook	Configures or updates webhook notification settings, including URLs and notification topics, to receive alerts from Mercado Pago.
simulate_webhook	Sends simulated webhook notifications for your integration so you can validate your backend's reception logic before handling real events.
notifications_history_diagnostics	Diagnoses and reports on events triggered for a specific integration, with delivery metrics and failure reports.
create_test_user	Creates test users with assigned credentials and available balance to test payment flows in the sandbox.
add_money_test_user	Adds money to a test user account to test payment flows.
get_application	Gets information about the applications created in a Mercado Pago Developers account.

Required configuration

AUTH_HEADERRequired
Authorization header value: `Bearer <your Mercado Pago access token>`. Find the token under Your integrations > Application details > Test or Production credentials.

What you can do with it

Integrate Mercado Pago without leaving the editor

Ask the agent how to implement a flow and search_documentation returns the relevant docs and generates project-tailored code, so you wire up Checkout or the API with current, accurate guidance.

Set up and validate webhooks

Use save_webhook to configure notification URLs and topics, then simulate_webhook to fire test events at your backend and notifications_history_diagnostics to confirm delivery before going live.

FAQ

Is it free?: Yes. The Mercado Pago MCP server is free to use with a Mercado Pago developer account; you only incur the normal Mercado Pago fees on real transactions your integration later processes.
Does it support remote/OAuth?: It is a hosted remote server at https://mcp.mercadopago.com/mcp. Authentication is an Authorization header carrying your application's access token (Bearer) rather than OAuth; clients without native remote support connect via npx mcp-remote.
Does it charge or refund payments directly?: No. It focuses on documentation and code generation, integration quality scoring, webhook configuration and simulation, and sandbox test-user tooling. It is an integration assistant, not a payment-execution server, so it does not move real money on its own.

← Browse all payments servers