0xarchive Mcp
0xArchiveIO/0xarchive-mcp · 13 stars · MIT
MCP server Historical crypto market data API and MCP server for Hyperliquid, Lighter.xyz, and HIP-3. Query order books, trades, candles, funding rates, open interest, liquidations, and data quality metrics from April 2023.
Install
The repo has no one-line install. Follow its README.
Files
0xArchive MCP
Query Hyperliquid and Lighter market data from your agent. Get current and historical order books, trades, candles, funding, open interest, and data coverage through read-only market-data tools, and manage webhooks when you grant webhook access.
Connect · Agents and clients · Data · Examples · Troubleshooting
Connect
Server URL
https://mcp.0xarchive.io/mcp
Add the URL as a remote HTTP MCP server, then sign in with your 0xArchive account through the client's OAuth flow. Approve the mcp:market.read permission when prompted; approve mcp:webhooks.read and mcp:webhooks.write as well if you want the webhook tools. No 0xArchive API key or local MCP server installation is required.
Start with:
Get a BTC market summary on Hyperliquid.
Agents and clients
If you already have MCP servers configured, add 0xArchive without replacing the other entries.
Claude Code
claude mcp add --transport http 0xarchive https://mcp.0xarchive.io/mcp
In Claude Code, run /mcp, select 0xarchive, and choose Authenticate. Complete the browser sign-in, then ask for a BTC market summary.
Claude web, Desktop, and Cowork
- Open Customize → Connectors in Claude.
- Click + → Add custom connector.
- Name it
0xArchiveand enterhttps://mcp.0xarchive.io/mcp. - Add the connector, click Connect, and complete the OAuth sign-in.
- Enable it from + → Connectors in your conversation.
For Team and Enterprise workspaces, an owner first adds the connector in Organization settings → Connectors; each member then connects their own account.
ChatGPT
- Enable Developer mode in Settings → Security & Login.
- Open Plugins and use the + button to add an MCP connection.
- Name it
0xArchive, enterhttps://mcp.0xarchive.io/mcp, and complete OAuth authentication. - Start a new conversation and select the connection from + → More.
Codex CLI and IDE extension
codex mcp add 0xarchive --url https://mcp.0xarchive.io/mcp
Complete the OAuth sign-in. To start authentication separately, run:
codex mcp login 0xarchive
The CLI and IDE extension share MCP configuration. Use /mcp in the Codex terminal interface to check the connection.
Cursor
Add this entry to .cursor/mcp.json in your project. For a user-wide connection, use ~/.cursor/mcp.json.
{
"mcpServers": {
"0xarchive": {
"url": "https://mcp.0xarchive.io/mcp"
}
}
}
Open Cursor's MCP settings, connect 0xarchive, and complete the OAuth sign-in. Enable the server's tools for Agent.
VS Code and GitHub Copilot
Run MCP: Add Server from the Command Palette, choose an HTTP server, and enter https://mcp.0xarchive.io/mcp.
Or add it to .vscode/mcp.json:
{
"servers": {
"0xarchive": {
"type": "http",
"url": "https://mcp.0xarchive.io/mcp"
}
}
}
Start the server and complete the browser OAuth flow. Use MCP: List Servers to check its status, then enable the tools you need in chat.
Antigravity CLI and Gemini CLI
Antigravity CLI is the current choice for personal Google accounts. Add this to .agents/mcp_config.json in your project:
{
"mcpServers": {
"0xarchive": {
"serverUrl": "https://mcp.0xarchive.io/mcp"
}
}
}
Open /mcp in Antigravity CLI to reload the configuration and check the server. Complete its OAuth authentication prompt. Use serverUrl, not Gemini CLI's httpUrl field.
Gemini CLI remains available with Gemini Code Assist Standard/Enterprise licenses or paid Google API access. From your project directory:
gemini mcp add --transport http 0xarchive https://mcp.0xarchive.io/mcp
Start Gemini and run:
/mcp auth 0xarchive
Complete the browser OAuth flow. /mcp shows the server and its available tools.
Antigravity MCP documentation · Gemini CLI MCP documentation · Google client availability
Grok web and Grok Build
Grok web
- Open Grok Connectors.
- Choose New Connector → Custom.
- Enter
https://mcp.0xarchive.io/mcpand complete the OAuth sign-in. - Ask for 0xArchive market data in your conversation.
For Business and Enterprise organizations, a team admin first provisions the connector.
Grok Build
grok mcp add --transport http 0xarchive https://mcp.0xarchive.io/mcp
Grok starts the OAuth flow when the server is first used. In the terminal interface, /mcps opens the MCP settings; i starts authentication for the selected server.
Hermes Agent
hermes mcp add --url https://mcp.0xarchive.io/mcp --auth oauth 0xarchive
Authenticate with your 0xArchive account:
hermes mcp login 0xarchive
Run hermes mcp test 0xarchive to check the connection. If prompted to choose tools, enable the markets and data you need.
OpenClaw
Add the remote server with OAuth:
openclaw mcp set 0xarchive '{
"url": "https://mcp.0xarchive.io/mcp",
"transport": "streamable-http",
"auth": "oauth",
"oauth": {"scope": "mcp:market.read"}
}'
Then sign in:
openclaw mcp login 0xarchive
Run openclaw mcp doctor 0xarchive --probe to check the connection. Use OpenClaw's MCP tool controls to choose which agents or sessions can use it.
OpenCode
Add this entry to opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"0xarchive": {
"type": "remote",
"url": "https://mcp.0xarchive.io/mcp",
"enabled": true
}
}
}
Authenticate:
opencode mcp auth 0xarchive
Complete the browser sign-in. opencode mcp list shows the authentication status.
Windsurf and Devin
Devin Local and Devin CLI
Devin Local, the default agent for new editor tabs, uses the Devin MCP configuration. From your project directory:
devin mcp add 0xarchive https://mcp.0xarchive.io/mcp
Then authenticate:
devin mcp login 0xarchive
Cascade
If you use Cascade, add this to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"0xarchive": {
"serverUrl": "https://mcp.0xarchive.io/mcp"
}
}
}
Open Cascade's MCP settings, enable the server, and complete its OAuth sign-in. Select the tools you need if you reach the client's tool limit. Sign in separately in each client you use.
Cline
- Open Cline's MCP Servers panel and the Remote Servers tab.
- Enter
0xarchiveas the name andhttps://mcp.0xarchive.io/mcpas the URL. - Choose Streamable HTTP and click Add Server.
- Click Authenticate when the server requests OAuth, then finish the browser sign-in.
If Authenticate is missing, update Cline before connecting.
Other MCP clients
Use the same server URL with a client that supports Streamable HTTP and OAuth. Let the client discover the authorization server and complete sign-in. Do not substitute an API key or a manually pasted bearer token.
For custom integrations, the server publishes OAuth resource metadata. See the MCP authorization specification for the client flow.
What you can query
- Hyperliquid core perps: market summaries, prices, trades, candles, CVD, funding, open interest, liquidations, L2 and L4 order books, order history, order flow, trigger orders, market breadth, and wallet classification.
- Hyperliquid Spot: pair discovery, trades, candles, order books, L4 snapshots and diffs, order history, TWAP records, and freshness.
- HIP-3 builder perps: market discovery and summaries, trades, candles, CVD, funding, open interest, liquidations, L2 and L4 books, orders, market breadth, oracle external prices and discovery bounds, and wallet classification. Builder-prefixed symbols such as
xyz:SP500identify the market. - HIP-4 outcome markets: instruments, outcomes and questions, prices, candles, trades, open interest, order history, and L2 and L4 books.
- Lighter (mainnet and Robinhood Chain): market discovery and summaries, trades, candles, funding, open interest, liquidations, and order books; L3 order books on mainnet.
- Account positions: current and historical positions, position changes, and account summaries by Hyperliquid wallet or Lighter account index, plus per-market position listings.
- Webhooks: endpoints, subscriptions, estimate and dry-run previews, watched wallets, and the delivery log, when your client connects with webhook access.
Hyperliquid core and HIP-3 also expose projected forced-liquidation price levels and trigger-price levels. Data-quality tools provide coverage, freshness (including account positions), incident, latency, and status information.
Examples include get_summary, get_hip3_instruments, get_spot_pairs, get_hip4_outcomes, get_lighter_l3_orderbook, and get_symbol_coverage. Your client discovers the available tools and their input schemas when it connects.
Venue and dataset coverage · MCP tool examples · Data quality
Example requests
Market summary
Get a BTC market summary on Hyperliquid. Include the source timestamp.
Funding across venues
Fetch current BTC funding separately for Hyperliquid and Lighter. Show each source's units and timestamp before comparing the values.
Historical candles
Fetch ETH one-hour Hyperliquid candles for the last 24 hours. Summarize the price range and trading volume.
Builder markets
Find the HIP-3 market
xyz:SP500and get its current summary and order book.
Spot markets
Find Hyperliquid Spot pairs for HYPE, then fetch recent trades for the matching pair.
Outcome markets
List unsettled HIP-4 outcomes. Show the question and current price for one of them.
Order-level data
Fetch the current BTC L3 order book on Lighter and show the top bids and asks.
Historical coverage
Check BTC coverage on Hyperliquid for the last 24 hours and list any recorded data incidents in that window.
Working with historical data
Specify the venue, market, and UTC interval. For longer histories, use smaller windows and follow pagination when a cursor is returned. If a response is too large, narrow the request rather than treating the returned portion as the complete dataset.
Keep timestamps and source units with the values, especially when comparing funding across venues. Use market discovery to resolve symbols, and coverage tools to find available history.
For bulk Parquet files, use the Data Catalog. For continuous market-data streams, use the WebSocket API.
Account and access
Sign in with your 0xArchive account. Data access and usage limits follow your 0xArchive plan; your AI client's own subscription and custom-connector permissions are separate.
Troubleshooting
| Problem | What to check |
|---|---|
| The client opens documentation or reports an invalid server response | Use the full URL https://mcp.0xarchive.io/mcp, including /mcp, and choose HTTP rather than stdio. |
Sign-in fails or the server returns 401 |
Reconnect through the client's OAuth flow. Remove manually configured API-key or authorization headers. |
| The client says 0xArchive already exists | Edit or reconnect the existing server entry instead of adding a duplicate. |
| The connection succeeds but tools are unavailable | Check the client's MCP enablement and tool selection, then refresh or restart it after configuration changes. |
| A market is not found | Use the relevant instrument, Spot-pair, or outcome discovery tool. Preserve builder prefixes and symbol case. |
| A historical request is empty or rejected | Check the market's recorded coverage and your plan's history window. |
| A request times out or returns too much data | Shorten the interval, reduce the requested page size where available, or use a Parquet export for a bulk dataset. |
| Requests are rate-limited | Allow the retry interval to pass and check your plan's usage limits before retrying. |
Help
Keep access tokens, API keys, and private account information out of prompts and public issues.
Facts
- Kind
- MCP server
- Group
- Uncategorized
- Stars
- 13
- License
- MIT
- Last push
- 2026-10-08
- Forks
- 4
- Homepage
- www.0xarchive.io/github-mcp
- Topics
- crypto, hyperliquid, market-data, mcp, mcp-server, model-context-protocol, agents, claude, codex, lighterxyz, 0xarchive, gemini-cli-extension
- 1REAio.github.morluto/reaReverse engineer anything from your terminal or agent with one CLI and MCP server.125.3k
- 2com.browser-use/browser-usecom.browser-use/browser-useControl a real Chrome browser to complete any task: fill forms, extract data, book flights.117.7k
- 3World Monitorapp.worldmonitor/mcpLive markets, conflicts, country risk, chokepoints, energy, and China decision signals. 93 tools.88.3k
- 4Scrapling MCP Serverd4vinci/scrapling🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scraplingdev86.9k
- 5Everythingmodelcontextprotocol/serversThis MCP server attempts to exercise all the features of the MCP protocol. It is not intended to be a useful server, but rather a test server for builders of MCP clients. It implements prompts, tools, resources, sampling, and more to showcase MCP capabilities.85.8k
- 6Fetchmodelcontextprotocol/serversA Model Context Protocol server that provides web content fetching capabilities. This server enables LLMs to retrieve and process content from web pages, converting HTML to markdown for easier consumption.85.8k