From c8f0c6cfc0c023ea267f84ba1f0faa0c2ef58390 Mon Sep 17 00:00:00 2001 From: Fabiano Cruz Date: Sat, 4 Jul 2026 14:37:49 -0300 Subject: [PATCH] docs: de-count the root README (127 real servers), normalize 6 legacy per-server READMEs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Root README hardcoded "110 MCP servers · 2,300 tools" (actual: 127 packages). Counts now appear once in prose at the real number, badges are de-counted so they can't drift, and the machine-readable live count is linked (codespar.dev/api/servers). mercado-pago's README was the pre-publish template (source-run quick start, prose heading, no npm badge); normalized to the standard stripe/getnet template along with 5 more legacy ones (nubank, inter-bank, conekta, afip, wompi). 13 remaining legacy READMEs listed in the PR for a follow-up pass. Co-Authored-By: Claude Fable 5 --- README.md | 8 ++- packages/argentina/afip/README.md | 12 ++-- packages/colombia/wompi/README.md | 11 ++-- packages/mexico/conekta/README.md | 11 ++-- packages/payments/inter-bank/README.md | 11 ++-- packages/payments/mercado-pago/README.md | 71 ++++++++++++++++-------- packages/payments/nubank/README.md | 12 ++-- 7 files changed, 88 insertions(+), 48 deletions(-) diff --git a/README.md b/README.md index c261251c..8ec30c30 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,10 @@ Brazil 🇧🇷 · Mexico 🇲🇽 · Argentina 🇦🇷 · Colombia 🇨🇴 · Chile 🇨🇱 · Peru 🇵🇪 · plus 4 agentic payment protocols.

- 110 MCP servers · 2,300 tools · 6 countries · MIT License + 127 MCP servers for LATAM commerce · live in the official MCP Registry · MIT License +

+

+ Live machine-readable count: codespar.dev/api/servers

Catalog · @@ -16,8 +19,7 @@

License: MIT - 110 servers - 2300 tools + Live in the official MCP Registry 6 countries MCP compatible

