io.github.codespar/mcp-cobre MCP Server

MCP server for Cobre that supports Colombian/Mexican B2B treasury and payouts. It provides balance visibility, counterparty registration, and outbound money movements over Colombia’s instant rails and Mexico’s SPEI. Topics include payments, open finance, PIX, and MCP for llm-tools and agentic-commerce.

🛠️ Key Features

Balance visibility for treasury
Counterparty registration
Outbound money movements via Colombia (instant rails) and Mexico (SPEI)
Implements Model Context Protocol (MCP)

🚀 Use Cases

B2B treasury management for CO/MX operations
Payout workflows integrating with Colombia’s and Mexico’s payment rails
Registration and use of counterparties for money movement

⚡ Developer Benefits

OAuth2 client credentials authentication (POST /v1/auth)
Access token caching and refresh before expiry
Developer-oriented integration with MCP and llm-tools ecosystems

⚠️ Limitations

Server functionality described only at a high level (balance visibility, counterparties, outbound movements); specific tools and endpoints beyond auth are not included in the provided excerpt.

@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:

json

{
  "mcpServers": {
    "cobre": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-cobre"],
      "env": {
        "COBRE_USER_ID": "your-user-id",
        "COBRE_SECRET": "your-secret"
      }
    }
  }
}

Claude Code

bash

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

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

Variable

Required

Description

COBRE_USER_ID

yes

API credential user id

COBRE_SECRET

yes

API credential secret

COBRE_BASE_URL

Override the API host (default https://api.cobre.co)

Install

Configuration

Environment variables

COBRE_USER_IDrequired

Cobre API credential user id

COBRE_SECRETrequiredsecret

Cobre API credential secret

COBRE_BASE_URL

Override the API host. Defaults to https://api.cobre.co.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-cobre": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-cobre@0.1.0"
      ],
      "env": {
        "COBRE_USER_ID": "<YOUR_COBRE_USER_ID>",
        "COBRE_SECRET": "<YOUR_COBRE_SECRET>",
        "COBRE_BASE_URL": "<YOUR_COBRE_BASE_URL>"
      }
    }
  }
}

io.github.codespar/mcp-cobre