KosmoKrator

finance

Mercado Pago MCP Integration for OpenAI Agents SDK

Connect Mercado Pago to OpenAI Agents SDK 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 OpenAI Agents SDK

Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.

Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with --write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.

Mercado Pago MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

{
  "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 OpenAI Agents

OpenAI Agents 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 OpenAI AgentsClient-level gateway setup.