Sperax Crypto MCP Server Guide

The official MCP server for the Sperax Protocol. Listed on Anthropic's MCP Registry, it enables AI agents to interact with the full Sperax ecosystem on Arbitrum and BNB Chain.

What It Provides

Protocol	Tools	Description
USDs	Mint, redeem, balance, APY	Auto-yield stablecoin (8-25% APY)
SPA	Stake, unstake, balance	Governance token operations
veSPA	Lock, extend, claim	Vote-escrowed SPA for governance power
Demeter Farms	Deposit, withdraw, harvest	Liquidity farming on Arbitrum
Plutus	Browse vaults, deposit, withdraw	Yield vaults on BNB Chain

Quick Start

npx @nirholas/sperax-crypto-mcp

Claude Desktop Config

{
  "mcpServers": {
    "sperax": {
      "command": "npx",
      "args": ["@nirholas/sperax-crypto-mcp"],
      "env": {
        "ARBITRUM_RPC_URL": "https://arb1.arbitrum.io/rpc",
        "BSC_RPC_URL": "https://bsc-dataseed.binance.org"
      }
    }
  }
}

USDs Tools

Mint USDs

Deposit USDC, USDC.e, or USDT to mint USDs:

Tool: mintUSDs
Input: { "collateral": "USDC", "amount": "1000" }
Result: "Minted 999.5 USDs (0.05% mint fee)"

Check USDs APY

Tool: getUSDsAPY
Result: { "currentAPY": "12.4%", "maxCap": "25%", "yieldSource": "Aave, Compound, Stargate" }

Redeem USDs

Burn USDs to receive collateral:

Tool: redeemUSDs
Input: { "amount": "500", "collateral": "USDC" }
Result: "Redeemed 500 USDs for 499.75 USDC"

SPA & veSPA Tools

Stake SPA

Tool: stakeSPA
Input: { "amount": "10000", "lockDuration": "365" }
Result: "Staked 10,000 SPA → received veSPA with 365-day lock"

veSPA Governance Power

Tool: getVeSPABalance
Result: {
  "veSPA": "8500",
  "lockExpiry": "2027-01-15",
  "votingPower": "2.3%",
  "weeklyRewards": "125 SPA"
}

Demeter Farms

List Available Farms

Tool: listFarms
Result: [
  { "pair": "USDs/USDC", "apr": "15.2%", "tvl": "$4.2M" },
  { "pair": "SPA/ETH", "apr": "42.8%", "tvl": "$1.8M" },
  { "pair": "USDs/FRAX", "apr": "18.5%", "tvl": "$2.1M" }
]

Deposit to Farm

Tool: depositToFarm
Input: { "farm": "USDs/USDC", "amount": "5000" }
Result: "Deposited 5,000 LP tokens to USDs/USDC farm"

Plutus Vaults (BNB Chain)

Vault	Strategy	Target APY
plvHEDGE	Delta-neutral hedging	10-20%
plvLOOP	Leveraged looping	15-30%
plvDOLO	Dollar-denominated	8-15%

Key Contract Addresses

Arbitrum One

Contract	Address
USDs Token	0xD74f5255D557944cf7Dd0E45FF521520002D5748
SPA Token	0x5575552988A3A80504bBaeB1311674fCFd40aD4B
veSPA	0x2e2071180682Ce6C247B1eF93d382D509F5F6a17

Agent Workflow Examples

Yield Optimizer

1. Agent checks current USDs APY
2. Compares with farm APYs
3. Recommends optimal allocation (hold USDs vs farm)
4. Executes approved rebalancing

Governance Participant

1. Agent monitors active proposals
2. Summarizes proposals for user
3. Calculates voting power from veSPA
4. Casts vote when instructed

Links

• GitHub: https://github.com/nirholas/sperax-crypto-mcp
• Anthropic MCP Registry: https://registry.modelcontextprotocol.io
• Sperax Docs: https://docs.chat.sperax.io
• Sperax App: https://app.sperax.io