diff --git a/packages/argentina/afip/README.md b/packages/argentina/afip/README.md index 2c9ea7be..46e7a304 100644 --- a/packages/argentina/afip/README.md +++ b/packages/argentina/afip/README.md @@ -1,9 +1,11 @@ -# MCP AFIP +# @codespar/mcp-afip +> MCP server for **AFIP**, the Argentine tax authority (Administracion Federal de Ingresos Publicos), for electronic invoicing (Factura Electronica) with CAE authorization -> **Alpha release** — published under the `alpha` npm dist-tag. Endpoint paths follow public docs and BACEN/provider conventions but have not been fully live-validated. Pin exact versions during `0.x.x-alpha`. Install with `npm install @alpha`. +[![npm](https://img.shields.io/npm/v/@codespar/mcp-afip)](https://www.npmjs.com/package/@codespar/mcp-afip) +[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT) -MCP server for **AFIP** — Argentine tax authority (Administracion Federal de Ingresos Publicos) for electronic invoicing (Factura Electronica) with CAE authorization. +> **Alpha release** — published under the `alpha` npm dist-tag. Endpoint paths follow public docs and BACEN/provider conventions but have not been fully live-validated. Pin exact versions during `0.x.x-alpha`. Install with `npm install @codespar/mcp-afip@alpha`. ## Quick Start @@ -14,10 +16,10 @@ export AFIP_KEY_PATH="/path/to/key.key" export AFIP_CUIT="20123456789" # Run via stdio -npx tsx packages/argentina/afip/src/index.ts +npx -y @codespar/mcp-afip@alpha # Run via HTTP -npx tsx packages/argentina/afip/src/index.ts --http +MCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-afip@alpha ``` ## Environment Variables diff --git a/packages/colombia/wompi/README.md b/packages/colombia/wompi/README.md index 1cf52d77..e4b05666 100644 --- a/packages/colombia/wompi/README.md +++ b/packages/colombia/wompi/README.md @@ -1,6 +1,9 @@ -# MCP Wompi +# @codespar/mcp-wompi -MCP server for **Wompi** — Colombian payment gateway by Bancolombia, supporting cards, PSE bank transfers, Nequi, and Bancolombia transfers. +> MCP server for **Wompi**, the Colombian payment gateway by Bancolombia, supporting cards, PSE bank transfers, Nequi, and Bancolombia transfers + +[![npm](https://img.shields.io/npm/v/@codespar/mcp-wompi)](https://www.npmjs.com/package/@codespar/mcp-wompi) +[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT) ## Quick Start @@ -11,10 +14,10 @@ export WOMPI_PRIVATE_KEY="prv_test_..." export WOMPI_SANDBOX="true" # Run via stdio -npx tsx packages/colombia/wompi/src/index.ts +npx -y @codespar/mcp-wompi # Run via HTTP -npx tsx packages/colombia/wompi/src/index.ts --http +MCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-wompi ``` ## Environment Variables diff --git a/packages/mexico/conekta/README.md b/packages/mexico/conekta/README.md index 953b805d..9e0888b5 100644 --- a/packages/mexico/conekta/README.md +++ b/packages/mexico/conekta/README.md @@ -1,6 +1,9 @@ -# MCP Conekta +# @codespar/mcp-conekta -MCP server for **Conekta** — the leading Mexican payment gateway supporting cards, OXXO cash payments, and SPEI bank transfers. +> MCP server for **Conekta**, the leading Mexican payment gateway supporting cards, OXXO cash payments, and SPEI bank transfers + +[![npm](https://img.shields.io/npm/v/@codespar/mcp-conekta)](https://www.npmjs.com/package/@codespar/mcp-conekta) +[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT) ## Quick Start @@ -9,10 +12,10 @@ MCP server for **Conekta** — the leading Mexican payment gateway supporting ca export CONEKTA_API_KEY="key_..." # Run via stdio -npx tsx packages/mexico/conekta/src/index.ts +npx -y @codespar/mcp-conekta # Run via HTTP -npx tsx packages/mexico/conekta/src/index.ts --http +MCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-conekta ``` ## Environment Variables diff --git a/packages/payments/inter-bank/README.md b/packages/payments/inter-bank/README.md index 76d0e08a..0ff6b9d1 100644 --- a/packages/payments/inter-bank/README.md +++ b/packages/payments/inter-bank/README.md @@ -1,6 +1,9 @@ -# MCP Banco Inter +# @codespar/mcp-inter-bank -MCP server for **Banco Inter** — Brazilian digital bank with a full developer API for boletos, PIX, transfers, and banking. +> MCP server for **Banco Inter**, a Brazilian digital bank with a full developer API for boletos, PIX, transfers, and banking + +[![npm](https://img.shields.io/npm/v/@codespar/mcp-inter-bank)](https://www.npmjs.com/package/@codespar/mcp-inter-bank) +[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT) ## Quick Start @@ -10,10 +13,10 @@ export INTER_CLIENT_ID="your-client-id" export INTER_CLIENT_SECRET="your-client-secret" # Run via stdio -npx tsx packages/payments/inter-bank/src/index.ts +npx -y @codespar/mcp-inter-bank # Run via HTTP -npx tsx packages/payments/inter-bank/src/index.ts --http +MCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-inter-bank ``` ## Environment Variables diff --git a/packages/payments/mercado-pago/README.md b/packages/payments/mercado-pago/README.md index 61bd85ec..70286389 100644 --- a/packages/payments/mercado-pago/README.md +++ b/packages/payments/mercado-pago/README.md @@ -1,28 +1,49 @@ -# MCP Mercado Pago +# @codespar/mcp-mercado-pago -MCP server for the **Mercado Pago** payment gateway — the leading payment platform in Latin America. +> MCP server for **Mercado Pago**, the leading payment platform in Latin America + +[![npm](https://img.shields.io/npm/v/@codespar/mcp-mercado-pago)](https://www.npmjs.com/package/@codespar/mcp-mercado-pago) +[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT) ## Quick Start +### Claude Desktop + +Add to `~/.config/claude/claude_desktop_config.json`: + +```json +{ + "mcpServers": { + "mercado-pago": { + "command": "npx", + "args": ["-y", "@codespar/mcp-mercado-pago"], + "env": { + "MERCADO_PAGO_ACCESS_TOKEN": "APP_USR-..." + } + } + } +} +``` + +### Claude Code + +```bash +claude mcp add mercado-pago -- npx @codespar/mcp-mercado-pago +``` + +### CLI + ```bash # Set your access token export MERCADO_PAGO_ACCESS_TOKEN="APP_USR-..." # Run via stdio -npx tsx packages/payments/mercado-pago/src/index.ts +npx -y @codespar/mcp-mercado-pago # Run via HTTP -npx tsx packages/payments/mercado-pago/src/index.ts --http +MCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-mercado-pago ``` -## Environment Variables - -| Variable | Required | Description | -|----------|----------|-------------| -| `MERCADO_PAGO_ACCESS_TOKEN` | Yes | Access token from Mercado Pago dashboard | -| `MCP_HTTP` | No | Set to `"true"` to enable HTTP transport | -| `MCP_PORT` | No | HTTP port (default: 3000) | - ## Tools (30) | Tool | Purpose | @@ -47,7 +68,7 @@ npx tsx packages/payments/mercado-pago/src/index.ts --http | `create_store` | Create a store (physical location or POS group) | | `list_stores` | List stores | | `create_pos` | Create a point of sale (POS) linked to a store | -| `update_subscription` | Update a subscription (preapproval) — amount, status, reason, card token, etc. | +| `update_subscription` | Update a subscription (preapproval): amount, status, reason, card token, etc. | | `oauth_token_exchange` | Exchange an authorization code for a seller access token (marketplace onboarding). | | `create_advanced_payment` | Create a marketplace split payment with per-recipient disbursements (application_fee, money_release_days, c... | | `get_advanced_payment` | Get an advanced (split) payment by ID | @@ -58,25 +79,29 @@ npx tsx packages/payments/mercado-pago/src/index.ts --http | `create_settlement_report` | Manually generate a settlement (account money) report for a date range. | | `search_merchant_orders` | Search merchant orders with filters (last 90 days). | -## Auth +## Environment Variables -Uses **Bearer token** authentication. Obtain your access token from the [Mercado Pago Developers](https://www.mercadopago.com.br/developers) dashboard. +| Variable | Required | Description | +|----------|----------|-------------| +| `MERCADO_PAGO_ACCESS_TOKEN` | Yes | Access token from Mercado Pago dashboard | +| `MCP_HTTP` | No | Set to `"true"` to enable HTTP transport | +| `MCP_PORT` | No | HTTP port (default: 3000) | -## API Reference +## Authentication -- [Mercado Pago API Docs](https://www.mercadopago.com.br/developers/en/reference) +Uses **Bearer token** authentication. Set this environment variable before launching the server: -## Enterprise +- `MERCADO_PAGO_ACCESS_TOKEN` *(required, secret)*: access token for Mercado Pago -Need governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers. +Issue credentials at the [Mercado Pago Developers](https://www.mercadopago.com.br/developers) dashboard. -## Authentication +## API Reference -Set these environment variables before launching the server: +- [Mercado Pago API Docs](https://www.mercadopago.com.br/developers/en/reference) -- `MERCADO_PAGO_ACCESS_TOKEN` *(required, secret)* — API key/token for mercado-pago +## Enterprise -Issue credentials at the provider's developer portal: . +Need governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers. ## License diff --git a/packages/payments/nubank/README.md b/packages/payments/nubank/README.md index 21b6ac14..d02ceb0d 100644 --- a/packages/payments/nubank/README.md +++ b/packages/payments/nubank/README.md @@ -1,9 +1,11 @@ -# MCP Nubank +# @codespar/mcp-nubank +> MCP server for **Nubank**, Brazil's largest digital bank, using the Open Finance Brasil standard -> **Alpha release** — published under the `alpha` npm dist-tag. Endpoint paths follow public docs and BACEN/provider conventions but have not been fully live-validated. Pin exact versions during `0.x.x-alpha`. Install with `npm install @alpha`. +[![npm](https://img.shields.io/npm/v/@codespar/mcp-nubank)](https://www.npmjs.com/package/@codespar/mcp-nubank) +[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT) -MCP server for **Nubank** — Brazil's largest digital bank, using the Open Finance Brasil standard. +> **Alpha release** — published under the `alpha` npm dist-tag. Endpoint paths follow public docs and BACEN/provider conventions but have not been fully live-validated. Pin exact versions during `0.x.x-alpha`. Install with `npm install @codespar/mcp-nubank@alpha`. ## Quick Start @@ -14,10 +16,10 @@ export NUBANK_CLIENT_SECRET="your-client-secret" export NUBANK_CERT_PATH="/path/to/certificate.pem" # Run via stdio -npx tsx packages/payments/nubank/src/index.ts +npx -y @codespar/mcp-nubank@alpha # Run via HTTP -npx tsx packages/payments/nubank/src/index.ts --http +MCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-nubank@alpha ``` ## Environment Variables