pyth-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PYTH_ROOT | No | Selects the project root when --root is not provided. State is stored under .pyth-mcp/. | |
| PYTH_API_KEY | Yes | Bearer token required by current Hermes API policy. Set PYTH_API_KEY before live price retrieval because Pyth now requires an API key for Hermes price updates. The API key is sent only as `Authorization: Bearer ...`. | |
| PYTH_RETRIES | No | Retries for 429, 5xx, and network errors | 2 |
| PYTH_BASE_URL | No | Hermes API origin | https://hermes.pyth.network |
| PYTH_TIMEOUT_MS | No | Per-request timeout in milliseconds | 10000 |
| PYTH_CACHE_TTL_MS | No | Latest-price cache TTL in milliseconds | 30000 |
| PYTH_CATALOG_TTL_MS | No | Feed catalog cache TTL in milliseconds | 3600000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| pyth_get_priceB | Get the latest Pyth price, confidence interval, EMA price, exponent, publish time, and staleness for one symbol or feed id. |
| pyth_get_pricesC | Get latest Pyth prices for up to 100 symbols or feed ids, using independent per-feed cache entries. |
| pyth_get_price_historyA | Return the in-memory price history recorded during this session for one symbol or feed id, newest last. |
| pyth_list_feedsB | Search the Pyth Hermes price feed catalog by symbol or description, with a one-hour catalog cache by default. |
| pyth_resolve_feedA | Resolve a symbol such as BTC/USD or a 64-character hexadecimal id to canonical Pyth feed metadata. |
| pyth_stream_pricesB | Stream live Pyth price updates from the Hermes streaming endpoint for up to 100 feeds, collecting updates for a bounded duration. |
| pyth_pingA | Check Pyth Hermes API reachability with a small live feed catalog request. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool has a clearly distinct role: single latest price, batch latest prices, session price history, streaming updates, catalog search, feed resolution, and API ping. The single-vs-batch-vs-history-vs-stream boundaries are explicit in the descriptions, so an agent can select the right tool without ambiguity.
All tools use a consistent pyth_ prefix followed by mostly verb_noun names such as get_price, list_feeds, resolve_feed, and stream_prices. The only minor deviation is pyth_ping, which lacks a noun component, but it is still readable and conventional.
Seven tools is a well-scoped surface for a Pyth price-feed MCP server. Each operation covers a meaningful capability without redundant variants or excessive fragmentation.
The set covers reachability, feed discovery/resolution, latest single and batch prices, session history, and bounded streaming, which handles the core data-retrieval workflows. A minor gap is that historical prices are only session-recorded rather than queryable from a broader Hermes time range.