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

Variable	Required	Description
`CRESIUM_API_KEY`	Yes	Partner API key
`CRESIUM_SECRET`	Yes	Partner secret for HMAC signing
`CRESIUM_COMPANY_ID`	Yes	Company ID to operate on

Available Tools

Tool	Description
`health_check`	Check API availability
`get_balance`	Get wallet balances (balance, locked, invested, available)
`search_transactions`	Search transactions with filters and pagination
`get_transaction`	Get a single transaction by ID
`lookup_bank_address`	Look up a CBU/CVU/alias to get the address ID
`create_transfer_preview`	Create a transfer preview (does not execute)
`confirm_transaction`	Confirm a previewed transaction
`create_signature_request`	Request signer approval for a transaction
`create_payments`	Create payments (accounts payable)
`create_invoices`	Create invoices (accounts receivable)
`list_payments`	List all company payments
`list_invoices`	List all company invoices

Typical Workflow

Send a transfer

Look up the destination: lookup_bank_address with the CBU/CVU/alias
Create a preview: create_transfer_preview with the address ID, amount, and currency
Request approval: create_signature_request with the transaction ID (signers approve from Dashboard)

Check balances and transactions

Get balances: get_balance to see available funds per currency
Search transactions: search_transactions with date or status filters
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

Cresium MCP Server

Cresium MCP Server

Prerequisites

Installation

Claude Code

Claude Desktop

Build from source

Environment Variables

Available Tools

Typical Workflow

Send a transfer

Check balances and transactions

Authentication

License

Reviews