Provides tools for fetching Binance trading data including OHLCV data for spot and futures markets, mark prices, funding rates, and open interest information.
crypto-mcp
A minimal Model Context Protocol (MCP) server deployed on Vercel for ChatGPT Developer Mode. The
baseline functionality (tag v1.0.0) exposes four core tools that allow ChatGPT to search for a
symbol, fetch 24h ticker data, retrieve candlestick data, and run a sample dice roll.
Baseline tools
Tool name | Description |
| Parses a symbol query (e.g.
) and returns an ID for
|
| Returns Binance 24h ticker data for an ID produced by
|
| Retrieves recent candlestick data for a Binance spot symbol |
| Retrieves USDⓈ-M perpetual (futures) candlestick data |
| Demonstration tool from the MCP starter template |
Advanced tools (
price_action_summary, risk policy/order drafting, confirmations, scheduler) are gated behind the environment variableENABLE_ADVANCED_TOOLS=true. They remain disabled on the public deployment to maximize ChatGPT compatibility.
SSE endpoint
/api/sse returns a lightweight heartbeat stream so that ChatGPT can probe the SSE transport
without requiring Redis. Streaming conversations are handled via the Streamable HTTP endpoint
(/api/mcp).
Important: ChatGPT validates the presence of
searchandfetch. Do not remove or rename them; new tools should be added alongside these baseline ones.
Requirements
Node.js 20+
pnpm 9+
Getting started
The development server listens on http://localhost:3000. You can inspect the MCP endpoint with:
Local verification
Before opening a pull request run the smoke test which builds the project, starts next start on a
random port, and executes the search → fetch → get_binance_klines flow.
The CI workflow runs the same script on every push and pull request. The command fails if any of the baseline tools are missing or return an error.
Deploying to Vercel
Push your changes to GitHub.
Ensure the repository is linked to Vercel and that the build command is
pnpm install && pnpm build.After deployment, verify the public endpoint:
curl -s https://<your-domain>/api/mcp \ -H 'Content-Type: application/json' \ -H 'Accept: application/json, text/event-stream' \ -d '{"jsonrpc":"2.0","id":"1","method":"tools/list","params":{}}'Add the MCP server in ChatGPT Developer Mode by specifying the full URL
https://<your-domain>/api/mcp.
Contributing
See CONTRIBUTING.md for contribution rules, including why the baseline tools and SSE configuration must remain intact.
Release Notes
Historical milestones and release tags are tracked in docs/CHANGELOG.md.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables users to fetch real-time cryptocurrency market data from Binance including OHLCV prices, mark prices, funding rates, and open interest for both spot and futures markets. Provides easy access to Binance trading data through a simple JSON-RPC interface.