Surf MCP Server
OfficialSurf MCP Server exposes Surf’s crypto data API as 15 MCP tools for AI clients.
Query market, exchange, and DEX data: prices, OHLCV, rankings, ETFs, futures, options, funding, depth, liquidations, Fear & Greed, and technical/on-chain indicators.
Inspect wallets, tokens, and blockchains: balances, transfers, DeFi positions, holders, DEX trades, tokenomics, gas prices, transactions, and SQL/structured on-chain queries.
Research projects, funds, signals, news, web pages, X posts, and unified search results.
Analyze prediction markets on Polymarket and Kalshi, including events, markets, prices, volumes, trades, orderbooks, analytics, and cross-platform matching.
Explore Hyperliquid accounts, positions, orders, fills, closed trades, performance, candles, and leaderboards.
Run via stdio or Streamable HTTP with API-key passthrough, anonymous allowance, and optional OAuth discovery/login.
Provides access to Binance exchange data including order book depth, klines, perpetual futures, funding history, prices, and market pairs.
Enables on-chain queries, transaction lookup, gas prices, token holder analysis, and social sentiment for Ethereum.
Provides access to OKX exchange data including order book depth, klines, perpetual futures, funding history, prices, and market pairs.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Surf MCP Server what's the BTC price?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
surf-mcp
MCP server for the Surf crypto data API. Dynamically generates tools from the OpenAPI spec across market data, wallets, social, on-chain queries, and more. It supports stdio for local clients and Streamable HTTP for hosted ChatGPT/Codex integrations.
Quick start
Add to your MCP client config — no clone or install needed:
{
"mcpServers": {
"surf": {
"type": "http",
"url": "https://mcp.asksurf.ai/mcp"
}
}
}To run the stdio package locally instead:
{
"mcpServers": {
"surf": {
"command": "npx",
"args": ["-y", "@surf-ai/surf-mcp"],
"env": {
"SURF_API_KEY": "your-api-key"
}
}
}
}Prerequisites
Node.js 20+ or Bun
Optional: a Surf API key (get one here) for account credits and higher limits. Without a key, Surf's anonymous per-IP allowance applies.
Config file locations
Claude Code:
.mcp.jsonin project root or~/.claude.jsonClaude Desktop:
~/Library/Application Support/Claude/claude_desktop_config.json(macOS)Cursor: MCP settings in the IDE
Related MCP server: Alpha Sentinel Market Intelligence x402 MCP Server
Claude Code plugin
This repository is also a Claude Code marketplace. Install the Surf plugin with:
claude plugin marketplace add asksurf-ai/surf-mcp
claude plugin install surf@surfThe plugin connects to the hosted anonymous beta. Usage is limited by Surf's anonymous allowance; production deployments should use a dedicated, rate-limited service key or OAuth 2.1.
ChatGPT and Codex plugin
The repository contains a Codex/ChatGPT plugin package under plugins/surf, a Claude package under claude-plugin, and repo marketplaces for both hosts. The two thin package directories are separate because the current hosts validate different .mcp.json root shapes; both connect to the hosted MCP endpoint. Codex can add its marketplace directly:
codex plugin marketplace add asksurf-ai/surf-mcpRegister https://mcp.asksurf.ai/mcp/chatgpt in ChatGPT Plugins. See docs/chatgpt-plugin-submission.md for the submission checklist.
Streamable HTTP deployment
Run the hosted transport locally:
bun run start:httpThe server exposes:
POST /mcp— stateless MCP Streamable HTTP endpointPOST /mcp/chatgpt— the same endpoint with the ChatGPT tool profile, which leaves out third-party news, web, signal, and X content tools (seesrc/profiles.ts)GET /healthz— deployment health checkGET /.well-known/oauth-protected-resource— OAuth resource metadata (RFC 9728); returns 404 untilSURF_OAUTH_AUTHORIZATION_SERVERis configuredGET /.well-known/oauth-authorization-server— the authorization server's RFC 8414 metadata, relayed from the issuerGET /.well-known/openid-configuration— the authorization server's OpenID Connect discovery document, relayed from the issuer; hosts that enforce workspace domain restrictions (ChatGPT Enterprise/Team) read theuserinfo_endpointand theopenid/emailscopes from here
Authentication
Each HTTP request's Authorization header is forwarded verbatim to the Surf data API, so callers presenting their own Surf API key (or a Surf-issued OAuth token, once available) are billed and rate-limited on their own account. Resolution order per request:
The incoming
Authorizationheader, forwarded as-isThe deployment's
SURF_API_KEYservice key (Bearerscheme)Anonymous — the Surf API's per-IP allowance applies
Environment variables for OAuth discovery and login:
Variable | Purpose |
| Issuer URL of the Surf OAuth authorization server (e.g. |
| Public URL of this MCP deployment (default |
|
|
Deployment modes:
|
| Behavior |
unset | unset | Anonymous allowance + API key passthrough (current beta) |
set | unset | OAuth discoverable for clients that look for it; anonymous still allowed |
set | set | Credential-less requests are challenged into the OAuth login flow |
Scopes: data:read is the base scope of every grant. Requesting openid additionally returns an ID token and enables the userinfo endpoint; email releases the account's verified email through both. When registering the server with a host that supports domain restrictions, request openid email (the data scope is implied).
Build and run the included container:
docker build -t surf-mcp .
docker run --rm -p 3000:3000 -e SURF_API_KEY=your-service-api-key surf-mcpThe limited beta is live at https://mcp.asksurf.ai/mcp. For higher capacity, keep a dedicated, rate-limited SURF_API_KEY in the host's secret manager; never put it in plugin manifests or client-visible responses.
The included Vercel Functions adapter exposes the same endpoints from api/mcp.ts, api/mcp-chatgpt.ts, and api/healthz.ts. Deploy it to a Vercel project when a serverless beta is preferable to the container image.
Tools
The server currently exposes 15 tools, one per API domain. Each tool accepts a command and optional params; the exact commands update automatically with the Surf OpenAPI specification:
Tool | Commands | Description |
|
| DEX-pool-weighted token OHLCV data |
|
| Market overview, rankings, indicators, ETF flows |
|
| Live exchange data from Binance, OKX, Bybit, etc. |
|
| Hyperliquid trader, position, order, fill, and P&L data |
|
| Wallet balances, transfers, DeFi positions |
|
| Token holder analysis, DEX trades, unlocks |
|
| X post and author details by post ID |
|
| Project profiles, DeFi TVL/fees/revenue |
|
| Project signal scores and ranked highlights |
|
| On-chain SQL queries, tx lookup, gas prices |
|
| Unified search across all data types |
|
| Polymarket and Kalshi prediction markets |
|
| Crypto VC fund profiles and portfolios |
|
| Crypto news from major outlets |
|
| Fetch any URL as clean markdown |
Usage examples
Once configured, your AI assistant can use the tools directly:
"What's the BTC price?" → surf_market({ command: "price", params: { symbol: "BTC" } })
"Check vitalik's wallet" → surf_wallet({ command: "detail", params: { address: "vitalik.eth" } })
"Search for DeFi projects" → surf_search({ command: "project", params: { q: "defi lending" } })
"Run an on-chain SQL query" → surf_onchain({ command: "sql", params: { sql: "SELECT ..." } })
"Surf's token of the day" → surf_signal({ command: "token-of-the-day" })How it works
On startup, the server:
Fetches the OpenAPI spec from
https://api.asksurf.ai/gateway/openapi.json(cached for 24h)Groups all operations by their API tag
Registers one MCP tool per tag with auto-generated descriptions and command enums
Routes tool calls to the Surf API with native HTTP fetch and optional bearer authentication
The server automatically picks up new API endpoints when the spec is updated — just restart.
Example: AI agent
The repo includes a simple agent that connects Claude to surf-mcp tools in an agentic loop. See examples/agent.ts.
ANTHROPIC_API_KEY=your-key SURF_API_KEY=your-key bun run examples/agent.ts "What's the BTC price and fear & greed index?"Development
git clone https://github.com/asksurf-ai/surf-mcp.git
cd surf-mcp
bun install
bun run start # Run the server
bun run start:http # Run Streamable HTTP on :3000
bun run typecheck # Type checkLicense
MIT
Available Tools
15 toolssurf_dexSurf DEXARead-only
Use this when the user needs dex data from Surf.
Commands: token-price - DEX Token OHLCV Price params: chain* (string), address* (string), interval (string), time_range (string), from (string), to (string)
Inputs: command (required), params.
surf_exchangeSurf ExchangeARead-only
Use this when the user needs exchange data from Surf. Access real-time trading data from major exchanges including Binance, OKX, Bybit, and more. Query live ticker prices, order book depth, OHLCV candlestick charts, and perpetual contract data such as funding rates, open interest, and long/short ratios.
Commands: candles - Exchange Historical Candles params: exchange* (string) [bithumb, upbit, hashkey, bitflyer, coinone, korbit], pair* (string), interval (string) [5m, 4h, 1w], from (string), to (string), include_synthetic (boolean), limit (integer), offset (integer) coverage - Exchange Market Coverage params: exchange (string) [bithumb, upbit, hashkey, bitflyer, coinone, korbit], q (string), quote (string), type (string) [spot], status (string) [active, inactive], data_status (string), sort_by (string), order (string) [asc, desc], limit (integer), offset (integer) depth - Exchange Order Book Depth params: pair* (string), type (string) [spot, swap, perpetual, perp], limit (integer), exchange (string) funding-history - Exchange Funding Rate History params: pair* (string), from (string), limit (integer), exchange (string) klines - Exchange OHLCV Candlesticks params: pair* (string), type (string) [spot, swap, perpetual, perp], interval (string), from (string), limit (integer), exchange (string) long-short-ratio - Exchange Long/Short Ratio History params: pair* (string), interval (string) [1h, 4h, 1d], from (string), limit (integer), exchange (string) [binance, okx, bybit, bitget] markets - Exchange Trading Pairs params: exchange (string), type (string) [spot, swap, future, option, perpetual, perp], base (string), quote (string), search (string), limit (integer) perp - Exchange Perpetual Contract Snapshot params: pair* (string), fields (string), exchange (string) price - Exchange Ticker Price params: pair* (string), type (string) [spot, swap, perpetual, perp], exchange (string)
Inputs: command (required), params.
surf_fundSurf FundARead-only
Use this when the user needs fund data from Surf. Explore crypto venture capital. Look up fund profiles with team info and social links, browse their full investment portfolio with round details, and rank funds by tier or portfolio size.
Commands: detail - Fund Profile Detail params: id (string), q (string) portfolio - Fund Portfolio params: id (string), q (string), limit (integer), offset (integer), is_lead (string) [true, false, ], invested_after (integer), invested_before (integer), sort_by (string) [invested_at, recent_raise, total_raise], order (string) [asc, desc] ranking - Fund Ranking params: metric* (string) [tier, portfolio_count], limit (integer), offset (integer)
Inputs: command (required), params.
surf_hyperliquidSurf HyperliquidARead-only
Use this when the user needs hyperliquid data from Surf.
Commands: account - Account Portfolio params: address* (string) candles - Market Candles params: symbol* (string), interval (string), from* (string), to* (string) fills - Fills params: address* (string), from (string), to (string), to_ms (integer), to_fill_id (string), order (string) [desc, asc], cursor (string), symbol (string), limit (integer) leaderboard - Trader Leaderboard params: time_range (string) [1d, 7d, 30d, 90d, all], sort_by (string) [total_pnl, win_rate, volume_traded], min_trades (integer), min_days_active (integer), min_account_age_days (integer), min_human_score (integer), dex (string), limit (integer), offset (integer) orders - Open & Recent Orders params: address* (string), open_limit (integer), historical_limit (integer) performance - Trading Performance params: address* (string), dex (string) positions - Open Positions params: address* (string), dex (string) trades - Closed Trades params: address* (string), symbol (string), direction (string) [long, short], dex (string), from (string), to (string), cursor (string), limit (integer) trades-aggregate - Closed Trades Aggregate params: address* (string), group_by (string) [day, symbol, direction, size_bucket, hold_bucket], from (string), to (string), dex (string), fill_gaps (boolean) trade-context - Closed Trade Funding and Leverage params: address* (string), symbol* (string), direction* (string) [long, short], open_time* (integer), close_time* (integer)
Inputs: command (required), params.
surf_marketSurf MarketARead-only
Use this when the user needs market data from Surf. Get a high-level view of the crypto market. Browse token rankings by market cap or volume, track derivatives across all exchanges, monitor spot ETF fund flows, view liquidation events, compute technical indicators (RSI, MACD, Bollinger Bands, and more), explore on-chain valuation metrics (NUPL, MVRV, SOPR), and check the Fear & Greed Index.
Commands: etf - ETF Flow History params: symbol* (string) [BTC, ETH, XRP, SOL, HYPE], sort_by (string) [flow_usd, timestamp], order (string) [asc, desc], from (string), to (string) exchange-flow-exchanges - Exchange Flow Exchanges params: symbol* (string) [BTC, ETH], limit (integer), offset (integer) fear-greed - Fear & Greed Index History params: from (string), to (string) futures - Futures Market Overview params: sort_by (string) [open_interest, funding_rate, volume_24h, long_short_ratio], order (string) [asc, desc] liquidation-chart - Liquidation Chart params: symbol* (string), interval (string), exchange (string), limit (integer), from (string), to (string) liquidation-exchange-list - Liquidation by Exchange params: symbol (string), time_range (string) [1h, 4h, 12h, 24h], sort_by (string) [liquidation_usd, long_liquidation_usd, short_liquidation_usd], order (string) [asc, desc] liquidation-order - Large Liquidation Orders params: exchange (string), symbol (string), min_amount (string), side (string) [long, short], sort_by (string) [usd_value, timestamp, price], order (string) [asc, desc], limit (integer), offset (integer), from (string), to (string) listing - Exchange Listing Events params: from* (string), to (string), symbol (string), exchange (string), product (string) [spot, margin, perp, pre_market_perp, all], type (string) [listing, delisting, cancelled, advanced, postponed], limit (integer), offset (integer) onchain-indicator - On-Chain Indicator params: symbol* (string) [BTC, ETH], metric* (string), granularity (string) [day], from (string), to (string), exchange (string) options - Options Market Data params: symbol* (string), sort_by (string) [open_interest, volume_24h], order (string) [asc, desc] price - Token Price History params: symbol* (string), time_range (string), from (string), to (string), currency (string) price-indicator - Technical Indicator params: indicator* (string), symbol* (string), interval (string), exchange (string) [binance, bybit, coinbase, kraken], from (string), to (string), options (string) public-sale - Public Sale / Crowdsale params: id (string), q (string) ranking - Token Rankings params: sort_by (string) [market_cap, change_24h, volume_24h], order (string) [asc, desc], category (string), limit (integer), offset (integer) tge - Token Generation Event params: id (string), q (string)
Inputs: command (required), params.
surf_newsSurf NewsARead-only
Use this when the user needs news data from Surf. Stay up to date with crypto news. Browse the latest articles from major crypto media outlets, read full article content, and search across all sources by keyword.
Commands: detail - News Article Detail params: id* (string) feed - Crypto News Feed params: source (string), project (string), from (string), to (string), sort_by (string) [recency, trending], limit (integer), offset (integer)
Inputs: command (required), params.
surf_onchainSurf OnchainA
Use this when the user needs onchain data from Surf. Query blockchain data directly. Look up transaction details by hash, check gas prices, and run structured or raw SQL queries against indexed blockchain datasets spanning Ethereum, Base, Solana, and more.
Commands: bridge-ranking - Bridge Protocol Ranking params: time_range (string) [7d, 30d, 90d, 180d, 1y, all], limit (integer), offset (integer) dex-activity - DEX Protocol Activity params: chain* (string) [ethereum, base, bsc, arbitrum, tron], project (string), address (string), time_range (string) [1d, 7d, 30d, 90d], from (string), to (string), group_by (string) [total, day] gas-price - Current Gas Price params: chain* (string) structured-query - Blockchain Structured Query params: $schema (string), fields (array,null), filters (array,null), limit (integer), offset (integer), sort (array,null), source* (string) schema - On-Chain Table Schema params: table (string) sql - Blockchain SQL Query params: $schema (string), max_rows (integer), sql* (string) sql-job-create - Submit Asynchronous Blockchain SQL Job params: $schema (string), max_rows (integer), sql* (string) sql-job-get - Get Asynchronous Blockchain SQL Job params: job_id* (string) sql-job-results - Download Asynchronous Blockchain SQL Results params: job_id* (string), format (string) [json, csv] sql-preflight - Preflight Blockchain SQL Query params: $schema (string), max_rows (integer), sql* (string) tx - Transaction Details by Hash params: hash* (string), chain* (string), include (string) yield-ranking - Yield Pool Ranking params: project (string), sort_by (string) [apy, tvl_usd], order (string) [asc, desc], limit (integer), offset (integer)
Inputs: command (required), params.
surf_prediction_marketSurf Prediction MarketARead-only
Use this when the user needs prediction market data from Surf. Track prediction markets on Polymarket and Kalshi. Browse events and markets, view live prices and odds, analyze trading volume and open interest history, inspect individual trades, and discover top-ranked markets by activity.
Commands: analytics - Prediction Market Analytics params: category (string), platform (string) [polymarket, kalshi], time_range (string) [7d, 30d, 90d, 180d, 1y], top_n (integer), sort_by (string) [volume_7d, whale_flow_net_7d, price_change_7d, oi_change_7d], order (string) [asc, desc], limit (integer), offset (integer) correlations - Market Correlations params: category* (string), condition_id (string), min_correlation (number), limit (integer), offset (integer) kalshi-events - Kalshi Events params: event_ticker (string), limit (integer), offset (integer) kalshi-markets - Kalshi Markets params: market_ticker (string), limit (integer), offset (integer) kalshi-open-interest - Kalshi Open Interest History params: ticker* (string), time_range (string) [7d, 30d, 90d, 180d, 1y] kalshi-orderbooks - Kalshi Orderbook History params: ticker* (string), start_time (integer), end_time (integer), limit (integer), pagination_key (string) kalshi-prices - Kalshi Price History params: ticker* (string), time_range (string) [7d, 30d, 90d, 180d, 1y], interval (string) [1h, 1d, latest] kalshi-trades - Kalshi Trades params: ticker* (string), taker_side (string) [yes, no], min_amount (integer), from (string), to (string), sort_by (string) [timestamp, notional_volume_usd], order (string) [asc, desc], limit (integer), offset (integer) kalshi-volumes - Kalshi Volume History params: ticker* (string), time_range (string) [7d, 30d, 90d, 180d, 1y] matching-market-daily - Cross-Platform Daily Comparison (Polymarket <> Kalshi) params: polymarket_condition_id* (string), kalshi_market_ticker* (string), time_range (string), limit (integer), offset (integer) matching-market-pairs - Cross-Platform Prediction Market Matcher (Polymarket <> Kalshi) params: category (string), match_type (string) [exact, related], active_only (boolean), min_confidence (integer), polymarket_condition_id (string), kalshi_market_ticker (string), sort_by (string) [confidence, polymarket_volume, kalshi_volume, spread_pct], order (string) [asc, desc], limit (integer), offset (integer) polymarket-events - Polymarket Events params: event_slug* (string), limit (integer), offset (integer) polymarket-leaderboard - Polymarket Leaderboard params: sort_by (string) [pnl, volume, trade_count], order (string) [asc, desc], limit (integer), offset (integer) polymarket-markets - Polymarket Markets params: market_slug* (string), limit (integer), offset (integer) polymarket-open-interest - Polymarket Open Interest History params: condition_id* (string), time_range (string) [7d, 30d, 90d, 180d, 1y] polymarket-orderbooks - Polymarket Orderbook History params: token_id* (string), start_time (integer), end_time (integer), limit (integer), pagination_key (string) polymarket-positions - Polymarket Wallet Positions params: address* (string), limit (integer), offset (integer) polymarket-price-ohlcv - Polymarket OHLCV Candlesticks params: condition_id* (string), start_time (integer), end_time (integer), interval (integer) polymarket-prices - Polymarket Price History params: condition_id* (string), time_range (string) [7d, 30d, 90d, 180d, 1y], interval (string) [1h, 1d, latest] polymarket-smart-money - Polymarket Smart Money params: view (string) [positioning, trades], condition_id (string), category (string), direction (string) [bullish, bearish, neutral], whale_tier (string) [whale, large, mega], from (string), to (string), sort_by (string) [smart_wallets_involved, smart_buy_volume_usd, smart_sell_volume_usd, amount_usd, block_time], order (string) [asc, desc], limit (integer), offset (integer) polymarket-trades - Polymarket Trades params: condition_id (string), address (string), type (string) [trade, redemption, all], outcome_label (string) [Yes, No], min_amount (number), from (string), to (string), sort_by (string) [timestamp, notional_volume_usd], limit (integer), offset (integer) polymarket-volume-split - Polymarket Volume Split (YES/NO) params: condition_id* (string), granularity (string) [hour, day, week], start_time (integer), end_time (integer) polymarket-volumes - Polymarket Volume History params: condition_id (string), token_id (string), time_range (string) [7d, 30d, 90d, 180d, 1y], interval (string) [1h, 1d], granularity (string) [day, week, month, year, all], start_time (integer), end_time (integer)
Inputs: command (required), params.
surf_projectSurf ProjectARead-only
Use this when the user needs project data from Surf. Research crypto projects in depth. Retrieve aggregated project profiles covering overview, team, funding rounds, tokenomics, social links, and TGE status. Track DeFi protocol metrics like TVL, fees, revenue, trading volume, and active users over time.
Commands: ai-news - Project AI News params: id (string), q (string), limit (integer), offset (integer), lang (string) [en, zh, ja, kr] defi-metrics - Project DeFi Metrics params: id (string), q (string), metric (string) [volume, fee, fees, revenue, tvl, users], from (string), to (string), chain (string), limit (integer), offset (integer) defi-ranking - DeFi Protocol Ranking params: metric* (string) [tvl, revenue, fees, volume, users], limit (integer), offset (integer) detail - Aggregated Project Detail params: id (string), x_id (string), handle (string), q (string), fields (string) pulse - Project Pulse [Deprecated] params: id (string), q (string), limit (integer), offset (integer), lang (string) [en, zh, ja, kr]
Inputs: command (required), params.
surf_searchSurf SearchARead-only
Use this when the user needs search data from Surf. Find anything across Surf's data universe. Search for crypto projects, news articles, wallet addresses, web pages, investment funds, airdrop opportunities, and prediction market events — all from a single unified search interface.
Commands: airdrop - Airdrop Search params: q (string), phase (string), reward_type (string) [airdrop, points, whitelist, nft, role, ambassador], task_type (string), has_open (boolean), sort_by (string) [total_raise, xscore, last_status_update], order (string) [asc, desc], limit (integer), offset (integer), include_tasks (boolean) airdrop-activities - Airdrop Activities params: limit (integer), offset (integer) events - Project Event Search params: id (string), q (string), type (string), limit (integer), offset (integer) fund - Fund Search params: q* (string), limit (integer), offset (integer) fundraising - Fundraising Event Search params: q (string), from (string), to (string), source (string) [social, news], lang (string) [en, zh, ja, kr], min_importance (integer), sort_by (string) [recency, relevance, importance], order (string) [asc, desc], limit (integer), offset (integer) news - News Article Search params: q* (string), limit (integer), offset (integer) prediction-market - Search Prediction Markets params: condition_id (string), market_ticker (string), platform (string) [polymarket, kalshi], category (string), status (string) [active, closed, finalized], sort_by (string) [volume_1d, volume_7d, volume_30d, open_interest, trade_count_7d, days_to_resolution], order (string) [asc, desc], smart_money (string) [bullish, bearish], q (string), limit (integer), offset (integer) project - Project Search params: q* (string), limit (integer), offset (integer) token - Token Symbol Resolution params: q* (string), chain (string), limit (integer), offset (integer) wallet - Wallet Search params: q* (string), limit (integer), offset (integer) web - Web Search params: q* (string), limit (integer), offset (integer), site (string), include_content (boolean)
Inputs: command (required), params.
surf_signalSurf SignalARead-only
Use this when the user needs signal data from Surf. Explore ranked project signal score snapshots, token-of-day/week highlights, and project-level signal cards with latest price, price-change, dimension scores, compact signals, and AI summaries.
Commands: detail - Signal Detail params: id (string), project_slug (string), time_range (string) [24h, 7d] projects - Signal Projects params: time_range (string) [24h, 7d], limit (integer), offset (integer) token-of-the-day - Signal Token Of The Day params: limit (integer), offset (integer) token-of-week - Signal Token Of The Week params: limit (integer), offset (integer)
Inputs: command (required), params.
surf_tokenSurf TokenARead-only
Use this when the user needs token data from Surf. Analyze individual tokens on-chain. Look up top holders and their share of supply, track ERC-20/SPL token transfers, browse DEX swap history, and view upcoming token unlock schedules with allocation breakdowns.
Commands: dex-trades - Token DEX Trade History params: address* (string), chain (string) [ethereum, base, bsc, arbitrum, tron], limit (integer), offset (integer), include (string) holders - Token Holders params: address* (string), chain* (string), limit (integer), offset (integer), include (string) tokenomics - Token Unlock Schedule params: id (string), symbol (string), from (string), to (string) transfer-counterparties - Top Transfer Counterparties params: address* (string), chain* (string) [ethereum, base, bsc, arbitrum, tron], direction* (string) [to, from], metric (string) [count, amount, amount_usd], time_range (string) [1d, 7d, 30d, 90d], limit (integer), offset (integer), include (string), exclude_labels (string) transfer-stats - Token Transfer Activity Summary params: address* (string), chain* (string) [ethereum, base, bsc, arbitrum, tron], time_range (string) [1d, 7d, 30d, 90d], include (string) transfers - Token Transfer History params: address* (string), chain* (string) [ethereum, base, solana, tron, bsc, arbitrum], from (string), to (string), limit (integer), offset (integer), include (string)
Inputs: command (required), params.
surf_walletSurf WalletARead-only
Use this when the user needs wallet data from Surf. Inspect any wallet on Ethereum, Base, Solana, and other chains. View token balances, NFT holdings, entity labels, transfer history, full transaction logs, DeFi protocol positions (lending, staking, LP), and net worth trends over time.
Commands: detail - Aggregated Wallet Detail params: address* (string), chain (string), fields (string) history - Wallet Transaction History params: address* (string), chain (string), limit (integer), offset (integer), before (integer), sort_by (string) [timestamp, value], order (string) [asc, desc], include (string) labels-batch - Wallet Labels (Batch) params: addresses* (string) net-worth - Wallet Net Worth History params: address* (string) protocols - Wallet DeFi Protocol Positions params: address* (string), limit (integer), offset (integer) transfers - Wallet Transfer History params: address* (string), chain (string) [ethereum, base, solana, tron, bsc, arbitrum], flow (string) [in, out], token (string), limit (integer), offset (integer), include (string)
Inputs: command (required), params.
surf_webSurf WebBRead-only
Use this when the user needs web data from Surf. Fetch and search web content. Retrieve any URL and convert it to clean, LLM-friendly markdown, or search the internet for crypto-related articles, reports, and resources.
Commands: fetch - Web Page Fetch params: url* (string), target_selector (string), remove_selector (string), wait_for_selector (string), timeout (integer)
Inputs: command (required), params.
surf_xSurf XARead-only
Use this when the user needs x data from Surf. Retrieve X posts and author details by numeric post ID.
Commands: tweets - X Tweets by IDs params: ids* (string)
Inputs: command (required), params.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 15 tools
Each top-level tool has a distinct domain prefix (dex, exchange, market, prediction_market, etc.), but there is some overlap: surf_dex and surf_hyperliquid both provide DEX data, and surf_market vs surf_exchange could be confused for price/derivatives data. Descriptions generally help clarify the boundaries.
All tools follow the consistent 'surf_<domain>' naming pattern, and subcommands use lowercase hyphenated names. The convention is uniform across the entire set, making it predictable and easy to navigate.
15 tools is within the ideal 3-15 range, and each tool represents a coherent data domain (market, wallet, token, onchain, etc.). The count feels well-scoped for the server's broad crypto data aggregation purpose.
The tool surface covers a wide range of crypto data needs: market, exchange, DEX, prediction markets, onchain, wallet, token, project, fund, news, search, and web. Minor gaps exist (e.g., surf_dex only offers OHLCV, surf_x only fetches tweets by ID), but these are partial gaps within subdomains rather than severe dead ends.
Maintenance
Related MCP Connectors
Crypto MCP with 21 tools for market data, DeFi, analytics, and sentiment. Post-paid USDC billing.
Production-grade MCP gateway delivering 8 real-time AI tools with instant x402 micropayments settled in USDC on Base Mainnet or SPL-USDC on Solana. Features Basescan contract auditing, wallet analytics, headless browser scraping, and pre-scraped oracle data feeds.
Production-grade MCP gateway delivering 8 real-time AI tools with instant x402 micropayments settled in USDC on Base Mainnet or SPL-USDC on Solana. Features Basescan contract auditing, wallet analytics, headless browser scraping, and pre-scraped oracle data feeds.
Agent MCP: 65 tools — 5-chain verification, risk, prediction & crypto trends, 17 web tools.
Related MCP Servers
- AlicenseAqualityDmaintenanceA comprehensive cryptocurrency market-data MCP server with 49 tools across six data sources, enabling LLMs to answer market questions via natural language.49MIT
- FlicenseNot gradedqualityBmaintenanceEnables AI agents to access real-time crypto market data, volatility alerts, sentiment analysis, risk scores, and market reports through micropayment-gated MCP tools with on-chain settlement.-
- AlicenseBqualityBmaintenanceEnables AI tools to access local crypto market data, run analyses, perform 66-item deep research, search RAG context, and retrieve generated reports and prompts via MCP.10MIT
- AlicenseNot gradedqualityCmaintenanceProvides 59 pay-per-call AI tools covering crypto prices and audits, market and whale data, LLM chat, image generation, web search/fetch/summarize, and utility services, with automatic x402 USDC-on-Base payments and on-chain receipts. It works with Claude Code/Desktop, Cursor, and other MCP clients without API keys or subscriptions.53 npmMIT