Model Context Protocol (MCP)

Interact with the Velo API using AI agents

By using Velo's Model Context Protocol (MCP) server, you can have AI agents interact with the Velo API. To access the MCP, you will need an API key.

Install

Connect your AI agent to Velo MCP by running any of the commands below.

codex mcp add velo --url https://velo.xyz/api/mcp --bearer-token-env-var VELO_API_KEY
export VELO_API_KEY=<your api key>

claude mcp add velo --scope user --transport http https://velo.xyz/api/mcp --header 'Authorization: Bearer <your api key>'

opencode mcp add
MCP server name: velo
MCP server type: remote
MCP server url: https://velo.xyz/api/mcp
Require oauth? No

For opencode, you also need to open opencode.jsonc and add the Authorization header to authenticate.

"velo": {
  "type": "remote",
  "url": "https://velo.xyz/api/mcp",
  "headers": {
    "Authorization": "Bearer <API KEY HERE>"
  }
}

Tools

The Velo MCP server exposes the following read-only tools:

Resource	Tool	Description
Market data	`market_data`	Get current or historical spot, futures, and options market data. Includes OHLCV, trades, open interest, funding rates, liquidations, basis, and options metrics.
Products	`market_data_products`	Search the products/symbols available.
Orderbook	`orderbook`	Get historical futures orderbook depth for an exchange product or a Velo-aggregated coin.
Orderbook products	`orderbook_products`	Search the futures products available for orderbook data.
Market caps	`market_caps`	Get market cap data for Velo-aggregated coins. Includes current circulating supply, market capitalization, fully diluted supply, and fully diluted valuation.
News	`news`	Get news headlines.

To see a list of the supported API endpoints, please visit the API section.

Examples

Screen top performing Trade.xyz assets in last 24 hours

# Prompt
> show me the top 10 trade.xyz assets that went up the most in last 24h using velo mcp

# Response
• Called
  └ velo.market_data_products({"category":"futures","exchange":"hyperliquid"})
• Called
  └ velo.market_data({
• ...
• Top 10 trade.xyz assets by exact 24-hour price gain, using Velo MCP’s one-
  minute Hyperliquid data:
 
     #    Asset      Market         24h ago      Latest     Change
  ━━━━━  ━━━━━━━━━  ━━━━━━━━━━━━  ━━━━━━━━━━  ━━━━━━━━━━  ━━━━━━━━━
     1    PLTR       xyz:PLTR        139.56      160.42    +14.95%
  ─────  ─────────  ────────────  ──────────  ──────────  ─────────
     2    ARM        xyz:ARM         239.27      271.97    +13.67%
  ─────  ─────────  ────────────  ──────────  ──────────  ─────────
     3    MRVL       xyz:MRVL        195.16      215.83    +10.59%
  ─────  ─────────  ────────────  ──────────  ──────────  ─────────
     4    KIOXIA     xyz:KIOXIA      320.62      349.43     +8.99%
  ─────  ─────────  ────────────  ──────────  ──────────  ─────────
     5    SNDK       xyz:SNDK      1,296.60    1,404.70     +8.34%
  ─────  ─────────  ────────────  ──────────  ──────────  ─────────
     6    INTC       xyz:INTC        90.972       98.12     +7.86%
  ─────  ─────────  ────────────  ──────────  ──────────  ─────────
     7    LITE       xyz:LITE        782.91      842.36     +7.59%
  ─────  ─────────  ────────────  ──────────  ──────────  ─────────
     8    MU         xyz:MU          829.60      882.72     +6.40%
  ─────  ─────────  ────────────  ──────────  ──────────  ─────────
     9    SAMSUNG    xyz:SMSN        168.21      178.36     +6.03%
  ─────  ─────────  ────────────  ──────────  ──────────  ─────────
    10    AVGO       xyz:AVGO        392.34      415.58     +5.92%
 
  Snapshot: August 4, 2026 at 21:17 UTC, compared with the same minute 24 hours
  earlier. Universe: all 51 xyz: markets available through Velo’s Hyperliquid
  futures catalog.

HYPE/BTC performance in the last 7 days

# Prompt
> show me how hype/btc trade have performed in the last 7 days on hyperliquid using velo mpc

# Response
• Called
  └ velo.market_data({"category":"futures","exchanges":
        ["hyperliquid"],"products":["HYPE-USD","BTC-USD"],"columns":
        ["close_price"],"resolution":{"unit":"minutes","value":1},"begin":"2026-
        08-04T21:14:00.000Z","end":"2026-08-04T21:30:00.000Z"})
• ...
• A long-HYPE / short-BTC trade lost approximately 0.72% over the last seven
  days, before funding and fees. HYPE underperformed BTC.
 
   Metric      Jul 28, 21:28 UTC    Aug 4, 21:28 UTC    Return
  ━━━━━━━━━━  ━━━━━━━━━━━━━━━━━━━  ━━━━━━━━━━━━━━━━━━  ━━━━━━━━
   HYPE                  $55.334             $55.229    −0.19%
  ──────────  ───────────────────  ──────────────────  ────────
   BTC                   $63,892             $64,231    +0.53%
  ──────────  ───────────────────  ──────────────────  ────────
   HYPE/BTC           0.00086606          0.00085985    −0.72%
 
  Daily HYPE/BTC performance:
 
   Date        HYPE/BTC    Cumulative
  ━━━━━━━━  ━━━━━━━━━━━━  ━━━━━━━━━━━━
   Jul 28    0.00086606             —
  ────────  ────────────  ────────────
   Jul 29    0.00083918        −3.10%
  ────────  ────────────  ────────────
   Jul 30    0.00085637        −1.12%
  ────────  ────────────  ────────────
   Jul 31    0.00083497        −3.59%
  ────────  ────────────  ────────────
   Aug 1     0.00082955        −4.22%
  ────────  ────────────  ────────────
   Aug 2     0.00083048        −4.11%
  ────────  ────────────  ────────────
   Aug 3     0.00085029        −1.82%
  ────────  ────────────  ────────────
   Aug 4     0.00085985        −0.72%
 
  The trade bottomed around −4.22% at the daily observation on August 1, then
  recovered most of the loss. Conversely, short HYPE / long BTC returned roughly
  +0.72%.
 
  Source: Velo MCP, synchronized one-minute closes for Hyperliquid HYPE-USD and
  BTC-USD. Returns exclude funding, trading fees and slippage.