Which integrations are available for this server?

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.

How do I use Surf MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. 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 Server

Official

by asksurf-ai

Overview Schema Related Servers Score Discussions

TypeScript

Remote

surf-mcp

MCP server for the Surf crypto data API. Dynamically generates tools from the OpenAPI spec — 12 grouped tools covering 86 endpoints across market data, wallets, social, on-chain queries, and more.

Quick start

Add to your MCP client config — no clone or install needed:

{
  "mcpServers": {
    "surf": {
      "command": "npx",
      "args": ["-y", "@surf-ai/surf-mcp"],
      "env": {
        "SURF_API_KEY": "your-api-key"
      }
    }
  }
}

Or with Bun:

{
  "mcpServers": {
    "surf": {
      "command": "bunx",
      "args": ["@surf-ai/surf-mcp"],
      "env": {
        "SURF_API_KEY": "your-api-key"
      }
    }
  }
}

Prerequisites

A Surf API key (get one here)
Node.js 20+ or Bun

Config file locations

Claude Code: .mcp.json in project root or ~/.claude.json
Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
Cursor: MCP settings in the IDE

Related MCP server: agentpulse-mcp

Tools

The server exposes 12 tools, one per API domain. Each tool accepts a command and optional params:

Tool	Commands	Description
`surf_market`	`price`, `ranking`, `etf`, `futures`, `options`, `fear-greed`, `liquidation-*`, `onchain-indicator`, `price-indicator`	Market overview, rankings, indicators, ETF flows
`surf_exchange`	`depth`, `klines`, `funding-history`, `perp`, `price`, `markets`, `long-short-ratio`	Live exchange data from Binance, OKX, Bybit, etc.
`surf_wallet`	`detail`, `transfers`, `history`, `net-worth`, `protocols`, `labels-batch`	Wallet balances, transfers, DeFi positions
`surf_token`	`holders`, `dex-trades`, `transfers`, `tokenomics`	Token holder analysis, DEX trades, unlocks
`surf_social`	`detail`, `user`, `user-posts`, `tweets`, `mindshare`, `ranking`, `smart-followers-history`, `tweet-replies`, `user-followers`, `user-following`, `user-replies`	X (Twitter) social signals and sentiment
`surf_project`	`detail`, `defi-metrics`, `defi-ranking`	Project profiles, DeFi TVL/fees/revenue
`surf_onchain`	`sql`, `tx`, `gas-price`, `schema`, `bridge-ranking`, `yield-ranking`, `structured-query`	On-chain SQL queries, tx lookup, gas prices
`surf_search`	`project`, `wallet`, `news`, `web`, `fund`, `polymarket`, `kalshi`, `airdrop`, `events`, `social-people`, `social-posts`	Unified search across all data types
`surf_prediction_market`	`kalshi-`, `polymarket-`, `matching-*`, `category-metrics`	Polymarket and Kalshi prediction markets
`surf_fund`	`detail`, `portfolio`, `ranking`	Crypto VC fund profiles and portfolios
`surf_news`	`feed`, `detail`	Crypto news from major outlets
`surf_web`	`fetch`	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 ..." } })
"ETH social sentiment"         → surf_social({ command: "detail", params: { q: "ethereum" } })

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 through @surf-ai/sdk for HTTP transport and auth

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 typecheck            # Type check

License

MIT

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/asksurf-ai/surf-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server