Sperax Protocol MCP β USDs stablecoin, SPA, veSPA governance & Demeter DeFi on Arbitrum
Copy the AI prompt to install this server into Claude Code, Cursor, or another agent β or use 1-click editor setup below.
π‘ Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Model Context Protocol Server for Sperax DeFi Ecosystem
Enable AI agents to interact with USDs (auto-yield stablecoin), SPA governance, veSPA staking, and Demeter yield farms, and Plutus on BNB Chain and Arbitrum.
Add to your claude_desktop_config.json:
Config file locations:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json~/.config/claude/claude_desktop_config.jsonAdd to your MCP settings:
For better performance and reliability, use your own Arbitrum RPC:
For advanced integrations, run as an HTTP server:
For best compatability, use within SperaxOS. The servers provided in this repo largely are based upon the already built and tested products on app.sperax.io. The Sperax Crypto and Defi MCP Server project is an additional product of Sperax and SperaxOS, created for the open source community. For the millions of developers that may not have had the tools available to use cryptocurrency, blockchain, defi, and web3 tools within their usual workspace, we are thrilled to be laying the groundworks for the use of blockchain and cryptocurrency use paired with the Model Context Protocol. Sperax is building an autonomous financial infrastructure, centered around its auto-yield stablecoin USDs and its utility/governance token SPA, using AI-driven agents to automate yield generation and financial management across blockchains like Arbitrum and BNB Chain. It combines collateralized stability with algorithmic mechanisms, aiming to offer passive income for users through its integrated system, which includes the SperaxOS AI infrastructure. SperaxOS is the world's first AI-native operating system for decentralized finance, transforming how enterprises, developers, and DeFi protocols manage on-chain capital. SperaxOS replaces manual DeFi workflows with autonomous, intelligent automation. While traditional AI agents generate content or answer questions, SperaxOS agents execute capital, automatically optimizing yields, rebalancing portfolios, defending against risks, and managing treasury operations 24/7 with zero human intervention. This repo will initially focus on Sperax ecosystem products such as USDs and SPA. For organizational purposes, SperaxOS documents and tools are seperated in their respective repositories.
| Tool | Description |
|---|---|
usds_get_info | Get USDs overview including supply, APR, and last rebase time |
usds_get_balance | Get USDs balance and rebase state for any address |
usds_get_rebase_state | Check if an address receives yield rebases |
usds_get_mint_params | Get current mint fees and parameters |
usds_get_yield_info | Get current yield metrics, APR, and distribution |
usds_get_collateral_ratio | Get protocol collateralization ratio |
usds_estimate_mint | Simulate minting USDs with specific collateral |
| Tool | Description |
|---|---|
vault_get_status | Get Vault TVL, health status, utilization, and fees |
vault_get_collaterals | List all supported collaterals with current allocations |
vault_get_collateral_details | Get detailed info for specific collateral (USDC, USDT, DAI, FRAX) |
vault_get_strategies | List all active yield strategies and their performance |
vault_get_strategy_details | Get specific strategy allocation and APY |
vault_get_oracle_prices | Get all collateral oracle prices from Chainlink |
vault_get_peg_status | Check USDs peg health and deviation from $1 |
vault_simulate_mint | Simulate mint with fees and expected output |
vault_simulate_redeem | Simulate redemption with fees and slippage |
vault_get_allocation_targets | Get target vs actual collateral allocations |
| Tool | Description |
|---|---|
spa_get_info | Get SPA token overview including supply and staking stats |
spa_get_balance | Get SPA, veSPA, and xSPA balances for address |
vespa_get_position | Get veSPA lock position details and voting power |
vespa_calculate_power | Calculate voting power for specific lock amount/duration |
vespa_get_stats | Get global veSPA statistics (total locked, holders) |
xspa_get_position | Get xSPA vesting position and pending redemptions |
xspa_calculate_redemption | Calculate SPA output for xSPA redemption |
buyback_get_stats | Get SPA buyback & burn statistics |
| Tool | Description |
|---|---|
demeter_list_farms | List all active farms with APR, TVL, and filters |
demeter_get_farm_details | Get specific farm detailed info and mechanics |
demeter_get_user_position | Get user's positions across all Demeter farms |
demeter_calculate_rewards | Calculate pending rewards for user in farm |
demeter_estimate_apr | Estimate APR for specific deposit amount |
demeter_get_top_farms | Get highest APR farms with optional filters |
demeter_get_farm_types | Get supported farm types (UniV3, Camelot, Balancer) |
| Tool | Description |
|---|---|
dripper_get_status | Get Dripper operational status and health |
dripper_get_balance | Get pending yield balance waiting to be distributed |
dripper_get_config | Get drip period and distribution configuration |
dripper_estimate_next_rebase | Estimate next rebase time and expected amount |
dripper_calculate_earnings | Calculate projected earnings for USDs holdings |
| Tool | Description |
|---|---|
oracle_get_all_prices | Get all collateral prices from Chainlink oracles |
oracle_get_price | Get specific asset price with timestamp |
oracle_check_staleness | Check if oracle data is fresh (within heartbeat) |
oracle_check_deviation | Check price deviation from $1 peg |
oracle_get_sources | Get oracle source information and configuration |
| Tool | Description |
|---|---|
analytics_get_tvl | Get Total Value Locked breakdown by component |
analytics_get_revenue | Get protocol revenue metrics and trends |
analytics_get_apy_history | Get historical APY data (7d, 30d, 90d, 1y) |
analytics_get_user_stats | Get comprehensive user statistics |
analytics_compare_yields | Compare USDs yields with competitors (Aave, Compound) |
analytics_get_protocol_health | Get overall protocol health score and indicators |
| Tool | Description |
|---|---|
governance_get_overview | Get governance overview and current state |
governance_get_proposals | List recent/active governance proposals |
governance_get_proposal_details | Get specific proposal details and voting status |
governance_get_voting_power | Get voting power for address (veSPA-based) |
governance_get_delegates | Get delegation information for address |
| Tool | Description |
|---|---|
yield_reserve_get_status | Get yield reserve status and balance |
yield_reserve_get_balance | Get available yield for distribution |
yield_reserve_get_config | Get reserve configuration parameters |
yield_reserve_get_history | Get historical yield collection data |
No reviews yet β be the first to share how this listing worked for you.
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
[](https://allmcps.com/mcp/speraxos)<a href="https://allmcps.com/mcp/speraxos"><img src="https://allmcps.com/api/badge/speraxos?style=directory" alt="SperaxOS on AllMCPs" /></a>