
SperaxOS
Connects Claude to the Sperax DeFi ecosystem on Arbitrum and BNB Chain. You get 42 tools across five categories: USDs stablecoin operations (balance checks, mint simulations, rebase state), vault and collateral management (TVL, strategies, oracle prices), SPA governance and veSPA voting power calculations, Demeter yield farm queries with APR estimates, and Dripper yield distribution monitoring. The tools are read-only, pulling live data from on-chain contracts via RPC. Useful if you're building interfaces for Sperax products, analyzing yield opportunities across their farms, or need to query veSPA positions and voting power without writing contract calls yourself. Ships as an npm package with both stdio and HTTP server modes.
- GitHub stars
- 16
- tools
- 63
- last updated
- Jan 7, 2026
Tools
63 toolsPublic tool metadata for what this MCP can expose to an agent.
usds_get_infoGet USDs overview including supply, APR, and last rebase time
Get USDs overview including supply, APR, and last rebase time
No parameter schema in public metadata yet.
usds_get_balanceGet USDs balance and rebase state for any address
Get USDs balance and rebase state for any address
No parameter schema in public metadata yet.
usds_get_rebase_stateCheck if an address receives yield rebases
Check if an address receives yield rebases
No parameter schema in public metadata yet.
usds_get_mint_paramsGet current mint fees and parameters
Get current mint fees and parameters
No parameter schema in public metadata yet.
usds_get_yield_infoGet current yield metrics, APR, and distribution
Get current yield metrics, APR, and distribution
No parameter schema in public metadata yet.
usds_get_collateral_ratioGet protocol collateralization ratio
Get protocol collateralization ratio
No parameter schema in public metadata yet.
usds_estimate_mintSimulate minting USDs with specific collateral
Simulate minting USDs with specific collateral
No parameter schema in public metadata yet.
vault_get_statusGet Vault TVL, health status, utilization, and fees
Get Vault TVL, health status, utilization, and fees
No parameter schema in public metadata yet.
vault_get_collateralsList all supported collaterals with current allocations
List all supported collaterals with current allocations
No parameter schema in public metadata yet.
vault_get_collateral_detailsGet detailed info for specific collateral (USDC, USDT, DAI, FRAX)
Get detailed info for specific collateral (USDC, USDT, DAI, FRAX)
No parameter schema in public metadata yet.
vault_get_strategiesList all active yield strategies and their performance
List all active yield strategies and their performance
No parameter schema in public metadata yet.
vault_get_strategy_detailsGet specific strategy allocation and APY
Get specific strategy allocation and APY
No parameter schema in public metadata yet.
vault_get_oracle_pricesGet all collateral oracle prices from Chainlink
Get all collateral oracle prices from Chainlink
No parameter schema in public metadata yet.
vault_get_peg_statusCheck USDs peg health and deviation from $1
Check USDs peg health and deviation from $1
No parameter schema in public metadata yet.
vault_simulate_mintSimulate mint with fees and expected output
Simulate mint with fees and expected output
No parameter schema in public metadata yet.
vault_simulate_redeemSimulate redemption with fees and slippage
Simulate redemption with fees and slippage
No parameter schema in public metadata yet.
vault_get_allocation_targetsGet target vs actual collateral allocations
Get target vs actual collateral allocations
No parameter schema in public metadata yet.
spa_get_infoGet SPA token overview including supply and staking stats
Get SPA token overview including supply and staking stats
No parameter schema in public metadata yet.
spa_get_balanceGet SPA, veSPA, and xSPA balances for address
Get SPA, veSPA, and xSPA balances for address
No parameter schema in public metadata yet.
vespa_get_positionGet veSPA lock position details and voting power
Get veSPA lock position details and voting power
No parameter schema in public metadata yet.
vespa_calculate_powerCalculate voting power for specific lock amount/duration
Calculate voting power for specific lock amount/duration
No parameter schema in public metadata yet.
vespa_get_statsGet global veSPA statistics (total locked, holders)
Get global veSPA statistics (total locked, holders)
No parameter schema in public metadata yet.
xspa_get_positionGet xSPA vesting position and pending redemptions
Get xSPA vesting position and pending redemptions
No parameter schema in public metadata yet.
xspa_calculate_redemptionCalculate SPA output for xSPA redemption
Calculate SPA output for xSPA redemption
No parameter schema in public metadata yet.
buyback_get_statsGet SPA buyback & burn statistics
Get SPA buyback & burn statistics
No parameter schema in public metadata yet.
demeter_list_farmsList all active farms with APR, TVL, and filters
List all active farms with APR, TVL, and filters
No parameter schema in public metadata yet.
demeter_get_farm_detailsGet specific farm detailed info and mechanics
Get specific farm detailed info and mechanics
No parameter schema in public metadata yet.
demeter_get_user_positionGet user's positions across all Demeter farms
Get user's positions across all Demeter farms
No parameter schema in public metadata yet.
demeter_calculate_rewardsCalculate pending rewards for user in farm
Calculate pending rewards for user in farm
No parameter schema in public metadata yet.
demeter_estimate_aprEstimate APR for specific deposit amount
Estimate APR for specific deposit amount
No parameter schema in public metadata yet.
demeter_get_top_farmsGet highest APR farms with optional filters
Get highest APR farms with optional filters
No parameter schema in public metadata yet.
demeter_get_farm_typesGet supported farm types (UniV3, Camelot, Balancer)
Get supported farm types (UniV3, Camelot, Balancer)
No parameter schema in public metadata yet.
dripper_get_statusGet Dripper operational status and health
Get Dripper operational status and health
No parameter schema in public metadata yet.
dripper_get_balanceGet pending yield balance waiting to be distributed
Get pending yield balance waiting to be distributed
No parameter schema in public metadata yet.
dripper_get_configGet drip period and distribution configuration
Get drip period and distribution configuration
No parameter schema in public metadata yet.
dripper_estimate_next_rebaseEstimate next rebase time and expected amount
Estimate next rebase time and expected amount
No parameter schema in public metadata yet.
dripper_calculate_earningsCalculate projected earnings for USDs holdings
Calculate projected earnings for USDs holdings
No parameter schema in public metadata yet.
oracle_get_all_pricesGet all collateral prices from Chainlink oracles
Get all collateral prices from Chainlink oracles
No parameter schema in public metadata yet.
oracle_get_priceGet specific asset price with timestamp
Get specific asset price with timestamp
No parameter schema in public metadata yet.
oracle_check_stalenessCheck if oracle data is fresh (within heartbeat)
Check if oracle data is fresh (within heartbeat)
No parameter schema in public metadata yet.
oracle_check_deviationCheck price deviation from $1 peg
Check price deviation from $1 peg
No parameter schema in public metadata yet.
oracle_get_sourcesGet oracle source information and configuration
Get oracle source information and configuration
No parameter schema in public metadata yet.
analytics_get_tvlGet Total Value Locked breakdown by component
Get Total Value Locked breakdown by component
No parameter schema in public metadata yet.
analytics_get_revenueGet protocol revenue metrics and trends
Get protocol revenue metrics and trends
No parameter schema in public metadata yet.
analytics_get_apy_historyGet historical APY data (7d, 30d, 90d, 1y)
Get historical APY data (7d, 30d, 90d, 1y)
No parameter schema in public metadata yet.
analytics_get_user_statsGet comprehensive user statistics
Get comprehensive user statistics
No parameter schema in public metadata yet.
analytics_compare_yieldsCompare USDs yields with competitors (Aave, Compound)
Compare USDs yields with competitors (Aave, Compound)
No parameter schema in public metadata yet.
analytics_get_protocol_healthGet overall protocol health score and indicators
Get overall protocol health score and indicators
No parameter schema in public metadata yet.
governance_get_overviewGet governance overview and current state
Get governance overview and current state
No parameter schema in public metadata yet.
governance_get_proposalsList recent/active governance proposals
List recent/active governance proposals
No parameter schema in public metadata yet.
governance_get_proposal_detailsGet specific proposal details and voting status
Get specific proposal details and voting status
No parameter schema in public metadata yet.
governance_get_voting_powerGet voting power for address (veSPA-based)
Get voting power for address (veSPA-based)
No parameter schema in public metadata yet.
governance_get_delegatesGet delegation information for address
Get delegation information for address
No parameter schema in public metadata yet.
yield_reserve_get_statusGet yield reserve status and balance
Get yield reserve status and balance
No parameter schema in public metadata yet.
yield_reserve_get_balanceGet available yield for distribution
Get available yield for distribution
No parameter schema in public metadata yet.
yield_reserve_get_configGet reserve configuration parameters
Get reserve configuration parameters
No parameter schema in public metadata yet.
yield_reserve_get_historyGet historical yield collection data
Get historical yield collection data
No parameter schema in public metadata yet.
get_sperax_priceGet SPA token price
Get SPA token price
No parameter schema in public metadata yet.
get_usds_infoGet USDs stablecoin info
Get USDs stablecoin info
No parameter schema in public metadata yet.
get_sperax_protocol_tvlSperax Protocol TVL
Sperax Protocol TVL
No parameter schema in public metadata yet.
get_arbitrum_defiTop Arbitrum DeFi protocols
Top Arbitrum DeFi protocols
No parameter schema in public metadata yet.
get_priceGet crypto prices
Get crypto prices
No parameter schema in public metadata yet.
search_coinsSearch coins
Search coins
No parameter schema in public metadata yet.
Sponsors
Readme
Sperax Ecosystem Crypto & DeFI MCP Server
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.
🔧 Development
Prerequisites
- Node.js 18+
- pnpm (recommended) or npm
Setup
# Clone repository
git clone https://github.com/sperax/sperax-crypto-mcp
cd sperax-crypto-mcp
# Install dependencies
pnpm install
# Build TypeScript
pnpm build
# Run in development mode (with auto-rebuild)
pnpm dev
Running
Details
- Repository
- github.com/nirholas/sperax-crypto-mcp
- Category
- Finance & Commerce
- Registry
- MCP registry, active
More from nirholas
- Repository Intelligence25
- Crypto Tools Registry23
- 3D AI Agent Avatar269
- three.ws 3D Agent Tools269
- three.ws AgenC269
- three.ws Agora269
- three.ws Assistant Widget269
- three.ws Autopilot269
- three.ws Coin Clash269
- three.ws Herald269
- three.ws Knock269
- three.ws Loom269
- XActions644
- three.ws Avatars & Agents269
- UCAI33
- PumpFun Claims Bot16
- Ethereum & EVM Message Signing23
- Ethereum Transaction Builder23
- Ethereum Wallet Generator23
- Ethereum Address Validator23
- Ethereum Keystore Encryption23
- GitHub to MCP Converter28
- Universal Blockchain MCP37
- DeFi Trading Agents32