SperaxOS

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

# Start stdio server (for Claude Desktop)

pnpm start

Start HTTP server (for integrations)

pnpm start:http

Run with BNB Chain RPC

CUSTOM_RPC_URL="https://..." pnpm start

Run with Arbitrum RPC

ARBITRUM_RPC_URL="https://..." pnpm start

Testing

# Run tests

pnpm test

Run tests in watch mode

pnpm test:watch

Test with MCP Inspector

npx @modelcontextprotocol/inspector dist/index.js

Linting & Type Checking

# Lint code

pnpm lint

Type check

pnpm typecheck

---

🤝 Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

{

"mcpServers": { "sperax": { "command": "npx", "args": ["-y", "@sperax/mcp-server"] } } }

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/claude/claude_desktop_config.json

Cursor / VS Code

Add to your MCP settings:

{

"mcp.servers": { "sperax": { "command": "npx", "args": ["-y", "@sperax/mcp-server"] } } }

With Custom RPC Endpoint

For better performance and reliability, use your own Arbitrum RPC:

{

"mcpServers": { "sperax": { "command": "npx", "args": ["-y", "@sperax/mcp-server"], "env": { "ARBITRUM_RPC_URL": "https://your-rpc-endpoint.com" } } } }

HTTP Server Mode

For advanced integrations, run as an HTTP server:

# Start HTTP server on port 3000

pnpm start:http

Or with custom port

PORT=8080 pnpm start:http

<details>

Sperax MCP Server Repository

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.

🛠️ Available Tools

USDs Stablecoin (7 tools)

Vault & Collateral (10 tools)

SPA & Staking (8 tools)

Demeter Farms (7 tools)

Dripper (5 tools)

Oracle (5 tools)

Analytics (6 tools)

Governance (5 tools)

Yield Reserve (4 tools)

---

📚 Available Resources

---

💡 Example Conversations

Check USDs Yield

User: "What's the current USDs APY and how much would I earn on $10,000?"

Agent: *Uses usds_get_yield_info and calculates projections*

Find Best Farms

User: "Show me Demeter farms with over 20% APR"

Agent: *Uses demeter_get_top_farms with minApr filter*

Calculate veSPA Power

User: "How much voting power would I get locking 1000 SPA for 2 years?"

Agent: *Uses vespa_calculate_power with amount=1000, days=730*

Protocol Health Check

User: "Give me an overview of the Sperax protocol health"

Agent: *Uses multiple tools to compile health dashboard*

Portfolio Analysis

User: "Check my USDs balance at 0x..."

Agent: *Uses usds_get_balance and usds_get_yield_info*

---

💬 Example Prompts

| spa_tokenomics | Expl