Pyth Pro MCP Server

Get the price dataof forone specificor more feeds at aone historicalpast timestamp.instant. PassRequires yourthe user's own Pyth Pro access token. If the user configured it in their MCP client, omit `access_token`; otherwise pass it as `access_token`, toand authenticateif the request.tool Usereports it missing, ask the user for it. Symbols can be full names from get_symbols first(e.g. 'Crypto.BTC/USD', 'Equity.US.AAPL/USD') or bare pairs like 'BTC/USD'. A bare pair resolves to findthe live spot feed IDswhen orthere symbols.is one, otherwise to the only remaining live match; `resolved_symbols` in the response shows what each input resolved to, and an ambiguous input returns an error listing the candidates. If both price_feed_ids and symbols are provided, only price_feed_ids are used. AcceptsThe timestamp accepts Unix seconds, milliseconds, or microseconds (auto-detected) and is rounded down to the channel rate (e.g. a multiple of 200 ms for fixed_rate@200ms). Historical data is available from April 2025 onward —onward; do not request timestampstimes before that. The timestamp isRequested internallyfeeds convertedthat toreturn microsecondsno andprice alignedare (roundedlisted down)in to`missing_feed_ids` the(e.g. channelbeta rateor —coming_soon e.g.feeds, foror fixed_rate@200ms,a itchannel mustfaster bethan divisiblethe byfeed's 200,000μs.min_channel). Prices are integers with an exponent field —: human-readable price = price * 10^exponent. Pre-computed display_pricedisplay_* fields are(display_price, includeddisplay_bid, display_ask, display_confidence, display_ema_price, display_ema_confidence, display_funding_rate) apply the exponent for convenience.you. Price tools: get_latest_price for now, get_historical_price for one past instant, get_price_range for every update within up to 60 seconds, get_candlestick_data for OHLC bars over longer periods.

Timestamp reference (Unix seconds):
  2025-04-01 (earliest available) = 1743465600
  2026-01-01 = 1767225600
  2026-06-01 = 1780272000
