MCP Server

The Pyth MCP server gives AI assistants direct, structured access to Pyth market data through the Model Context Protocol. You can discover feeds, fetch real-time and historical prices, replay every update in a short window, and generate chart-ready candles, all within a single conversation.

ToolsCopy Anchor Link

Price tools accept full symbols (Crypto.BTC/USD) or plain pairs (BTC/USD).

API KeyCopy Anchor Link

Every user brings their own Pyth Pro API key; the hosted server has none of its own. See Acquire an API Key.

Give the server your key in one of three ways. A key passed on a call overrides a configured one.

1. In your MCP client's configuration (recommended): your client sends the key as an Authorization: Bearer <key> header on every request. The Setup tabs below show how for each client.
2. As an environment variable, for a local server: set PYTH_PRO_ACCESS_TOKEN in the server's env block.
3. On each call: the access_token parameter. Your assistant asks for the key when none is configured.

get_symbols works without a key. With a key, it also lists feeds visible only to Pro keys and marks each feed entitled: true or false: whether your key can query that feed.

SetupCopy Anchor Link

• Endpoint: https://mcp.pyth.network/mcp
• Transport: Streamable HTTP
• Auth: connecting needs no key; the price tools use your key, sent as an Authorization: Bearer header

Replace YOUR_API_KEY with your Pyth Pro API key.

claude mcp add --transport http pyth https://mcp.pyth.network/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

claude mcp list

Tool ReferenceCopy Anchor Link

Every price tool also takes an optional access_token. Leave it out when your client sends the key.

get_symbolsCopy Anchor Link

Search and list Pyth Pro feeds.

• Each feed has a state. Only stable feeds return prices; beta and coming_soon feeds are listed but cannot be queried yet.
• With a key, each feed carries entitled, and the list includes feeds visible only to Pro keys.

get_latest_priceCopy Anchor Link

Fetch the latest prices for one or more feeds.

* At least one of symbols or price_feed_ids is required.

• Up to 100 feeds per request. If both symbols and price_feed_ids are sent, only the IDs are used.
• properties: price, bestBidPrice, bestAskPrice, exponent, publisherCount, confidence, fundingRate, fundingTimestamp, fundingRateInterval, marketSession, emaPrice, emaConfidence, feedUpdateTimestamp. The default is the first six plus marketSession and feedUpdateTimestamp.
• Prices are integers with an exponent. Each response also carries display_* values (display_price, display_bid, display_ask, display_funding_rate, …) with the exponent applied.

get_historical_priceCopy Anchor Link

Get prices at a single historical timestamp.

* At least one of symbols or price_feed_ids is required.

• Up to 50 feeds per request. If both are sent, only the IDs are used.
• The timestamp is aligned down to the channel's update interval.

get_price_rangeCopy Anchor Link

Return every price update for one or more feeds within a short window, such as the seconds around a liquidation or a news event.

* At least one of symbols or price_feed_ids is required. Up to 50 feeds.

• When has_more is true, call again with the same arguments and after set to next_cursor.

get_candlestick_dataCopy Anchor Link

Fetch OHLC candlestick data for a single feed.

• from must be earlier than to.
• Up to 500 candles per response; larger results come back with truncated: true.
• For funding-rate feeds, candles chart the mark price. Use get_latest_price or get_historical_price for the funding rate itself.

convert_date_to_timestampCopy Anchor Link

Convert a date to Unix timestamps for the other tools. No key needed.

TroubleshootingCopy Anchor Link

"This tool requires your Pyth Pro access token"Copy Anchor Link

• Cause: No key reached the server.
• Fix: Configure the key in your client (see Setup), then restart or reconnect the client. Or pass it as access_token.

Invalid or expired keyCopy Anchor Link

• Cause: The server rejected the key (HTTP 401).
• Fix: Check that the header reads exactly Authorization: Bearer <key>, or get a new key from Acquire an API Key.

Not entitled to a feedCopy Anchor Link

• Cause: Your key is valid, but your plan does not include the feed (HTTP 403). The error names the entitlement group it needs.
• Fix: Run get_symbols with your key and pick feeds with entitled: true.

Symbol not found or ambiguousCopy Anchor Link

• Fix: Use the full symbol or a feed ID from get_symbols. For an ambiguous pair, the error lists the matching feeds.

Feed listed in missing_feed_idsCopy Anchor Link

• Cause: The feed is not live yet (beta or coming_soon), or the channel is faster than the feed's min_channel.
• Fix: Check the feed's state and min_channel in get_symbols, or use a slower channel.

No historical dataCopy Anchor Link

• Fix: Use timestamps from April 2025 onward, and not in the future.

Truncated candlesCopy Anchor Link

• Symptom: Response includes truncated: true
• Fix: Narrow the time range or use a larger resolution.

Next: MCP SkillsCopy Anchor Link

Once the server is connected, you can go beyond raw tool calls with MCP Skills — pre-built prompt templates that teach your AI assistant specific workflows:

• Portfolio tracking — value, allocation, and P&L in one question
• Volatility analysis — annualized vol, ATR, and risk comparison
• FX conversion — cross-rate conversions through Pyth feeds
• Data export — dump OHLC, snapshots, or feed catalogs as CSV/JSON
• And more — price alerts, funding rates, cross-asset comparisons, integration guidance

Local DevelopmentCopy Anchor Link

Optionally run the MCP server locally:

git clone https://github.com/pyth-network/pyth-crosschain.git
cd pyth-crosschain
pnpm install
pnpm --filter @pythnetwork/mcp build

Then configure your client with stdio transport. The local server reads your key from PYTH_PRO_ACCESS_TOKEN:

{
  "mcpServers": {
    "pyth": {
      "command": "node",
      "args": ["<path-to-repo>/apps/mcp/dist/index.js"],
      "env": {
        "PYTH_PRO_ACCESS_TOKEN": "YOUR_API_KEY"
      }
    }
  }
}