Sera MCP Server

Sera MCP Server

A Model Context Protocol (MCP) server for Sera — the stablecoin exchange platform. Enables AI assistants like Claude to query market data, check balances, execute swaps, and manage orders through natural language.

Features

• Market Data — Real-time stablecoin prices, metadata, and historical data
• Wallet Management — Check balances, token holdings, and exchange deposits
• Trading — Get quotes and execute swaps with automatic token approval
• Order Management — Place, view, and cancel limit orders
• Deposit & Withdraw — Move funds between wallet and exchange
• Multi-Network — Supports Ethereum mainnet and Sepolia testnet

Quick Start

cd sera-mcp
npm install
npm run build

Then add the server to your Claude Desktop config. See claude_desktop_config.example.json:

{
  "mcpServers": {
    "sera": {
      "command": "node",
      "args": ["/path/to/sera-mcp/dist/index.js"],
      "env": {
        "EXTERNAL_API_URL": "https://api.dev.sera.cx",
        "WALLET_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY",
        "RPC_URL": "https://ethereum-sepolia-rpc.publicnode.com"
      }
    }
  }
}

Config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Restart Claude Desktop after editing the config.

Mainnet Configuration

{
  "env": {
    "EXTERNAL_API_URL": "https://api.sera.cx",
    "WALLET_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY",
    "RPC_URL": "https://eth.llamarpc.com"
  }
}

Configuration

⚠️ Security Warning: Never share or commit your WALLET_PRIVATE_KEY. Use a dedicated wallet for testing with limited funds.

Available Tools

Market Data

Wallet & Balance

Trading

Order Management

Deposit & Withdraw

Example Prompts

Once configured, you can interact with Sera using natural language:

Key Behaviors

1. Human-readable amounts: All amount inputs (swap, deposit, withdraw) accept human-readable values like "100". The server automatically converts to raw units (e.g., 100000000 for 6-decimal tokens) using token decimals fetched from the API.

2. Automatic token approval: execute_swap automatically checks if the input token has sufficient allowance for the SOR contract. If not (e.g., USDT which doesn't support EIP-2612 permit), it sends an on-chain approve(spender, maxUint256) transaction, waits for confirmation, refreshes the quote, then proceeds with the swap.

3. EIP-712 signing: Swap intents are signed using EIP-712 typed data (Intent type) with the Sera domain. The uuid field in route_params is a decimal big integer, not a UUID string.

4. Authenticated endpoints: get_wallet_balances, get_open_orders, and get_exchange_balance default to the configured wallet address. If a different wallet_address is provided, they return an info message instead of failing with 403.

5. No-liquidity handling: When the API returns a no_liquidity error (HTTP 400), the server returns a structured { status: "no_liquidity" } response instead of a generic error.

6. Testnet vs Mainnet: Use EXTERNAL_API_URL=https://api.dev.sera.cx for testnet (Sepolia) or https://api.sera.cx for mainnet. The RPC URL must match the chain.

Development

# Run in dev mode with hot reload
EXTERNAL_API_URL=https://api.dev.sera.cx \
WALLET_PRIVATE_KEY=0x... \
npm run dev

License

MIT

Built for Sera 🌐