Cresium MCP Server

MCP (Model Context Protocol) server the Cresium API. Enables AI tools like Claude Code and Claude Desktop to manage transactions, payments, invoices, and balances through the Cresium Partner API (V3).

Prerequisites

You need a Cresium partner account with:

• API Key (apiKey)

• Secret (secret)

• Company ID (companyId)

These are available from the Cresium Dashboard under your partner settings.

Installation

Claude Code

claude mcp add cresium-server \
  -e CRESIUM_API_KEY=your_api_key \
  -e CRESIUM_SECRET=your_secret \
  -e CRESIUM_COMPANY_ID=your_company_id \
  -- node /absolute/path/to/cresium-mcp-server/build/index.js

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "cresium": {
      "command": "node",
      "args": ["/absolute/path/to/cresium-mcp-server/build/index.js"],
      "env": {
        "CRESIUM_API_KEY": "your_api_key",
        "CRESIUM_SECRET": "your_secret",
        "CRESIUM_COMPANY_ID": "your_company_id"
      }
    }
  }
}

Build from source

git clone <repo-url>
cd cresium-mcp-server
npm install
npm run build

Environment Variables

Available Tools

Typical Workflow

Send a transfer

1. Look up the destination: lookup_bank_address with the CBU/CVU/alias

2. Create a preview: create_transfer_preview with the address ID, amount, and currency

3. Request approval: create_signature_request with the transaction ID (signers approve from Dashboard)

Check balances and transactions

1. Get balances: get_balance to see available funds per currency

2. Search transactions: search_transactions with date or status filters

3. Get details: get_transaction with a specific transaction ID

Authentication

All requests are signed using HMAC-SHA256. The server handles this transparently:

signature = HMAC-SHA256("{timestamp}|{METHOD}|{path}|{body}", secret) → base64

Headers sent on every request: x-api-key, x-company-id, x-timestamp, x-signature

License

MIT