About mcp-cobre
mcp-cobre is an MCP server for Cobre, a B2B treasury and payouts platform in Colombia and Mexico. It lets clients check balances, register payout beneficiaries, and send outbound payments over Colombia's instant rails or Mexico's SPEI.
Key features
- 01List balances across all visible accounts
- 02Register payout beneficiaries by bank account or CLABE
- 03Create outbound payments and check their status
- 04List counterparties and money movements
- 05OAuth2 client credentials with cached access tokens
Use cases
- 01Have an AI assistant review account balances
- 02Register supplier beneficiaries through an agent
- 03Track the status of Colombian or Mexican payouts
MCP support
The server exposes eight tools to MCP clients for reading balances, managing counterparties, and creating and querying money movements.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @codespar/mcp-cobreCOBRE_USER_IDCobre API credential user idCOBRE_SECRETSecretCobre API credential secretCOBRE_BASE_URLOverride the API host. Defaults to https://api.cobre.co.Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
8Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| page | number | No | Page number |
| per_page | number | No | Page size |
Details
From the project README@codespar/mcp-cobre
MCP server for Cobre — Colombian/Mexican B2B treasury and payouts platform: balance visibility, counterparty registration, and outbound money movements over Colombia's instant rails and Mexico's SPEI.
Auth is OAuth2 client credentials (POST /v1/auth); the server caches the access token and refreshes before expiry.
Quick Start
Claude Desktop
Add to ~/.config/claude/claude_desktop_config.json:
{
"mcpServers": {
"cobre": {
"command": "npx",
"args": ["-y", "@codespar/mcp-cobre"],
"env": {
"COBRE_USER_ID": "your-user-id",
"COBRE_SECRET": "your-secret"
}
}
}
}
Claude Code
claude mcp add cobre --env COBRE_USER_ID=uid --env COBRE_SECRET=sk -- npx -y @codespar/mcp-cobre
Tools (8)
| Tool | Description |
|---|---|
list_balances | Balances across every visible account |
get_balance | One balance by id |
create_counterparty | Register a payout beneficiary (CO bank account or MX CLABE) |
list_counterparties | List registered counterparties |
get_counterparty | One counterparty by id |
create_money_movement | Create an outbound payout (instant rails / SPEI) |
get_money_movement | Movement status by id |
list_money_movements | List movements |
Environment
| Variable | Required | Description |
|---|---|---|
COBRE_USER_ID | yes | API credential user id |
COBRE_SECRET | yes | API credential secret |
COBRE_BASE_URL | no | Override the API host (default https://api.cobre.co) |
Docs
- Provider docs: https://docs.cobre.co
- Managed tier (one interface across every LATAM provider, governance + audit): https://codespar.dev/agents
Enterprise
Need governance, budget limits, and audit trails for agent-driven payments on Cobre? CodeSpar Enterprise adds a policy engine, payment routing, and compliance templates on top of these MCP servers.
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.