SperaxOS — Claude Code MCP server: what it does, how to install
An MCP server linking AI assistants to Sperax DeFi protocols. Inspect USDs stablecoin metrics, veSPA staking details, and Demeter yield farms on Arbitrum.
Open on GitHubWhat SperaxOS does
This server lets development agents interact with Sperax contracts on Arbitrum, BNB Chain, and Ethereum. It exposes tooling to monitor the USDs yield-bearing stablecoin, simulate mint operations, inspect vault collateral distributions, and verify peg stability against the dollar.
Built-in functions cover Chainlink oracle price feeds, veSPA lock evaluations, xSPA vesting positions, and Demeter farm listings. Communication runs via stdio or an HTTP service on port 3000.
Running the package requires Node.js 18+. To avoid rate limits on default RPC endpoints, pass your own node address in ARBITRUM_RPC_URL.
What it helps with
- monitor USDs supply, APR, and rebase distributions
- evaluate vault collateral health and peg deviation from one dollar
- compute voting power from locked veSPA balances
- browse active Demeter liquidity farms filtered by APR and TVL
Example prompts for the agent
- Show me the current USDs APR and check when the last rebase happened
- Inspect the USDs vault collateral ratio and peg stability against the dollar
- Calculate my voting weight if I lock 5000 SPA tokens in veSPA
How to install SperaxOS
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about SperaxOS
How to install SperaxOS in Claude Code?
Register the server using npx -y @sperax/mcp-server inside your MCP configuration settings. The runtime environment requires Node.js 18+.
What does SperaxOS do?
It exposes on-chain data from Sperax contracts to AI models. Agents can inspect stablecoin yields, audit vault reserves, and check staking allocations.
Can I connect a private RPC provider?
Yes, set ARBITRUM_RPC_URL for Arbitrum or CUSTOM_RPC_URL for BNB Chain in your environment. Custom endpoints prevent rate limiting during heavy queries.
