Pyth Pro MCP Server

Official5 toolsLive

by pyth-network · TypeScript

Real-time and historical price feeds for 500+ crypto, equities, FX, and commodities assets.

Pyth Network MCP Server (io.github.pyth-network/mcp)

The Pyth Pro MCP server exposes real-time and historical market data from Pyth to AI assistants. It provides access to 500+ price feeds spanning crypto, equities, FX, commodities, and related assets via the hosted endpoint https://mcp.pyth.network/mcp.

🛠️ Key Features

Real-time and historical price feeds
Covers 500+ assets
Asset categories include crypto, equities, FX, and commodities
Hosted at https://mcp.pyth.network/mcp
Exposes 5 tools

🚀 Use Cases

Query current and past prices for supported assets
Retrieve market data across multiple asset classes
Build assistants that reference Pyth-based pricing

⚡ Developer Benefits

MCP integration point for market data
Single endpoint for accessing Pyth price feeds
Compatible with MCP client configuration (e.g., Claude Desktop, Claude Code, Cursor)

Captured live from the server via tools/list.

get_symbols

List available Pyth Pro price feeds. Use this FIRST to discover what feeds exist before calling get_latest_price, get_historical_price, or get_candlestick_data. Filter by asset_type (crypto, equity, fx, metal, rates, commodity, funding-rate) or search by name/symbol. Returns feed metadata including pyth_lazer_id (needed for get_historical_price), symbol, asset_type, and exponent.

Parameters4

asset_type	string	optional	Filter by asset type: crypto, fx, equity, metal, rates, commodity, funding-rate
limit	integer	optional	Results per page (default 50, max 200)
offset	integer	optional	Pagination offset (default 0)
query	string	optional	Text filter (e.g. 'BTC', 'gold', 'AAPL')

Raw schema

