mercadopago — Agent Skill

mercadopago

Mercado Pago multi-product integration toolkit for Claude Code. Product availability depends on country, account eligibility, and commercial enablement.

Code scaffolding works without MCP authentication using bundled references and the official per-country llms.txt. The plugin requests OAuth only immediately before a selected MCP tool, such as live documentation fallback, credential import, test-user actions, webhook registration, quality evaluation, or homologation.

Quick Start

After installing the plugin, start using it offline or connect to your Mercado Pago account when an MCP-backed operation is needed — no Access Token setup is required.

Claude Code: OAuth starts on demand. Run /mp-connect only to connect or verify the status manually.

Other IDEs (Cursor, VS Code, Windsurf, etc.): add the HTTP server via your IDE's MCP settings panel with URL https://mcp.mercadopago.com/mcp, then complete the OAuth flow your IDE prompts. See /mp-connect for IDE-specific snippets.

Version 4.3.2

• /mp-integrate reads routed skills directly from ${CLAUDE_PLUGIN_ROOT}, avoiding a Bash preflight before routing.

Version 4.3.1

• Checkout Pro and Checkout API always resolve a concrete checkout CTA.
• Checkout API creates and validates a separate payment screen; Checkout Pro keeps its hosted-checkout button in the resolved location.
• Card fields require persistent associated labels and remain interactive throughout SDK initialization.
• Public client configuration is loaded at runtime without HTML placeholder substitution.
• Official SDK installation or updates require authorization and use the current stable release.
• Bundled plugin files use ${CLAUDE_PLUGIN_ROOT}; the plugin never copies its MCP configuration into the developer's project.
• Deterministic contracts cover Bricks, Subscriptions, Marketplace, Wallet Connect, SmartApps, Payouts, QR, and Point.
• Public installation and data-flow boundaries are documented in the repository SECURITY.md and PRIVACY.md.

Architecture (v4)

One agent, four skills, one MCP. The plugin is an orchestrator: stable, version-pinned scaffold contracts and safety anchors are bundled and regression-tested, while volatile product documentation and live account data come from official country documentation or MCP on demand.

┌────────────────────────────────────────────────────────┐
│  mp-integration-expert  (router)                       │
│  - country detection                                   │
│  - mode detection (Orders API vs legacy)               │
│  - delegates MCP-backed operations on demand           │
│  - delegates to one of four skills                     │
└──────────────────────────┬─────────────────────────────┘
                           │
        ┌──────────────────┼──────────────────┬──────────────────┐
        ▼                  ▼                  ▼                  ▼
   mp-integrate       mp-webhooks       mp-test-setup        mp-review
   (wizard)           (HMAC + MCP        (create_test_user   (quality_checklist
                       webhook tools)     + add_money)        + security floor)
        │                  │                  │                  │
        └──────────────────┴──────────────────┴──────────────────┘
                           │
                           ▼
              ┌───────────────────────────┐
              │  Mercado Pago MCP server  │
              │  (mcp.mercadopago.com)    │
              │                           │
              │  search_documentation     │
              │  quality_checklist        │
              │  quality_evaluation       │
              │  save_webhook             │
              │  notifications_history…   │
              │  create_test_user         │
              │  add_money_test_user      │
              │  application_list         │
              └───────────────────────────┘