nirholas avatar

SperaxOS

nirholas/sperax-crypto-mcp

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 tools

Public 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

Arbitrum BNB Chain Ethereum

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


View the full README on GitHub

Details

Repository
github.com/nirholas/sperax-crypto-mcp
Category
Finance & Commerce
Registry
MCP registry, active

More from nirholas

Related Finance & Commerce MCP servers

View all
1aaronsb avatarSalesforce Cloudaaronsb/salesforce-cloudAI-powered Salesforce CRM: opportunity intelligence, conversation analysis, SOQL, analytics6stars
2coinrithm avatarCoinRithm Agent Tradingcoinrithm/coinrithm-agent-tradingKeyless prediction-market data across 12 venues plus paper-trading of crypto spot, futures, and PM.4stars
3wyre-technology avatarXerowyre-technology/xero-mcpMCP server for Xero accounting — contacts, invoices, payments, accounts, and financial reports.1stars
4defibabylon avatardefi-inteldefibabylon/defi-intelOperator-grade DeFi intelligence MCP. - 10 tools vs DefiLlama's basic 4, - adds governance proposals, - RWA attestation scores, - live X/Twitter narrative. - No0stars
5aiproductscout avatarFinCore Agentic Commerceaiproductscout/fincoreAgentic commerce with 58 MCP tools for product search, checkout, A2A negotiation, C-Suite analytics.0stars
6nero-engine avatarSupplier Invoice Toolnero-engine/supplier-invoice-tool-mcpSupplier invoices to draft Xero bills per job, for UK trades' AI assistants (test mode)0stars