# mcp-cobre

Connects Cobre to an AI coding client for balances, counterparties, and outbound money movements across Colombia and Mexico.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/colombia/cobre
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-cobre

## What it does

mcp-cobre gives an agent access to Cobre treasury operations. It can read account balances, register and inspect payout counterparties, create outbound movements, and check their status. Transfers use Colombia’s instant rails or Mexico’s SPEI system.

The server provides eight tools covering balances, counterparties, and money movements. Authentication uses OAuth2 client credentials; the access token is cached and refreshed before it expires. Without `COBRE_USER_ID` and `COBRE_SECRET`, authentication cannot complete. Set `COBRE_BASE_URL` when the API host needs to be overridden.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `COBRE_USER_ID`, `COBRE_SECRET`, `COBRE_BASE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env COBRE_USER_ID=<COBRE_USER_ID> --env COBRE_SECRET=<COBRE_SECRET> --env COBRE_BASE_URL=<COBRE_BASE_URL> --transport stdio cobre -- npx -y @codespar/mcp-cobre
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add cobre --env COBRE_USER_ID=<COBRE_USER_ID> --env COBRE_SECRET=<COBRE_SECRET> --env COBRE_BASE_URL=<COBRE_BASE_URL> -- npx -y @codespar/mcp-cobre
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cobre": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-cobre"
            ],
            "env": {
                "COBRE_USER_ID": "<COBRE_USER_ID>",
                "COBRE_SECRET": "<COBRE_SECRET>",
                "COBRE_BASE_URL": "<COBRE_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cobre": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-cobre"
            ],
            "env": {
                "COBRE_USER_ID": "<COBRE_USER_ID>",
                "COBRE_SECRET": "<COBRE_SECRET>",
                "COBRE_BASE_URL": "<COBRE_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e COBRE_USER_ID=<COBRE_USER_ID> -e COBRE_SECRET=<COBRE_SECRET> -e COBRE_BASE_URL=<COBRE_BASE_URL> cobre npx -y @codespar/mcp-cobre
```
Replace <…> with your own values

## When to use it
- read balances for visible accounts
- register a payout beneficiary
- inspect a counterparty by ID
- create an outbound money movement
- check a transfer status

## Example prompts
- Show the balances for every visible Cobre account.
- Register a payout counterparty for a Colombian bank account.
- Create an outbound movement and check its status.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md