demo-mercadopago-mcp-server

# Demo Mercado Pago MCP Server A Model Context Protocol server that provides tools for integrating Mercado Pago into your applications. ## Installation & Setup 1. Clone the repository: ```bash git clone https://github.com/mercadolibre/demo-mercadopago-mcp-server.git cd demo-mercadopago-mcp-server ``` 2. Install dependencies: ```bash npm install ``` 3. Get Mercado Pago API credentials You'll need to provide valid Mercado Pago API credentials through the environment variables: - Get your credentials from [Mercado Pago Developer Dashboard](https://www.mercadopago.com/developers/panel/credentials) - CLIENT_ID: Your Mercado Pago application ID - CLIENT_SECRET: Your Mercado Pago secret key 4. Configure MCP Server in your IDE To use with Claude Desktop or other MCP-compatible applications (including Windsurf, Cursor, Cline, etc), add the server configuration to your settings: ```json { "mcpServers": { "mercadopago": { "command": "node", "args": ["/path/to/demo-mercadopago-mcp-server/build/index.js"], "env": { "CLIENT_ID": "your-mercadopago-client-id", "CLIENT_SECRET": "your-mercadopago-client-secret", "DEBUG": "true" // Optional: Enable debug logging } } } } ``` ## Available Tools ### search_documentation Search through Mercado Pago's documentation. ```typescript const result = await use_mcp_tool({ server_name: "mercadopago", tool_name: "search_documentation", arguments: { language: "es", // Language: 'es' or 'pt' query: "checkout pro", siteId: "MLA", // Required: Site ID (e.g., MLB, MLA, MLM) limit: 3 // Optional: Maximum number of results (default: 10, max: 100) } }); ``` Example response: ```markdown # Search Results for "checkout pro" Showing 3 of 8 results ## Checkout Pro Checkout Pro es una solución que permite a tus clientes realizar pagos de forma segura... 🔗 [Read more](https://www.mercadopago.com.ar/developers/es/guides/checkout-pro/introduction) Score: 0.95 --- ## Integrar Checkout Pro Aprende a integrar Checkout Pro en tu sitio web para comenzar a recibir pagos... 🔗 [Read more](https://www.mercadopago.com.ar/developers/es/guides/checkout-pro/integration) Score: 0.85 ``` ## Development Guide ### Building Install dependencies: ```bash npm install ``` Build the server: ```bash npm run build ``` Watch mode for development: ```bash npm run watch ``` ### Running Configure environment variables: ```bash export CLIENT_ID=your_mercadopago_client_id export CLIENT_SECRET=your_mercadopago_client_secret export DEBUG=true # Optional: Enable debug logging ``` Start the server: ```bash npm start ``` Run with inspector for testing: ```bash npm run inspector ```