@codespar/mcp-foxbit

@codespar/mcp-foxbit

MCP server for Foxbit — Brazilian cryptocurrency exchange with trading, orderbook, and market data

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "foxbit": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-foxbit"],
      "env": {
        "FOXBIT_API_KEY": "your-key",
        "FOXBIT_API_SECRET": "your-secret"
      }
    }
  }
}

Claude Code

claude mcp add foxbit -- npx @codespar/mcp-foxbit

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

{
  "servers": {
    "foxbit": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-foxbit"],
      "env": {
        "FOXBIT_API_KEY": "your-key",
        "FOXBIT_API_SECRET": "your-secret"
      }
    }
  }
}

Tools

Tool	Description
list_markets	List all available trading pairs
get_ticker	Get 24h ticker data for a market
get_orderbook	Get order book for a market
get_account_balances	Get account balances
create_order	Create a buy or sell order (limit/market)
get_order	Get order details by ID
list_orders	List orders with filters
cancel_order	Cancel an open order
list_trades	List executed trades
list_deposits_withdrawals	List deposits and withdrawals for a currency

Authentication

Foxbit uses HMAC-SHA256 request signing. Each request includes three headers:

• X-FB-ACCESS-KEY — API key
• X-FB-ACCESS-TIMESTAMP — UNIX timestamp in milliseconds
• X-FB-ACCESS-SIGNATURE — hex HMAC-SHA256 of timestamp + method + path + queryString + body using API secret

Base URL: https://api.foxbit.com.br/rest/v3

Get your credentials

• Go to Foxbit
• Create an account (KYC required for Brazilian residents)
• Navigate to API settings to generate key and secret
• Set the environment variables

Environment Variables

Variable	Required	Description
FOXBIT_API_KEY	Yes	API key from Foxbit
FOXBIT_API_SECRET	Yes	API secret for HMAC-SHA256

Brazilian Crypto Exchanges in CodeSpar

Hedge liquidity across multiple BR venues:

• Mercado Bitcoin — biggest BR exchange, 200+ tokens, deep altcoin coverage
• Foxbit (this) — 2nd BR exchange, focus on BTC / ETH / LTC, strong institutional desk

Merchants and traders use both for best execution and redundancy.

Roadmap

v0.2 (planned)

• get_candles — OHLCV candlestick data
• create_withdrawal — Initiate crypto/PIX withdrawal
• list_currencies — Available currencies and networks
• get_fees — Trading fees for account tier
• create_stop_order — Stop-limit / stop-market orders

v0.3 (planned)

• Institutional / OTC desk integrations
• WebSocket market data streams (where MCP transport allows)

Want to contribute? Open a PR or request a tool.

Links

• Foxbit Website
• Foxbit API Documentation
• MCP Dev Brasil
• Landing Page

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT