Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,10 @@
<em>Brazil 🇧🇷 · Mexico 🇲🇽 · Argentina 🇦🇷 · Colombia 🇨🇴 · Chile 🇨🇱 · Peru 🇵🇪 · plus 4 agentic payment protocols.</em>
</p>
<p align="center">
110 MCP servers · 2,300 tools · 6 countries · MIT License
127 MCP servers for LATAM commerce · live in the official MCP Registry · MIT License
</p>
<p align="center">
<em>Live machine-readable count: <a href="https://codespar.dev/api/servers">codespar.dev/api/servers</a></em>
</p>
<p align="center">
<a href="https://codespar.dev/servers">Catalog</a> ·
Expand All @@ -16,8 +19,7 @@
</p>
<p align="center">
<a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
<img src="https://img.shields.io/badge/servers-110-green" alt="110 servers">
<img src="https://img.shields.io/badge/tools-2,300-orange" alt="2300 tools">
<img src="https://img.shields.io/badge/MCP_Registry-live-green" alt="Live in the official MCP Registry">
<img src="https://img.shields.io/badge/countries-6-blue" alt="6 countries">
<img src="https://img.shields.io/badge/MCP-compatible-purple" alt="MCP compatible">
</p>
Expand Down
12 changes: 7 additions & 5 deletions packages/argentina/afip/README.md
Original file line number Diff line number Diff line change
@@ -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 <pkg>@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

Expand All @@ -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
Expand Down
11 changes: 7 additions & 4 deletions packages/colombia/wompi/README.md
Original file line number Diff line number Diff line change
@@ -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

Expand All @@ -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
Expand Down
11 changes: 7 additions & 4 deletions packages/mexico/conekta/README.md
Original file line number Diff line number Diff line change
@@ -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

Expand All @@ -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
Expand Down
11 changes: 7 additions & 4 deletions packages/payments/inter-bank/README.md
Original file line number Diff line number Diff line change
@@ -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

Expand All @@ -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
Expand Down
71 changes: 48 additions & 23 deletions packages/payments/mercado-pago/README.md
Original file line number Diff line number Diff line change
@@ -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 |
Expand All @@ -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 |
Expand All @@ -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: <https://www.mercadopago.com.br/developers>.
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

Expand Down
12 changes: 7 additions & 5 deletions packages/payments/nubank/README.md
Original file line number Diff line number Diff line change
@@ -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 <pkg>@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

Expand All @@ -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
Expand Down
Loading