{ "additionalInterfaces": [ { "transport": "MCP/2025-06-18", "url": "https://chat.sperax.io/webapi/mcp/market" }, { "transport": "MCP/2025-06-18", "url": "https://chat.sperax.io/webapi/mcp/onchain" }, { "transport": "MCP/2025-06-18", "url": "https://chat.sperax.io/webapi/mcp/defi" }, { "transport": "MCP/2025-06-18", "url": "https://chat.sperax.io/webapi/mcp/risk" }, { "transport": "MCP/2025-06-18", "url": "https://chat.sperax.io/webapi/mcp/news" }, { "transport": "MCP/2025-06-18", "url": "https://chat.sperax.io/webapi/mcp/predict" } ], "capabilities": { "pushNotifications": false, "stateTransitionHistory": false, "streaming": false }, "defaultInputModes": [ "application/json" ], "defaultOutputModes": [ "application/json", "text/plain" ], "description": "An open-source DeFi agent workspace. Exposes audited, read-only on-chain and market intelligence over the Model Context Protocol: live prices and TVL, EVM and Solana chain data, yield and lending analytics, token and contract risk, crypto news and research, and prediction-market data. Hosted agents on this origin can additionally be hired per-call and paid over x402.", "documentationUrl": "https://chat.sperax.io/interop.html", "iconUrl": "https://chat.sperax.io/logo-sperax.png", "name": "SperaxOS", "preferredTransport": "MCP/2025-06-18", "protocolVersion": "0.3.0", "provider": { "organization": "Sperax", "url": "https://sperax.io" }, "security": [ {}, { "x402": [] } ], "securitySchemes": { "x402": { "description": "Per-call settlement over the x402 payment protocol. Applies to hired agent services and the paid endpoints under /api/x402; the MCP tool surface is free and needs no credential.", "type": "x402" } }, "skills": [ { "description": "Live crypto prices, market caps, TVL, categories, and macro market data for AI agents.", "examples": [ "Get current price, market cap, 24h volume, and 24h price change for a cryptocurrency token.", "Get top 7 trending tokens on CoinGecko right now.", "Search for tokens by name or symbol." ], "id": "sperax/market", "inputModes": [ "application/json" ], "name": "Sperax Market Data", "outputModes": [ "application/json", "text/plain" ], "tags": [ "market", "defi", "web3", "crypto", "read-only", "coingecko", "defillama", "markets", "analytics", "token", "categories", "emissions", "company", "holdings", "dex", "aggregators", "options", "volume", "bridges", "nft" ], "x-sperax-mcp": { "endpoint": "https://chat.sperax.io/webapi/mcp/market", "npmPackage": "@sperax/mcp-market", "registryName": "io.github.nirholas/sperax-market", "tools": [ "sperax-coingecko__getTokenPrice", "sperax-coingecko__getTrendingTokens", "sperax-coingecko__searchTokens", "sperax-coingecko__getMarketChart", "sperax-coingecko__getGlobalData", "sperax-defillama__getProtocolTvl", "sperax-defillama__getTopProtocols", "sperax-defillama__getYields", "sperax-defillama__getChainTvl", "sperax-defillama__getDexVolumes", "sperax-markets__getGlobalStats", "sperax-markets__getChainTvl", "sperax-markets__getCategoryBreakdown", "sperax-markets__getTopProtocols", "sperax-markets__getRevenueEarners", "sperax-markets__getTopYields", "sperax-markets__getSperaxEcosystem", "sperax-markets__getChains", "sperax-markets__getMarketPrices", "sperax-markets__getYieldPools", "sperax-markets__getStablecoins", "sperax-markets__getProtocolComparison", "sperax-defi-analytics__getFearGreedIndex", "sperax-defi-analytics__getWalletPortfolio", "sperax-defi-analytics__getTrendingAnalysis", "sperax-defi-analytics__getSocialSentiment", "sperax-defi-analytics__getMarketOverview", "sperax-token-categories__getCategories", "sperax-token-categories__getCategoryTokens", "sperax-token-categories__getCategorySummary", "sperax-token-emissions__getEmissionsSchedule", "sperax-token-emissions__getTokenSupplyInfo", "sperax-token-emissions__getEmissionsSummary", "sperax-company-holdings__getBtcHoldings", "sperax-company-holdings__getEthHoldings", "sperax-company-holdings__getHoldingsSummary", "sperax-dex-aggregators__getAggregators", "sperax-dex-aggregators__getAggregatorVolume", "sperax-dex-aggregators__getAggregatorSummary", "sperax-options-volume__getOptionsOverview", "sperax-options-volume__getProtocolOptions", "sperax-options-volume__getOptionsSummary", "sperax-bridges__getBridges", "sperax-bridges__getBridgeVolume", "sperax-bridges__getBridgeSummary", "sperax-nft-market__getNftCollections", "sperax-nft-market__getNftDetail", "sperax-nft-market__searchNfts" ] } }, { "description": "Read EVM & Solana chain data: balances, transactions, contracts, and wallet analytics.", "examples": [ "Get ETH balance for an address.", "Get recent transactions for an address.", "Get ERC-20 token transfers for an address." ], "id": "sperax/onchain", "inputModes": [ "application/json" ], "name": "Sperax On-Chain Data", "outputModes": [ "application/json", "text/plain" ], "tags": [ "onchain", "defi", "web3", "crypto", "read-only", "etherscan", "internal", "txs", "contract", "explorer", "helius", "gmgn", "zapper", "1inch", "portfolio", "fusion", "orders", "wallet", "trace", "giza", "dune", "analytics", "safe", "multisig" ], "x-sperax-mcp": { "endpoint": "https://chat.sperax.io/webapi/mcp/onchain", "npmPackage": "@sperax/mcp-onchain", "registryName": "io.github.nirholas/sperax-onchain", "tools": [ "sperax-etherscan__getAddressBalance", "sperax-etherscan__getTransactions", "sperax-etherscan__getTokenTransfers", "sperax-etherscan__getContractInfo", "sperax-etherscan__getGasOracle", "sperax-etherscan__getNftTransfers", "sperax-etherscan__getNftCollectionTransfers", "sperax-etherscan__getInternalTransactions", "sperax-internal-txs__getInternalTxs", "sperax-internal-txs__getInternalTxsByHash", "sperax-internal-txs__getInternalTxsSummary", "sperax-contract-explorer__getContractABI", "sperax-contract-explorer__readContract", "sperax-contract-explorer__getContractEvents", "sperax-contract-explorer__decodeTransaction", "sperax-helius__getTokenBalances", "sperax-helius__getTransactionHistory", "sperax-helius__getAssetsByOwner", "sperax-helius__getAssetDetails", "sperax-helius__getPriorityFees", "sperax-helius__resolveAddress", "sperax-gmgn__getWalletProfitStats", "sperax-gmgn__getWalletSocialInfo", "sperax-gmgn__getTokenInfo", "sperax-gmgn__getTokenTrades", "sperax-gmgn__getTokenTopHolders", "sperax-gmgn__getTrendingTokens", "sperax-gmgn__getTokenList", "sperax-zapper__getWalletBalances", "sperax-zapper__getDefiPositions", "sperax-zapper__getNftHoldings", "sperax-zapper__getWalletHistory", "sperax-zapper__getNetWorth", "sperax-1inch-portfolio__getPortfolioBalances", "sperax-1inch-portfolio__getPortfolioProtocols", "sperax-1inch-portfolio__getPortfolioSummary", "sperax-fusion-orders__getActiveOrders", "sperax-fusion-orders__getOrderHistory", "sperax-fusion-orders__getOrderSummary", "sperax-wallet-trace__traceAddress", "sperax-wallet-trace__getExchangeHops", "sperax-wallet-trace__getAddressClusters", "sperax-giza__getAgentOverview", "sperax-giza__getProofHistory", "sperax-giza__getModelPerformance", "sperax-giza__getProtocolAnalytics", "sperax-dune-analytics__queryDashboard", "sperax-dune-analytics__getPopularQueries", "sperax-dune-analytics__getWalletAnalytics", "sperax-dune-analytics__getProtocolMetrics", "sperax-dune-analytics__getChainActivity", "lobe-safe-multisig__getSafeInfo", "lobe-safe-multisig__getPendingTransactions", "lobe-safe-multisig__getSafeTransactionHistory", "lobe-safe-multisig__estimateSafeGas" ] } }, { "description": "Analyze DeFi: yields, lending markets, LP positions, pools, and strategy backtests.", "examples": [ "Read the SPA token balance of an address on every chain SPA is deployed to — BNB Chain, Arbitrum and Ethereum — plus the xSPA and USDs balances on Arbitrum, straight from the token contracts.", "Read the veSPA staking position of an address from the active escrow on Arbitrum: locked SPA principal, unlock date, cooldown state (auto or manual, initiated or not) and current decaying voting power.", "Get the current USD price and 24-hour change of SPA and USDs (the Sperax stablecoin)." ], "id": "sperax/defi", "inputModes": [ "application/json" ], "name": "Sperax DeFi Analytics", "outputModes": [ "application/json", "text/plain" ], "tags": [ "defi", "web3", "crypto", "read-only", "spa", "lending", "yield", "vaults", "optimizer", "calculator", "liquidity", "advisor", "uniswap", "pancakeswap", "four", "meme", "backtesting", "flash", "loan", "scanner", "dex", "new", "listings", "listadao", "protocol", "plutus", "dust", "sweeper", "swap" ], "x-sperax-mcp": { "endpoint": "https://chat.sperax.io/webapi/mcp/defi", "npmPackage": "@sperax/mcp-defi", "registryName": "io.github.nirholas/sperax-defi", "tools": [ "sperax-spa__getSpaBalances", "sperax-spa__getStakingPosition", "sperax-spa__getSpaPrice", "sperax-spa__getProtocolStats", "sperax-lending__getMarkets", "sperax-lending__getUserPositions", "sperax-lending__getHealthFactor", "sperax-yield-vaults__getVaults", "sperax-yield-vaults__getVaultDetails", "sperax-yield-vaults__getUserPositions", "sperax-yield-optimizer__findOptimalYield", "sperax-yield-optimizer__getYieldMigrationPlan", "sperax-yield-optimizer__simulateYieldStrategy", "sperax-yield-optimizer__compareYieldPaths", "sperax-yield-optimizer__getHistoricalYieldAnalysis", "sperax-yield-optimizer__backtestStrategy", "sperax-yield-optimizer__compareToHodl", "sperax-il-calculator__calculateIL", "sperax-il-calculator__trackPositionIL", "sperax-il-calculator__simulateILScenarios", "sperax-il-calculator__getHedgeRecommendation", "sperax-il-calculator__getHistoricalILAttribution", "sperax-liquidity-advisor__analyzePositions", "sperax-liquidity-advisor__recommendMigration", "sperax-liquidity-advisor__optimizeRange", "sperax-liquidity-advisor__getRebalanceAlert", "sperax-liquidity-advisor__simulateMigration", "sperax-uniswap-v3__getPositions", "sperax-uniswap-v3__analyzePosition", "sperax-uniswap-v3__simulateRebalance", "sperax-uniswap-v3__getPoolStats", "sperax-uniswap-v3__findOptimalRange", "sperax-pancakeswap__getTopPools", "sperax-pancakeswap__getTokenInfo", "sperax-pancakeswap__getSwapQuote", "sperax-pancakeswap__getFarmingPools", "sperax-pancakeswap__getPoolDetail", "sperax-pancakeswap__getRecentTrades", "sperax-four-meme__getConfig", "sperax-four-meme__getTokenInfo", "sperax-four-meme__tokenList", "sperax-four-meme__tokenGet", "sperax-four-meme__tokenRankings", "sperax-four-meme__quoteBuy", "sperax-four-meme__quoteSell", "sperax-four-meme__getEvents", "sperax-four-meme__getTaxInfo", "sperax-four-meme__getCreatorTokens", "sperax-four-meme__getTopHolders", "lobe-backtesting__runBacktest", "lobe-backtesting__compareStrategies", "sperax-flash-loan-scanner__scanArbitrageOpportunities", "sperax-flash-loan-scanner__findLiquidationTargets", "sperax-flash-loan-scanner__estimateFlashLoanProfit", "sperax-flash-loan-scanner__getFlashLoanProviders", "sperax-flash-loan-scanner__analyzeHistoricalFlashLoans", "sperax-dex-new-listings__getNewListings", "sperax-dex-new-listings__getListingDetail", "sperax-listadao__getProtocolStats", "sperax-listadao__getStakingInfo", "sperax-listadao__getCdpInfo", "sperax-listadao__getFarms", "sperax-listadao__getUserPositions", "sperax-listadao__getSavingsInfo", "sperax-listadao__getPsmInfo", "sperax-protocol__getAutoYieldStats", "sperax-protocol__getFarms", "sperax-protocol__getStakingInfo", "sperax-protocol__getXSpaInfo", "sperax-protocol__getBuybackStats", "sperax-protocol__getProtocolOverview", "sperax-plutus__getPlutusVaults", "sperax-plutus__getVaultDetails", "sperax-plutus__getPlsAssets", "sperax-dust-sweeper__scanForDust", "sperax-dust-sweeper__getSweepStrategy", "sperax-dust-sweeper__estimateSweepValue", "sperax-swap__getQuote", "sperax-swap__getSwapStatus", "sperax-swap__getSupportedChains", "sperax-swap__getSupportedTokens", "sperax-swap__checkBridgeRoute", "sperax-swap__getBridgeStatus" ] } }, { "description": "Assess DeFi risk: token/contract security, hacks, liquidations, MEV, and approvals.", "examples": [ "Get a comprehensive risk score for a DeFi protocol.", "Analyze smart contract security for a DeFi protocol.", "Analyze governance decentralization." ], "id": "sperax/risk", "inputModes": [ "application/json" ], "name": "Sperax Risk & Security", "outputModes": [ "application/json", "text/plain" ], "tags": [ "risk", "defi", "web3", "crypto", "read-only", "protocol", "goplus", "security", "hacks", "liquidations", "token", "unlocks", "raises", "governance", "mev", "shield", "simulator", "builder", "approvals", "erc8004", "copy", "trading" ], "x-sperax-mcp": { "endpoint": "https://chat.sperax.io/webapi/mcp/risk", "npmPackage": "@sperax/mcp-risk", "registryName": "io.github.nirholas/sperax-risk", "tools": [ "sperax-protocol-risk__scoreProtocol", "sperax-protocol-risk__getContractRisk", "sperax-protocol-risk__analyzeGovernance", "sperax-protocol-risk__getEconomicSecurity", "sperax-protocol-risk__compareProtocols", "sperax-goplus-security__checkTokenSecurity", "sperax-goplus-security__checkAddressSecurity", "sperax-goplus-security__checkMaliciousAddress", "sperax-goplus-security__batchCheckTokenSecurity", "sperax-goplus-security__checkApprovalSecurity", "sperax-goplus-security__checkNFTSecurity", "sperax-goplus-security__checkDAppSecurity", "sperax-goplus-security__detectPhishingUrl", "sperax-defi-hacks__getRecentHacks", "sperax-defi-hacks__getHacksByProtocol", "sperax-defi-hacks__getHackSummary", "sperax-liquidations__getRecentLiquidations", "sperax-liquidations__getLiquidationsByProtocol", "sperax-liquidations__getLiquidationSummary", "sperax-token-unlocks__getUpcomingUnlocks", "sperax-token-unlocks__getProtocolUnlocks", "sperax-token-unlocks__getUnlockSummary", "sperax-vc-raises__getRecentRaises", "sperax-vc-raises__searchRaises", "sperax-vc-raises__getRaiseSummary", "sperax-governance__getActiveProposals", "sperax-governance__getProtocolGovernance", "sperax-governance__getGovernanceSummary", "sperax-governance__getProposalDetails", "sperax-governance__getVotingPower", "sperax-governance__getVotingHistory", "sperax-mev-shield__analyzeTransaction", "sperax-mev-shield__getMevExposure", "sperax-mev-shield__getProtectionRecommendation", "sperax-mev-shield__scanMempoolActivity", "sperax-mev-shield__detectSandwichAttack", "sperax-tx-simulator__simulateTransaction", "sperax-tx-simulator__simulateBundle", "sperax-tx-simulator__securityScan", "sperax-tx-simulator__decodeTransaction", "sperax-tx-builder__estimateGas", "sperax-tx-builder__simulateTransaction", "sperax-tx-builder__getSwapQuote", "sperax-token-approvals__getApprovals", "sperax-token-approvals__getRiskAssessment", "sperax-token-approvals__getApprovalHistory", "sperax-erc8004__getAgent", "sperax-erc8004__listAgents", "sperax-erc8004__searchAgents", "sperax-erc8004__getReputation", "sperax-erc8004__querySubgraph", "sperax-erc8004__getValidation", "sperax-erc8004__checkValidation", "sperax-erc8004__getAgentCount", "sperax-erc8004__searchAllChains", "sperax-erc8004__getMetadata", "sperax-erc8004__batchGetMetadata", "lobe-copy-trading__discoverWhales", "lobe-copy-trading__getWalletProfile", "lobe-copy-trading__getRecentTrades" ] } }, { "description": "Crypto news, sentiment, VC research, technical analysis, and education for agents.", "examples": [ "Fetch the latest crypto news articles.", "Search crypto news by keyword or token name.", "Get currently trending crypto topics with mention counts and sentiment indicators." ], "id": "sperax/news", "inputModes": [ "application/json" ], "name": "Sperax News & Intelligence", "outputModes": [ "application/json", "text/plain" ], "tags": [ "news", "defi", "web3", "crypto", "read-only", "social", "daily", "report", "academy", "price", "prediction", "research", "intel", "tradingview", "zealy" ], "x-sperax-mcp": { "endpoint": "https://chat.sperax.io/webapi/mcp/news", "npmPackage": "@sperax/mcp-news", "registryName": "io.github.nirholas/sperax-news", "tools": [ "sperax-crypto-news__getLatestNews", "sperax-crypto-news__searchNews", "sperax-crypto-news__getTrendingTopics", "sperax-crypto-news__getBreakingNews", "sperax-crypto-news__getDeFiNews", "sperax-crypto-news__getDailyDigest", "sperax-crypto-news__getSentiment", "sperax-x-social__getCryptoSentiment", "sperax-x-social__getTrendingCrypto", "sperax-x-social__searchNews", "sperax-x-social__getInfluencerFeed", "sperax-daily-report__getDailyReport", "sperax-daily-report__getMarketSentiment", "sperax-daily-report__getDefiPulse", "sperax-daily-report__getSperaxUpdate", "sperax-academy__learnTopic", "sperax-academy__getGlossary", "sperax-academy__getLearningPath", "sperax-academy__searchTopics", "sperax-academy__getLessons", "sperax-price-prediction__getPrediction", "sperax-price-prediction__getHistoricalAccuracy", "sperax-price-prediction__getTechnicalIndicators", "sperax-research-intel__getLatestReports", "sperax-research-intel__searchResearch", "sperax-research-intel__getTrendRadar", "sperax-research-intel__getOutlook", "sperax-research-intel__getThesisSummary", "sperax-tradingview__analyzeChart", "sperax-tradingview__generatePineScript", "sperax-tradingview__showChart", "sperax-tradingview__showHeatmap", "sperax-tradingview__showTicker", "sperax-tradingview__showMiniChart", "sperax-tradingview__showScreener", "sperax-zealy__getCommunityInfo", "sperax-zealy__getUser", "sperax-zealy__getLeaderboard", "sperax-zealy__listSprints" ] } }, { "description": "Read prediction markets and perpetuals: markets, orderbooks, prices, and leaderboards.", "examples": [ "List active Polymarket prediction markets.", "Fetch a single Polymarket market by id (the Gamma numeric id or slug).", "Fetch the CLOB orderbook + midpoint for a market outcome token." ], "id": "sperax/predict", "inputModes": [ "application/json" ], "name": "Sperax Prediction & Perps", "outputModes": [ "application/json", "text/plain" ], "tags": [ "predict", "defi", "web3", "crypto", "read-only", "polymarket", "pump", "fun", "perpetuals" ], "x-sperax-mcp": { "endpoint": "https://chat.sperax.io/webapi/mcp/predict", "npmPackage": "@sperax/mcp-predict", "registryName": "io.github.nirholas/sperax-predict", "tools": [ "sperax-polymarket__listMarkets", "sperax-polymarket__getMarket", "sperax-polymarket__getOrderbook", "sperax-polymarket__getLastTrades", "sperax-polymarket__getUserPositions", "sperax-polymarket__getUserActivity", "sperax-polymarket__getLeaderboard", "sperax-polymarket__getOrderStatus", "sperax-pump-fun__getBuyQuote", "sperax-pump-fun__getSellQuote", "sperax-pump-fun__getBondingCurveStatus", "sperax-pump-fun__getFeeTiers", "sperax-pump-fun__getCreatorProfile", "sperax-pump-fun__getCoinInfo", "sperax-pump-fun__getLatestCoins", "sperax-pump-fun__getLiveStreams", "sperax-pump-fun__searchCoins", "lobe-perpetuals__getMarkets", "lobe-perpetuals__getPositions", "lobe-perpetuals__getFundingRates", "lobe-perpetuals__getLiquidationPrice" ] } } ], "url": "https://chat.sperax.io/webapi/mcp/market", "version": "2.1.23", "x-erc8004": { "registrationUrl": "https://chat.sperax.io/.well-known/erc8004-registration.json", "registries": [ { "chain": "arbitrum", "chainId": 42161, "identity": "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432", "reputation": "0x8004BAa17C55a88189AE136b182e5fdA19dE9b63" }, { "chain": "base", "chainId": 8453, "identity": "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432", "reputation": "0x8004BAa17C55a88189AE136b182e5fdA19dE9b63" }, { "chain": "bsc", "chainId": 56, "identity": "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432", "reputation": "0x8004BAa17C55a88189AE136b182e5fdA19dE9b63" }, { "chain": "ethereum", "chainId": 1, "identity": "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432", "reputation": "0x8004BAa17C55a88189AE136b182e5fdA19dE9b63" }, { "chain": "optimism", "chainId": 10, "identity": "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432", "reputation": "0x8004BAa17C55a88189AE136b182e5fdA19dE9b63" }, { "chain": "polygon", "chainId": 137, "identity": "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432", "reputation": "0x8004BAa17C55a88189AE136b182e5fdA19dE9b63" } ] }, "x-sperax": { "agentDirectoryUrl": "https://chat.sperax.io/api/a2a/directory", "capabilities": { "exposedFunctions": 306, "exposedTools": 64, "groups": 6 }, "toolCatalogUrl": "https://chat.sperax.io/tools.html", "x402DiscoveryUrl": "https://chat.sperax.io/.well-known/x402" } }