Name: Sperax Ecosystem MCP
Author: Sperax

LABSCO SUMMARY

Sperax protocol reads sitting on top of a general-purpose EVM toolkit.

The Sperax half is what the name promises — USDs supply and rebase state, veSPA voting power, Demeter farm APRs, vault peg and collateral. The larger half is chain-agnostic: swaps, lending, ENS, portfolio, and a security stack that screens a token for honeypots, taxes and holder concentration before a signature is asked for. All of the read tools work with no key configured.

What it is

An MCP server for on-chain work on Arbitrum, BNB Chain and Ethereum. Most of the surface is general EVM — balances, transfers, swaps, bridges, staking, lending, ENS and contract security — and on top of that sit reads and actions for the Sperax protocol: the USDs auto-yield stablecoin, SPA governance, veSPA staking and Demeter yield farms.

What you get

Wallets and transfers: create_wallet, get_native_balance, get_erc20_balance, transfer_erc20, batch_transfer_erc20, get_wallet_portfolio, get_multichain_portfolio
Approvals treated as a standing risk — get_token_approvals, check_token_allowance, check_approval_risks, revoke_token_approval
DEX work: get_swap_quote, get_best_route, get_price_impact, execute_swap, plus add_liquidity, remove_liquidity, get_pool_reserves
Screening before anything is signed: analyze_token_security, detect_honeypot, detect_rug_pull_risk, get_holder_distribution, analyze_contract_permissions, and the GoPlus set including goplus_token_security, goplus_address_security and goplus_signature_decode
Lending and staking positions — get_lending_position, calculate_health_factor, get_lending_rates, stake_tokens, get_staking_apr, stake_eth_lido
Prices from oracles rather than one source: get_chainlink_price, get_multiple_prices, check_price_feed_health, get_uniswap_pool_price
The Sperax protocol itself: usds_get_info, usds_get_rebase_state, usds_get_yield_info, vespa_get_position, vespa_calculate_power, demeter_list_farms, demeter_estimate_apr, vault_get_peg_status, vault_simulate_mint
Protocol analytics, governance and history — analytics_get_tvl, analytics_compare_yields, governance_get_proposals, governance_get_voting_power, subgraph_usds_rebase_history

Requirements

Node.js 18 or newer. The published package is @nirholas/sperax-mcp, launched over stdio through npx. Reads need no credentials at all: RPC_URL is optional, and ARBITRUM_RPC_URL swaps in your own endpoint for better reliability. Anything that signs a transaction needs PRIVATE_KEY in the environment — that is a wallet key sitting in plain client configuration, so use one holding only what you are prepared to lose. An HTTP server mode is available for integrations that want it.

Setup effort

One command — npx -y @nirholas/sperax-mcp

See installation options

USE CASES

Checking a token before an agent goes near it

Screen it for honeypot behaviour and holder concentration, then read what its contract lets the owner do.

detect_honeypotget_holder_distributionanalyze_contract_permissions

Seeing where a wallet's value actually sits

Read the portfolio across chains rather than one balance call at a time.

get_multichain_portfolioget_wallet_portfolio

Deciding whether to hold USDs this week

Read the current supply and yield, then check whether the address would actually receive the rebase.

usds_get_infousds_get_yield_infousds_get_rebase_state

Comparing farms before committing liquidity

List the farms, estimate the return, then read the details of the one you picked.

demeter_list_farmsdemeter_estimate_aprdemeter_get_farm_details

Cleaning up approvals you forgot about

List what still has spending rights on the wallet, judge the risk, then revoke.

get_token_approvalscheck_approval_risksrevoke_token_approval

266 tools

Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.

`add_liquidity`

Add liquidity to a DEX trading pair

INSTALLATION

Connect your client

Server setup

TERMINAL

npx -y @nirholas/sperax-mcp

MCP Clients

Claude Desktop, Cursor

JSON

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

VS Code

VS CODE · JSON

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

Sperax Ecosystem MCP

Sperax protocol reads sitting on top of a general-purpose EVM toolkit.

What it is

What you get