Always double-check your timestamp math — (year-boundary errors are common.common), or use convert_date_to_timestamp.

 ⟨5 unchanged words⟩ ,"properties":{"access_token":{"description":"The user's own Pyth Pro access tokentoken. usedOmit toit authenticatewhen the request.user configured one in their MCP client; a value here overrides that. Get one at https://docs.pyth.network/price-feeds/pro/acquire-access-token","minLength":1,"pattern":"^[\\x21-\\x7E]+$","type":"string"},"channel":{"description":"Override the default channel (e.g.update fixed_rate@200ms,rate): real_time, fixed_rate@50ms, fixed_rate@1000ms)fixed_rate@200ms, fixed_rate@1000ms. Must not be faster than the feed's min_channel.","patternenum":["^(real_time|fixed_rate@\\d+ms)$

Get the most recent real-time price for one or more feeds. Requires anthe user's own Pyth Pro access token. If the user configured it in their MCP client, omit `access_token`; otherwise pass it as `access_token`, parameterand (getif onethe attool https://docs.pyth.network/price-feeds/pro/acquire-access-token).reports Useit missing, ask the user for it. Symbols can be full names from get_symbols first(e.g. 'Crypto.BTC/USD', 'Equity.US.AAPL/USD') or bare pairs like 'BTC/USD'. A bare pair resolves to findthe symbolslive orspot feed IDs.when IMPORTANT:there symbolsis mustone, beotherwise to the fullonly nameremaining includinglive assetmatch; type`resolved_symbols` prefixin (e.g.the 'Crypto.BTC/USD'response shows what each input resolved to, notand 'BTC/USD').an ambiguous input returns an error listing the candidates. If both price_feed_ids and symbols are provided, only price_feed_ids are used. Requested feeds that return no price are listed in `missing_feed_ids` (e.g. beta or coming_soon feeds, or a channel faster than the feed's min_channel). Prices are integers with an exponent field —: human-readable price = price * 10^exponent. Pre-computed display_pricedisplay_* fields are(display_price, includeddisplay_bid, display_ask, display_confidence, display_ema_price, display_ema_confidence, display_funding_rate) apply the exponent for convenience.you. Price tools: get_latest_price for now, get_historical_price for one past instant, get_price_range for every update within up to 60 seconds, get_candlestick_data for OHLC bars over longer periods.

 ⟨5 unchanged words⟩ ,"properties":{"access_token":{"description":"The user's own Pyth Pro access token. Omit it when the user configured one in their MCP client; a value here overrides that. Get one at https://pyth.network/pricing//docs.pyth.network/price-feeds/pro/acquire-access-token","minLength":1,"pattern":"^[\\x21-\\x7E]+$","type":"string"},"channel":{"description":"Override the default channel (e.g.update fixed_rate@200ms,rate): real_time, fixed_rate@50ms, fixed_rate@1000ms)fixed_rate@200ms, fixed_rate@1000ms. Must not be faster than the feed's min_channel.","patternenum":["^(real_time|fixed_rate@\\d+ms)$real_time","fixed_rate@50ms","fixed_rate@200ms","fixed_rate@1000ms"],"type":"string"},"price_feed_ids":{"description":"Numeric feed IDs (pyth_lazer_id) from get_symbolsget_symbols. Max 100.","items":{"exclusiveMinimum":0,"type" ⟨5 unchanged words⟩ 

 ⟨11 unchanged words⟩ what feeds exist before calling get_latest_price, get_historical_price, get_price_range or get_candlestick_data.get_candlestick_data (those also accept bare pairs like BTC/USD). Filter by asset_type (e.g. crypto, equity, fx, metal, ratescommodity, commodityinterest-rate, funding-rate, kalshi) or search by name/symbol. Narrow further with instrument_type (spot, future, ...) or symbol_chain_id (all contracts of one futures chain, e.g. VX). Retired (inactive) feeds are hidden unless include_inactive is true. Returns compact feed metadata: includingsymbol, name, description, pyth_lazer_id, asset_type, instrument_type, state, exponent, min_channel (neededfastest forchannel get_historical_pricethe feed supports), symbolquote_currency, asset_typeand where set groups (entitlement groups that gate the feed), expiration_time and exponent.symbol_chain_id (futures). Pass verbose: true for every catalog field, e.g. market_sessions (trading-hours schedules) and corporate_actions (e.g. stock splits). With an access token, the list also includes feeds visible only to Pro keys, and each feed has `entitled`: true means this key can query the feed right now. When `entitled` is false, `not_entitled_reason` says why: `not_live (...)` means the feed is in beta, not live yet, or retired, so no key can query it (NOT a plan limitation), `requires one of entitlement groups: ...` means the user's plan lacks that entitlement.

{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":false,"properties":{"access_token":{"description":"Optional. The user's own Pyth Pro access token; omit it when the user configured one in their MCP client. With a token the list includes feeds visible only to Pro keys, and each feed gets an `entitled` flag.","minLength":1,"pattern":"^[\\x21-\\x7E]+$","type":"string"},"asset_type":{"description":"Filter by asset type: crypto, crypto-index, crypto-redemption-rate, fx, equity, metal, rates, interest-rate, nav, commodity, funding-rate, eco, kalshi","enum":["crypto","crypto-index","crypto-redemption-rate","fx","equity","metal","rates","interest-rate","nav","commodity","funding-rate","eco","kalshi"],"type":"string"},"include_inactive":{"default":false,"description":"Include retired feeds (state 'inactive'). Default false: inactive feeds are hidden.","type":"boolean"},"instrument_type":{"description":"Filter by instrument type: spot, future, perp, rate, index, nav","enum":["spot","future","perp","rate","index","nav"],"type":"string"},"limit":{"default":50,"description":"Results ⟨29 unchanged words⟩ 'BTC', 'gold', 'AAPL')","type":"string"},"symbol_chain_id":{"description":"Filter futures by chain ID, exact and case-sensitive (e.g. 'VX' for all VIX futures contracts)","minLength":1,"type":"string"},"verbose":{"default":false,"description":"Return every catalog field (trading schedules, market_sessions, corporate_actions, hermes_id, ...). Default false: compact feeds, about 4x smaller.","type":"boolean"}},"type":"object"}