mercadopago-claude-marketplace
The official Claude Code plugin marketplace for Mercado Pago payment integrations.
[!WARNING] 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.
Explore the Component Catalog
12 skills · 1 agent · 3 commands · 1 hook — all browsable in a visual catalog.
Search, filter, and explore every component with detailed metadata and direct links to source code.
Overview
A 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.
- 12 product skills covering the complete Mercado Pago ecosystem
- 7 countries supported: Argentina, Brazil, Mexico, Chile, Colombia, Peru, Uruguay
- Hybrid architecture — skills provide stable integration intelligence, MCP provides live API data
- Credential leak prevention — hook scans every file write for hardcoded tokens
- Secure token storage — Access Tokens stored in OS keychain (macOS Keychain / Linux secret-tool)
- 3 slash commands —
/mp-setup,/mp-review,/mp-connect
Installation
1. Add the marketplace
/plugin marketplace add https://github.com/mercadopago/mercadopago-claude-marketplace.git
2. Install the plugin
/plugin install mp-developer@mercadopago-claude-marketplace
3. Connect your account
Run the setup script from your terminal (not inside Claude Code):
bash ~/.claude/plugins/cache/mercadopago-claude-marketplace/mp-developer/*/scripts/setup.sh
This stores your Access Token in the OS keychain. Claude Code cannot read the keychain directly — only the MCP server process accesses it at startup.
Get your Access Token at: https://www.mercadopago.com.ar/developers/panel/app
Then restart Claude Code.
Product Coverage
| Skill | Products Covered |
|---|---|
mp-checkout-online | Checkout Pro, Checkout Bricks, Payments API, 3DS, Cross-Border Payments |
mp-notifications | Webhooks (v2), IPN (legacy), HMAC validation |
mp-instore | QR Attended, QR Dynamic, Point devices, Kiosk |
mp-orders | Orders, OU + QR |
mp-subscriptions | Subscription Plans, Preapprovals, Invoices |
mp-wallet | Wallet Connect, Debt Payments, Massive Payment Links |
mp-money-out | Disbursements, Bank Transfers |
mp-marketplace | Marketplace Splits, Seller Onboarding, VTEX, Application Fees |
mp-security | 3D Secure, PCI, Supertoken, Vault, Card Tokenization |
mp-specialized | Insurance (AR), Yape (PE), Fintoc (CL) |
mp-reporting | Settlement Reports, Reconciliation, Account Statements |
mp-sdks | SDK Selection, Setup, Migration (Node, Python, Java, PHP, Ruby, .NET, Go, React, iOS, Android) |
Commands
| Command | Purpose |
|---|---|
/mp-connect | Securely connect to your Mercado Pago account |
/mp-review [scope] | Review an integration for correctness, security, and best practices |
/mp-setup [lang] [product] | Scaffold a new Mercado Pago integration for any product |
Architecture
User question
|
v
+--------------------+
| mp-integration- | 1. Detect country (from project signals or ask)
| expert (agent) | --> 2. Detect product (from signal-to-skill routing)
+--------------------+ 3. Load ONE relevant skill
| |
v v
+---------+ +-----+
| Skill | | MCP | Skill = stable flows, decision trees, gotchas
| (1 of | | | MCP = live endpoints, payloads, code snippets
| 12) | | |
+---------+ +-----+
| |
v v
+--------------------+
| Combined answer |
+--------------------+