Requirements

Setup effort

Checking a token before an agent goes near it

Seeing where a wallet's value actually sits

Deciding whether to hold USDs this week

Comparing farms before committing liquidity

Cleaning up approvals you forgot about

266 tools

add_liquidity

add_liquidity_native

agents_get

agents_get_categories

agents_get_sperax

agents_list

agents_search

analytics_compare_yields

analytics_get_apy_history

analytics_get_protocol_health

analytics_get_revenue

analytics_get_tvl

analytics_get_user_stats

analyze_contract_permissions

analyze_token_security

approve_nft_for_marketplace

approve_token_spending

batch_check_allowances

batch_resolve_addresses

batch_transfer_erc20

batch_transfer_nfts

borrow_from_lending

burn_erc20_tokens

buyback_get_stats

calculate_arbitrage

calculate_event_signature

calculate_health_factor

calculate_portfolio_allocation

calculate_proposal_id

calculate_tx_cost

cancel_transaction

cast_vote

check_address_type

check_approval_risks

check_contract_ownership

check_ens_availability

check_nft_approval

check_nft_ownership

check_price_feed_health

check_token_allowance

check_vote_eligibility

claim_staking_rewards

create_erc20_token

create_permit_signature

create_subdomain

create_wallet

decode_transaction_data

demeter_calculate_rewards

demeter_estimate_apr

demeter_get_farm_details

demeter_get_farm_types

demeter_get_top_farms

demeter_get_user_position

demeter_list_farms

derive_addresses_from_mnemonic

detect_honeypot

detect_rug_pull_risk

dripper_calculate_earnings

dripper_estimate_next_rebase

dripper_get_balance

dripper_get_config

dripper_get_status

encode_call_data

estimate_block_time

estimate_bridge_time

estimate_gas

execute_bridge

execute_multicall

`add_liquidity`

`add_liquidity_native`

`agents_get`

`agents_get_categories`

`agents_get_sperax`

`agents_list`

`agents_search`

`analytics_compare_yields`

`analytics_get_apy_history`

`analytics_get_protocol_health`

`analytics_get_revenue`

`analytics_get_tvl`

`analytics_get_user_stats`

`analyze_contract_permissions`

`analyze_token_security`

`approve_nft_for_marketplace`

`approve_token_spending`

`batch_check_allowances`

`batch_resolve_addresses`

`batch_transfer_erc20`

`batch_transfer_nfts`

`borrow_from_lending`

`burn_erc20_tokens`

`buyback_get_stats`

`calculate_arbitrage`

`calculate_event_signature`

`calculate_health_factor`

`calculate_portfolio_allocation`

`calculate_proposal_id`

`calculate_tx_cost`

`cancel_transaction`

`cast_vote`

`check_address_type`

`check_approval_risks`

`check_contract_ownership`

`check_ens_availability`

`check_nft_approval`

`check_nft_ownership`

`check_price_feed_health`

`check_token_allowance`

`check_vote_eligibility`

`claim_staking_rewards`

`create_erc20_token`

`create_permit_signature`

`create_subdomain`

`create_wallet`

`decode_transaction_data`

`demeter_calculate_rewards`

`demeter_estimate_apr`

`demeter_get_farm_details`

`demeter_get_farm_types`

`demeter_get_top_farms`

`demeter_get_user_position`

`demeter_list_farms`

`derive_addresses_from_mnemonic`

`detect_honeypot`

`detect_rug_pull_risk`

`dripper_calculate_earnings`

`dripper_estimate_next_rebase`

`dripper_get_balance`

`dripper_get_config`

`dripper_get_status`

`encode_call_data`

`estimate_block_time`

`estimate_bridge_time`

`estimate_gas`

`execute_bridge`

`execute_multicall`

`execute_swap`

`fetch_nft_metadata`

`generate_mnemonic`

`get_address_from_private_key`

`get_approval_events`

`get_available_price_feeds`

`get_best_route`

`get_block_by_hash`

`get_block_by_number`

`get_block_range`

`get_block_receipts`

`get_block_rewards`