nirholas 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
- Agent checks current USDs APY
- Compares with farm APYs
- Recommends optimal allocation (hold USDs vs farm)
- Executes approved rebalancing
Governance Participant
- Agent monitors active proposals
- Summarizes proposals for user
- Calculates voting power from veSPA
- 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