{
  "markdown": "# mercadopago-claude-marketplace\n\n**The official Claude Code plugin marketplace for Mercado Pago payment integrations.**\n\n[![Status: Beta](https://img.shields.io/badge/status-beta-orange)](https://github.com/mercadopago/mercadopago-claude-marketplace)\n[![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue)](./LICENSE)\n[![Version: 3.0.0](https://img.shields.io/badge/version-3.0.0-green)](./CHANGELOG.md)\n[![Platform: Claude Code](https://img.shields.io/badge/platform-Claude%20Code-7c3aed)](https://claude.com/claude-code)\n[![CI](https://github.com/mercadopago/mercadopago-claude-marketplace/actions/workflows/validate.yml/badge.svg)](https://github.com/mercadopago/mercadopago-claude-marketplace/actions/workflows/validate.yml)\n\n> [!WARNING]\n> **This project is under active development.** APIs, skill structures, and plugin interfaces may change between versions. Use in production integrations at your own discretion. Feedback and contributions are welcome.\n\n<div align=\"center\">\n\n### Explore the Component Catalog\n\n[![Browse Components](https://img.shields.io/badge/%F0%9F%94%8D_Browse_Components-mercadopago--claude--marketplace.vercel.app-3483fa?style=for-the-badge&logoColor=white)](https://mercadopago-claude-marketplace.vercel.app/)\n\n> **13 skills** · **1 agent** · **3 commands** · **1 hook** — all browsable in a visual catalog.\n>\n> Search, filter, and explore every component with detailed metadata and direct links to source code.\n\n</div>\n\n---\n\n## Overview\n\nA Claude Code plugin that gives you an AI-powered integration assistant for the full Mercado Pago product suite. Ask questions, scaffold projects, review code, and get real-time API guidance — all from your terminal.\n\n- **13 product skills** covering the complete Mercado Pago ecosystem\n- **7 countries** supported: Argentina, Brazil, Mexico, Chile, Colombia, Peru, Uruguay\n- **Hybrid architecture** — skills provide stable integration intelligence, MCP provides live API data\n- **Credential leak prevention** — hook scans every file write for hardcoded tokens\n- **Secure token storage** — Access Tokens stored in OS keychain (macOS Keychain / Linux secret-tool)\n- **3 slash commands** — `/mp-setup`, `/mp-review`, `/mp-connect`\n\n## Installation\n\n### 1. Add the marketplace\n\n```bash\n/plugin marketplace add https://github.com/mercadopago/mercadopago-claude-marketplace.git\n```\n\n### 2. Install the plugin\n\n```bash\n/plugin install mercadopago@mercadopago-claude-marketplace\n```\n\n### 3. Connect your account\n\nRun the setup script from your **terminal** (not inside Claude Code):\n\n```bash\nbash ~/.claude/plugins/cache/mercadopago-claude-marketplace/mercadopago/*/scripts/setup.sh\n```\n\nThis stores your Access Token in the OS keychain. Claude Code cannot read the keychain directly — only the MCP server process accesses it at startup.\n\nGet your Access Token at: https://www.mercadopago.com.ar/developers/panel/app\n\nThen restart Claude Code.\n\n## Product Coverage\n\n| Skill | Products Covered |\n|-------|-----------------|\n| `mp-checkout-online` | Checkout Pro, Payments API, 3DS, Cross-Border Payments |\n| `mp-checkout-bricks` | Payment Brick, Card Payment Brick, Wallet Brick, Status Screen Brick |\n| `mp-notifications` | Webhooks (v2), IPN (legacy), HMAC validation |\n| `mp-instore` | QR Attended, QR Dynamic, Point devices, Kiosk |\n| `mp-orders` | Orders, OU + QR |\n| `mp-subscriptions` | Subscription Plans, Preapprovals, Invoices |\n| `mp-wallet` | Wallet Connect, Debt Payments, Massive Payment Links |\n| `mp-money-out` | Disbursements, Bank Transfers |\n| `mp-marketplace` | Marketplace Splits, Seller Onboarding, VTEX, Application Fees |\n| `mp-security` | 3D Secure, PCI, Supertoken, Vault, Card Tokenization |\n| `mp-specialized` | Insurance (AR), Yape (PE), Fintoc (CL) |\n| `mp-reporting` | Settlement Reports, Reconciliation, Account Statements |\n| `mp-sdks` | SDK Selection, Setup, Migration (Node, Python, Java, PHP, Ruby, .NET, Go, React, iOS, Android) |\n\n## Commands\n\n| Command | Purpose |\n|---------|---------|\n| `/mp-connect` | Securely connect to your Mercado Pago account |\n| `/mp-review [scope]` | Review an integration for correctness, security, and best practices |\n| `/mp-setup [lang] [product]` | Scaffold a new Mercado Pago integration for any product |\n\n## Architecture\n\n```\nUser question\n     |\n     v\n+--------------------+\n| mp-integration-    |     1. Detect country (from project signals or ask)\n| expert (agent)     | --> 2. Detect product (from signal-to-skill routing)\n+--------------------+     3. Load ONE relevant skill\n     |          |\n     v          v\n+---------+  +-----+\n| Skill   |  | MCP |      Skill = stable flows, decision trees, gotchas\n| (1 of   |  |     |      MCP  = live endpoints, payloads, code snippets\n|  12)    |  |     |\n+---------+  +-----+\n     |          |\n     v          v\n+--------------------+\n|   Combined answer  |\n+--------------------+\n```\n\n**Skills** contain integration intelligence that rarely changes: product flows, decision trees, prerequisites, country availability, and common gotchas. **MCP** provides dynamic data that must always be current: endpoint URLs, request/response schemas, SDK code snippets, and test credentials.\n\nOnly one skill is loaded per interaction, keeping context lightweight.\n\n## Infrastructure\n\n| Component | Name | Purpose |\n|-----------|------|---------|\n| Agent | `mp-integration-expert` | Single router — detects country and product, loads the right skill |\n| Hook | `validate_mp_credentials` | Credential scanner — blocks hardcoded MP tokens from reaching source files |\n| MCP | `mercadopago` | Live Mercado Pago API access (token from OS keychain) |\n| CI | `validate.yml` | JSON validation, Python syntax checks, skill integrity |\n\n## Requirements\n\n- [Claude Code](https://claude.com/claude-code) CLI\n- Node.js 18+ (for the MCP server)\n- Python 3.8+ (for the credential scanning hook)\n\n## Contributing\n\nSee [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines on adding new plugins or improving existing ones.\n\n## Support\n\nYou may find technical documentation about Mercado Pago's products and services on the [Developer's Website](https://www.mercadopago.com.ar/developers/en)\n\nTechnical Support is avaliable within the [Developer's Website Support Section](https://www.mercadopago.com.ar/developers/en/support/center)\n\n## License\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this project except in compliance with the License.\nYou may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.\n\nSee the [LICENSE](./LICENSE) file for the full license text, and [NOTICE](./NOTICE)\nfor attribution information.\n\n### Copyright\n\nCopyright (c) 2026 Mercado Pago (MercadoLibre S.R.L.)\n",
  "bytes": 6727,
  "sha": "deb3eb73ce122d960ab91618392d6c692950f7e691342cd643ad8f777bc07b06",
  "repo_slug": "diegomarcuz/mercadopago-claude-marketplace",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_diegomarcuz_mercadopago_claude_marketpla_7e8d8aa7/readme"
}