{
  "type": "object",
  "properties": {
    "asset_type": {
      "type": "string",
      "enum": [
        "crypto",
        "fx",
        "equity",
        "metal",
        "rates",
        "commodity",
        "funding-rate"
      ],
      "description": "Filter by asset type: crypto, fx, equity, metal, rates, commodity, funding-rate"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "default": 50,
      "description": "Results per page (default 50, max 200)"
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "default": 0,
      "description": "Pagination offset (default 0)"
    },
    "query": {
      "type": "string",
      "description": "Text filter (e.g. 'BTC', 'gold', 'AAPL')"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

convert_date_to_timestamp

Convert a date string to Unix timestamp for use with get_historical_price and get_candlestick_data. Use this tool when you need to compute timestamps — do not calculate Unix timestamps manually. Accepts ISO 8601 dates (e.g. '2026-01-01', '2026-01-01T12:00:00Z'). Returns seconds, microseconds, ISO 8601, and whether the date is within the available data range (April 2025 onward).

Parameters1

date_string

string

required

Date to convert. Must be ISO 8601 / RFC 3339 with timezone (e.g. '2026-01-01T00:00:00Z', '2026-01-01'). Bare dates without timezone are interpreted as UTC.

Raw schema

{
  "type": "object",
  "properties": {
    "date_string": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Date to convert. Must be ISO 8601 / RFC 3339 with timezone (e.g. '2026-01-01T00:00:00Z', '2026-01-01'). Bare dates without timezone are interpreted as UTC."
    }
  },
  "required": [
    "date_string"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_candlestick_data

Fetch OHLC candlestick data for a symbol. Pass your Pyth Pro `access_token` to authenticate the request. Use for charting, technical analysis, backtesting. IMPORTANT: The symbol must be the full name from get_symbols including the asset type prefix (e.g. 'Crypto.BTC/USD', 'Equity.US.AAPL', 'FX.EUR/USD') — never use bare names like 'BTC/USD'. Historical data is available from April 2025 onward — do not request timestamps before that. Resolutions: 1/5/15/30/60 minutes, 120/240/360/720 (multi-hour), D (daily), W (weekly), M (monthly). Timestamps are Unix seconds. 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.

Parameters6

access_token	string	optional	Pyth Pro access token used to authenticate the request. Get one at https://docs.pyth.network/price-feeds/pro/acquire-access-token
channel	string	optional	Override default channel (e.g. fixed_rate@200ms, real_time, fixed_rate@50ms, fixed_rate@1000ms)
from	integer	required	Start time (Unix seconds)
resolution	string	required	Candle size: 1, 5, 15, 30, 60 (minutes), 120, 240, 360, 720 (hours), D (daily), W (weekly), M (monthly)
symbol	string	required	Full symbol from get_symbols including asset type prefix (e.g. 'Crypto.BTC/USD', not 'BTC/USD')
to	integer	required	End time (Unix seconds)

Raw schema

{
  "type": "object",
  "properties": {
    "access_token": {
      "type": "string",
      "minLength": 1,
      "description": "Pyth Pro access token used to authenticate the request. Get one at https://docs.pyth.network/price-feeds/pro/acquire-access-token"
    },
    "channel": {
      "type": "string",
      "pattern": "^(real_time|fixed_rate@\\d+ms)$",
      "description": "Override default channel (e.g. fixed_rate@200ms, real_time, fixed_rate@50ms, fixed_rate@1000ms)"
    },
    "from": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Start time (Unix seconds)"
    },
    "resolution": {
      "type": "string",
      "enum": [
        "1",
        "5",
        "15",
        "30",
        "60",
        "120",
        "240",
        "360",
        "720",
        "D",
        "W",
        "M"
      ],
      "description": "Candle size: 1, 5, 15, 30, 60 (minutes), 120, 240, 360, 720 (hours), D (daily), W (weekly), M (monthly)"
    },
    "symbol": {
      "type": "string",
      "minLength": 1,
      "description": "Full symbol from get_symbols including asset type prefix (e.g. 'Crypto.BTC/USD', not 'BTC/USD')"
    },
    "to": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "End time (Unix seconds)"
    }
  },
  "required": [
    "from",
    "resolution",
    "symbol",
    "to"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_historical_price

Get price data for specific feeds at a historical timestamp. Pass your Pyth Pro `access_token` to authenticate the request. Use get_symbols first to find feed IDs or symbols. If both price_feed_ids and symbols are provided, only price_feed_ids are used. Accepts Unix seconds, milliseconds, or microseconds (auto-detected). Historical data is available from April 2025 onward — do not request timestamps before that. The timestamp is internally converted to microseconds and aligned (rounded down) to the channel rate — e.g. for fixed_rate@200ms, it must be divisible by 200,000μs. Prices are integers with an exponent field — human-readable price = price * 10^exponent. Pre-computed display_price fields are included for convenience. Timestamp reference: 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.

Parameters5

access_token	string	optional	Pyth Pro access token used to authenticate the request. Get one at https://docs.pyth.network/price-feeds/pro/acquire-access-token
channel	string	optional	Override default channel (e.g. fixed_rate@200ms, real_time, fixed_rate@50ms, fixed_rate@1000ms)
price_feed_ids	array	optional	Numeric feed IDs from get_symbols
symbols	array	optional	Full symbol names from get_symbols including asset type prefix (e.g. ['Crypto.BTC/USD', 'Equity.US.AAPL/USD'])
timestamp	number	required	Unix timestamp — accepts seconds, milliseconds, or microseconds (auto-detected by magnitude)

Raw schema

{
  "type": "object",
  "properties": {
    "access_token": {
      "type": "string",
      "minLength": 1,
      "description": "Pyth Pro access token used to authenticate the request. Get one at https://docs.pyth.network/price-feeds/pro/acquire-access-token"
    },
    "channel": {
      "type": "string",
      "pattern": "^(real_time|fixed_rate@\\d+ms)$",
      "description": "Override default channel (e.g. fixed_rate@200ms, real_time, fixed_rate@50ms, fixed_rate@1000ms)"
    },
    "price_feed_ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0
      },
      "maxItems": 50,
      "description": "Numeric feed IDs from get_symbols"
    },
    "symbols": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 50,
      "description": "Full symbol names from get_symbols including asset type prefix (e.g. ['Crypto.BTC/USD', 'Equity.US.AAPL/USD'])"
    },
    "timestamp": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Unix timestamp — accepts seconds, milliseconds, or microseconds (auto-detected by magnitude)"
    }
  },
  "required": [
    "timestamp"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_latest_price

Get the most recent real-time price for one or more feeds. Requires an `access_token` parameter (get one at https://docs.pyth.network/price-feeds/pro/acquire-access-token). Use get_symbols first to find symbols or feed IDs. IMPORTANT: symbols must be the full name including asset type prefix (e.g. 'Crypto.BTC/USD', not 'BTC/USD'). If both price_feed_ids and symbols are provided, only price_feed_ids are used. Prices are integers with an exponent field — human-readable price = price * 10^exponent. Pre-computed display_price fields are included for convenience.

Parameters5

access_token	string	required	Pyth Pro access token. Get one at https://pyth.network/pricing
channel	string	optional	Override default channel (e.g. fixed_rate@200ms, real_time, fixed_rate@50ms, fixed_rate@1000ms)
price_feed_ids	array	optional	Numeric feed IDs from get_symbols
properties	array	optional	Properties to return. Default: price, bestBidPrice, bestAskPrice, confidence, exponent, publisherCount
symbols	array	optional	Full symbol names from get_symbols including asset type prefix (e.g. ['Crypto.BTC/USD', 'Equity.US.AAPL/USD'])

Raw schema

{
  "type": "object",
  "properties": {
    "access_token": {
      "type": "string",
      "minLength": 1,
      "description": "Pyth Pro access token. Get one at https://pyth.network/pricing"
    },
    "channel": {
      "type": "string",
      "pattern": "^(real_time|fixed_rate@\\d+ms)$",
      "description": "Override default channel (e.g. fixed_rate@200ms, real_time, fixed_rate@50ms, fixed_rate@1000ms)"
    },
    "price_feed_ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0
      },
      "maxItems": 100,
      "description": "Numeric feed IDs from get_symbols"
    },
    "properties": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Properties to return. Default: price, bestBidPrice, bestAskPrice, confidence, exponent, publisherCount"
    },
    "symbols": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 100,
      "description": "Full symbol names from get_symbols including asset type prefix (e.g. ['Crypto.BTC/USD', 'Equity.US.AAPL/USD'])"
    }
  },
  "required": [
    "access_token"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

apps/mcp/README.md3 KBView on GitHub

Pyth Pro MCP Server

MCP server that gives AI assistants access to real-time and historical market data from Pyth — 500+ price feeds across crypto, equities, FX, commodities, and more.

Hosted at https://mcp.pyth.network/mcp

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

json

{
  "mcpServers": {
    "pyth": {
      "url": "https://mcp.pyth.network/mcp"
    }
  }
}

Claude Code

claude mcp add pyth --transport http https://mcp.pyth.network/mcp

Cursor

Add to .cursor/mcp.json in your project:

json

{
  "mcpServers": {
    "pyth": {
      "url": "https://mcp.pyth.network/mcp"
    }
  }
}

Windsurf / Other Clients

Any MCP client that supports StreamableHTTP can connect using the URL:

code

https://mcp.pyth.network/mcp

Tools

Tool	Description	Auth Required
`get_symbols`	Search and list available price feeds	No
`get_latest_price`	Real-time prices for one or more feeds	Yes (access token)
`get_historical_price`	Point-in-time price snapshots	Yes (access token)
`get_candlestick_data`	OHLC candlestick bars for charting and analysis	Yes (access token)
`convert_date_to_timestamp`	Convert date strings to Unix timestamps	No

Tip: Use get_symbols first to discover available feeds before calling other tools.

Access Token

An access token is required for get_latest_price, get_historical_price, and get_candlestick_data. get_symbols and convert_date_to_timestamp work without one.

Get a token at pyth.network/pricing
The token is passed as a tool parameter — your AI assistant will ask for it when needed

Example Queries

Try these with any connected AI assistant:

"What's the current price of Bitcoin?"
"Show me the ETH/USD price history for the last 24 hours"
"Compare the prices of gold and silver right now"
"Get daily candlestick data for AAPL over the past week"
"What crypto price feeds are available on Pyth?"

Local Development

For contributors working on the MCP server itself.

Build

pnpm --filter @pythnetwork/mcp build

MCP Inspector

Run the inspector to interactively test tools:

npx @modelcontextprotocol/inspector --cli -- pnpm --filter @pythnetwork/mcp start:dev

Local stdio config

To connect a client to a local build via stdio:

json

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

Environment Variables

Variable	Default	Description
`PYTH_PRO_ACCESS_TOKEN`	—	Bearer token for Router API
`PYTH_CHANNEL`	`fixed_rate@200ms`	Default price channel
`PYTH_LOG_LEVEL`	`info`	Log level (debug/info/warn/error)
`PYTH_REQUEST_TIMEOUT_MS`	`10000`	HTTP request timeout

Install

Tools (5)

get_symbolsconvert_date_to_timestampget_candlestick_dataget_historical_priceget_latest_price

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.pyth.network/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.pyth.network/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Pyth Pro MCP Server

Pyth Network MCP Server (io.github.pyth-network/mcp)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

get_symbols

convert_date_to_timestamp

get_candlestick_data

get_historical_price

get_latest_price

Pyth Pro MCP Server

Quick Start

Claude Desktop

Claude Code

Cursor

Windsurf / Other Clients

Tools

Access Token

Example Queries

Local Development

Build

MCP Inspector

Local stdio config

Environment Variables

Links

Install

Remote endpoint

Related servers