KosmoKrator

finance

Mercado Pago MCP Integration for Claude Code

Connect Mercado Pago to Claude Code through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 6 read 1 write Bearer token auth
Submit Mercado Pago feedback View package source

Connect Mercado Pago to Claude Code

Connect local KosmoKrator integrations to Claude Code through one scoped MCP gateway entry.

Add KosmoKrator as a stdio MCP server in the Claude Code project config and select the integrations that should be visible. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Code can inspect read-capable tools without receiving write access by default.

Mercado Pago MCP Config for Claude Code

Claude Code can launch the local kosmo binary directly from the project MCP config.

{
  "mcpServers": {
    "kosmokrator-mercado-pago": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=mercado-pago",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=mercado-pago --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Mercado Pago instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Mercado Pago Tools Visible to Claude Code

Claude Code sees stable MCP tool names generated from the Mercado Pago integration catalog.

MCP toolSource functionTypeDescription
integration__mercado_pago__mercado_pago_list_payments mercado-pago.mercado_pago_list_payments Read Search and list payments from Mercado Pago. Supports filtering by status, external reference, and date range. Returns a paginated list of payment records.
integration__mercado_pago__mercado_pago_get_payment mercado-pago.mercado_pago_get_payment Read Retrieve full details of a specific Mercado Pago payment by its ID. Returns payment status, amount, payer information, and more.
integration__mercado_pago__mercado_pago_create_payment mercado-pago.mercado_pago_create_payment Write Create a new payment in Mercado Pago. Requires the transaction amount, payment method ID, and payer email. Optionally specify the number of installments.
integration__mercado_pago__mercado_pago_list_customers mercado-pago.mercado_pago_list_customers Read Search and list customers in Mercado Pago. Optionally filter by email. Returns a paginated list of customer records.
integration__mercado_pago__mercado_pago_get_customer mercado-pago.mercado_pago_get_customer Read Retrieve full details of a specific Mercado Pago customer by their ID. Returns customer name, email, default card, and more.
integration__mercado_pago__mercado_pago_list_preferences mercado-pago.mercado_pago_list_preferences Read List checkout preferences from Mercado Pago. Returns a paginated list of checkout preference objects that define items, payer details, and payment settings.
integration__mercado_pago__mercado_pago_get_current_user mercado-pago.mercado_pago_get_current_user Read Get the authenticated Mercado Pago user's account information, including name, email, and user ID.

Related Mercado Pago Pages

Mercado Pago CLIUse direct JSON commands instead of MCP discovery. Mercado Pago MCPFull gateway reference and MCP tool names. KosmoKrator for Claude CodeClient-level gateway setup.