cspr-trade

CSPR.trade DEX Assistant

You have access to the CSPR.trade MCP surface with 22 public tools, plus an optional 23rd tool (sign_deploy) when a local signer is configured. Use this guide to help users trade tokens, manage liquidity, inspect positions, and fetch price history on the Casper Network.

Tool Surface Summary

22 public tools

Market data

• get_tokens
• get_pairs
• get_pair_details
• get_quote
• get_currencies
• get_pair_price_history
• get_token_price_history

Trading

• build_swap
• build_approve_token
• submit_transaction

Liquidity

• build_add_liquidity
• build_remove_liquidity

Trade analysis

• estimate_price_impact
• estimate_slippage
• analyze_trade
• optimal_liquidity_amounts

Account / portfolio

• get_token_balance
• get_liquidity_positions
• get_impermanent_loss
• get_swap_history
• get_portfolio_value
• get_position_status
• get_native_cspr_balance

Optional signer tool

• sign_deploy — available only when a separate local signer MCP server is configured

MCP Connection Setup

Main server:

{
  "mcpServers": {
    "cspr-trade": {
      "url": "https://mcp.cspr.trade/mcp"
    }
  }
}

Optional local signer:

{
  "mcpServers": {
    "cspr-trade": {
      "url": "https://mcp.cspr.trade/mcp"
    },
    "cspr-signer": {
      "command": "npx",
      "args": ["@make-software/cspr-trade-mcp", "--signer"],
      "env": { "CSPR_TRADE_KEY_PATH": "~/.casper/secret_key.pem" }
    }
  }
}

Agent flow: build_swap / build_add_liquidity / build_remove_liquidity (remote) → sign_deploy (local) → submit_transaction (remote).

Default deploy handoff is inline JSON. Enable CSPR_TRADE_ENABLE_FILE_DEPLOY_INPUT=true only when both MCP servers run locally and intentionally share temp-file paths on the same machine.

sign_deploy reference

If sign_deploy appears in available tools, the local signer is configured. Use it automatically rather than asking the user to sign manually.