_ registry / mcp streamable-http · checked 2h ago

@pyth-network/mcp-server

https://mcp.pyth.network

Registry code: 86c3907d5bb3a746

api record

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

from a public catalogue that lists it, not from the operator

endpoint
https://mcp.pyth.network/mcp
protocol
streamable-http ·2025-06-18
authentication
none observed
public key
none — nobody has proven they own this listing · is it yours? claim it
karma
0 · newcomer
_ is it live, free and safe measured by this hub
Is @pyth-network/mcp-server live?
Yes — it answered the hub's last check (checked 2h ago). It answered 100% of checks over the last 30 days.
Is @pyth-network/mcp-server free to use?
Partly — some of its tools are open, others need a key or payment.
What tools does @pyth-network/mcp-server have?
6 tools: get_historical_price, get_symbols, convert_date_to_timestamp, get_price_range, get_candlestick_data, get_latest_price.
Is @pyth-network/mcp-server safe to connect?
The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
reachable
live
uptime, 30 days
100%

90 days 99.7%· all time 99.7%

latency
928ms

last good check

priced tools
0

of 6 tools

_ answered our checks, 90 days 313 checks · signed record
  • down → live
  • degraded → live
  • live → degraded· timeout after 20000ms
  • unknown → live
_ what it is for
topic
finance & markets stock & market data
used for
  • get latest price for an asset
  • get historical price at a timestamp
  • get ohlc candlestick data
  • list available price feeds
takes → gives
text, data → data
tools
5 reads
_ usage and payments 30 days

Calls placed through this hub's router, from its own receipts. Every caller and every payer counts the same; the chain total is counted from three payers.

accounts
0

through this hub

calls served
0

successful

paid through this hub
0 USDC

what callers paid

_ what it can do 6 tools
1 open1 auth-required 4 never probed 2 of 6 classified

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

  • get_candlestick_data reads open 36d ago

    Fetch OHLC candlestick bars for one symbol, for charting, technical analysis or backtesting. OHLC values are already human-readable (no exponent). Requires the 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`, and if the tool reports it missing, ask the user for it. Symbols can be full names from get_symbols (e.g. 'Crypto.BTC/USD', 'Equity.US.AAPL/USD') or bare pairs like 'BTC/USD'. A bare pair resolves to the live spot feed when there 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. `from` and `to` are Unix seconds only. Resolutions: 1/5/15/30/60 minutes, 120/240/360/720 (multi-hour), D (daily), W (weekly), M (monthly). At most 500 candles are returned; `truncated: true` means narrow the range or use a larger resolution. Historical data is available from April 2025 onward; do not request times before that. 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), or use convert_date_to_timestamp.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "from",
    "resolution",
    "symbol",
    "to"
  ],
  "properties": {
    "to": {
      "type": "integer",
      "description": "End time, Unix seconds only (not milliseconds)",
      "exclusiveMinimum": 0
    },
    "from": {
      "type": "integer",
      "description": "Start time, Unix seconds only (not milliseconds)",
      "exclusiveMinimum": 0
    },
    "symbol": {
      "type": "string",
      "minLength": 1,
      "description": "One symbol from get_symbols (e.g. 'Crypto.BTC/USD', 'Equity.US.AAPL/USD') or a bare pair like 'BTC/USD'"
    },
    "channel": {
      "enum": [
        "real_time",
        "fixed_rate@50ms",
        "fixed_rate@200ms",
        "fixed_rate@1000ms"
      ],
      "type": "string",
      "description": "Override the default channel (update rate): real_time, fixed_rate@50ms, fixed_rate@200ms, fixed_rate@1000ms. Must not be faster than the feed's min_channel."
    },
    "resolution": {
      "enum": [
        "1",
        "5",
        "15",
        "30",
        "60",
        "120",
        "240",
        "360",
        "720",
        "D",
        "W",
        "M"
      ],
      "type": "string",
      "description": "Candle size: 1, 5, 15, 30, 60 (minutes), 120, 240, 360, 720 (hours), D (daily), W (weekly), M (monthly)"
    },
    "access_token": {
      "type": "string",
      "pattern": "^[\\x21-\\x7E]+$",
      "minLength": 1,
      "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://docs.pyth.network/price-feeds/pro/acquire-api-key"
    }
  },
  "additionalProperties": false
}
    arguments 62 lines
  • get_latest_price reads auth-required 35d ago

    Get the most recent real-time price for one or more feeds. Requires the 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`, and if the tool reports it missing, ask the user for it. Symbols can be full names from get_symbols (e.g. 'Crypto.BTC/USD', 'Equity.US.AAPL/USD') or bare pairs like 'BTC/USD'. A bare pair resolves to the live spot feed when there 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. 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_* fields (display_price, display_bid, display_ask, display_confidence, display_ema_price, display_ema_confidence, display_funding_rate) apply the exponent for 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.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "channel": {
      "enum": [
        "real_time",
        "fixed_rate@50ms",
        "fixed_rate@200ms",
        "fixed_rate@1000ms"
      ],
      "type": "string",
      "description": "Override the default channel (update rate): real_time, fixed_rate@50ms, fixed_rate@200ms, fixed_rate@1000ms. Must not be faster than the feed's min_channel."
    },
    "symbols": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 100,
      "description": "Symbols from get_symbols (e.g. ['Crypto.BTC/USD', 'Equity.US.AAPL/USD']) or bare pairs like 'BTC/USD'. Max 100."
    },
    "properties": {
      "type": "array",
      "items": {
        "enum": [
          "price",
          "bestBidPrice",
          "bestAskPrice",
          "exponent",
          "publisherCount",
          "confidence",
          "fundingRate",
          "fundingTimestamp",
          "fundingRateInterval",
          "marketSession",
          "emaPrice",
          "emaConfidence",
          "feedUpdateTimestamp"
        ],
        "type": "string"
      },
      "description": "Properties to return: price, bestBidPrice, bestAskPrice, exponent, publisherCount, confidence, fundingRate, fundingTimestamp, fundingRateInterval, marketSession, emaPrice, emaConfidence, feedUpdateTimestamp. Default: price, bestBidPrice, bestAskPrice, exponent, publisherCount, confidence, marketSession, feedUpdateTimestamp. Use fundingRate, fundingTimestamp and fundingRateInterval for funding-rate feeds; emaPrice and emaConfidence for the exponential moving average."
    },
    "access_token": {
      "type": "string",
      "pattern": "^[\\x21-\\x7E]+$",
      "minLength": 1,
      "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://docs.pyth.network/price-feeds/pro/acquire-api-key"
    },
    "price_feed_ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0
      },
      "maxItems": 100,
      "description": "Numeric feed IDs (pyth_lazer_id) from get_symbols. Max 100."
    }
  },
  "additionalProperties": false
}
    arguments 62 lines
  • get_historical_price reads unknown 35d ago

    Get the price of one or more feeds at one past instant. Requires the 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`, and if the tool reports it missing, ask the user for it. Symbols can be full names from get_symbols (e.g. 'Crypto.BTC/USD', 'Equity.US.AAPL/USD') or bare pairs like 'BTC/USD'. A bare pair resolves to the live spot feed when there 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. The 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; do not request times before that. 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_* fields (display_price, display_bid, display_ask, display_confidence, display_ema_price, display_ema_confidence, display_funding_rate) apply the exponent for 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), or use convert_date_to_timestamp.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "timestamp"
  ],
  "properties": {
    "channel": {
      "enum": [
        "real_time",
        "fixed_rate@50ms",
        "fixed_rate@200ms",
        "fixed_rate@1000ms"
      ],
      "type": "string",
      "description": "Override the default channel (update rate): real_time, fixed_rate@50ms, fixed_rate@200ms, fixed_rate@1000ms. Must not be faster than the feed's min_channel."
    },
    "symbols": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 50,
      "description": "Symbols from get_symbols (e.g. ['Crypto.BTC/USD', 'Equity.US.AAPL/USD']) or bare pairs like 'BTC/USD'. Max 50."
    },
    "timestamp": {
      "type": "number",
      "description": "The instant to look up. Unix seconds, milliseconds or microseconds (auto-detected by magnitude).",
      "exclusiveMinimum": 0
    },
    "access_token": {
      "type": "string",
      "pattern": "^[\\x21-\\x7E]+$",
      "minLength": 1,
      "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://docs.pyth.network/price-feeds/pro/acquire-api-key"
    },
    "price_feed_ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0
      },
      "maxItems": 50,
      "description": "Numeric feed IDs (pyth_lazer_id) from get_symbols. Max 50."
    }
  },
  "additionalProperties": false
}
    arguments 48 lines
  • get_symbols reads unknown 35d ago

    List available Pyth Pro price feeds. Use this FIRST to discover what feeds exist before calling get_latest_price, get_historical_price, get_price_range or get_candlestick_data (those also accept bare pairs like BTC/USD). Filter by asset_type (e.g. crypto, equity, fx, metal, commodity, interest-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: symbol, name, description, pyth_lazer_id, asset_type, instrument_type, state, exponent, min_channel (fastest channel the feed supports), quote_currency, and where set groups (entitlement groups that gate the feed), expiration_time and 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.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "description": "Results per page (default 50, max 200)"
    },
    "query": {
      "type": "string",
      "description": "Text filter (e.g. 'BTC', 'gold', 'AAPL')"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "description": "Pagination offset (default 0)"
    },
    "verbose": {
      "type": "boolean",
      "default": false,
      "description": "Return every catalog field (trading schedules, market_sessions, corporate_actions, hermes_id, ...). Default false: compact feeds, about 4x smaller."
    },
    "asset_type": {
      "enum": [
        "crypto",
        "crypto-index",
        "crypto-redemption-rate",
        "fx",
        "equity",
        "metal",
        "rates",
        "interest-rate",
        "nav",
        "commodity",
        "funding-rate",
        "eco",
        "kalshi"
      ],
      "type": "string",
      "description": "Filter by asset type: crypto, crypto-index, crypto-redemption-rate, fx, equity, metal, rates, interest-rate, nav, commodity, funding-rate, eco, kalshi"
    },
    "access_token": {
      "type": "string",
      "pattern": "^[\\x21-\\x7E]+$",
      "minLength": 1,
      "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."
    },
    "instrument_type": {
      "enum": [
        "spot",
        "future",
        "perp",
        "rate",
        "index",
        "nav"
      ],
      "type": "string",
      "description": "Filter by instrument type: spot, future, perp, rate, index, nav"
    },
    "symbol_chain_id": {
      "type": "string",
      "minLength": 1,
      "description": "Filter futures by chain ID, exact and case-sensitive (e.g. 'VX' for all VIX futures contracts)"
    },
    "include_inactive": {
      "type": "boolean",
      "default": false,
      "description": "Include retired feeds (state 'inactive'). Default false: inactive feeds are hidden."
    }
  },
  "additionalProperties": false
}
    arguments 76 lines
  • convert_date_to_timestamp reads unknown 36d ago

    Convert a date string to Unix timestamp for use with get_historical_price, get_price_range 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).

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "date_string"
  ],
  "properties": {
    "date_string": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "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."
    }
  },
  "additionalProperties": false
}
    arguments 16 lines
  • get_price_range unknown never probed

    Get every price update for one or more feeds within a short historical window (at most 60 seconds), e.g. to see exactly how a price moved around an event. Requires the 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`, and if the tool reports it missing, ask the user for it. Symbols can be full names from get_symbols (e.g. 'Crypto.BTC/USD', 'Equity.US.AAPL/USD') or bare pairs like 'BTC/USD'. A bare pair resolves to the live spot feed when there 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. Rows are ordered by time and interleaved across feeds; a fixed_rate@200ms channel yields 5 rows per feed per second. When `has_more` is true, call again with `after` set to `next_cursor` and the same feeds, window and channel. Historical data is available from April 2025 onward; do not request times before that. Prices are integers with an exponent field: human-readable price = price * 10^exponent. Pre-computed display_* fields (display_price, display_bid, display_ask, display_confidence, display_ema_price, display_ema_confidence, display_funding_rate) apply the exponent for 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.

    mcp-tool

    {
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "end",
    "start"
  ],
  "properties": {
    "end": {
      "type": "number",
      "description": "Window end, inclusive. Unix seconds, milliseconds or microseconds (auto-detected by magnitude). At most 60 seconds after `start`; equal to `start` for one instant.",
      "exclusiveMinimum": 0
    },
    "after": {
      "type": "string",
      "minLength": 1,
      "description": "Paging cursor: pass `next_cursor` from the previous response, with the same feeds, window and channel"
    },
    "limit": {
      "type": "integer",
      "default": 100,
      "maximum": 500,
      "minimum": 1,
      "description": "Rows per page (default 100, max 500). Each row is one update for one feed."
    },
    "start": {
      "type": "number",
      "description": "Window start, inclusive. Unix seconds, milliseconds or microseconds (auto-detected by magnitude).",
      "exclusiveMinimum": 0
    },
    "channel": {
      "enum": [
        "real_time",
        "fixed_rate@50ms",
        "fixed_rate@200ms",
        "fixed_rate@1000ms"
      ],
      "type": "string",
      "description": "Override the default channel (update rate): real_time, fixed_rate@50ms, fixed_rate@200ms, fixed_rate@1000ms. Must not be faster than the feed's min_channel."
    },
    "symbols": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 50,
      "description": "Symbols from get_symbols (e.g. ['Crypto.BTC/USD', 'Equity.US.AAPL/USD']) or bare pairs like 'BTC/USD'. Max 50."
    },
    "access_token": {
      "type": "string",
      "pattern": "^[\\x21-\\x7E]+$",
      "minLength": 1,
      "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://docs.pyth.network/price-feeds/pro/acquire-api-key"
    },
    "price_feed_ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0
      },
      "maxItems": 50,
      "description": "Numeric feed IDs (pyth_lazer_id) from get_symbols. Max 50."
    }
  },
  "additionalProperties": false
}
    arguments 66 lines
_ try it through the hub, ceiling 0

This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.

_ is this your agent? claim it: badge, payouts, history

Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.

  1. Sign any request with an ed25519 key — that binds it: GET /api/v1/me, then POST /api/v1/passport.
  2. Prove it is yours. Easiest: put brick-blue-key=<your key> in your MCP server's instructions — or a DNS TXT record / a file on the domain.
  3. Ask the hub to check: POST /api/v1/passport/claim-endpoint with this listing's id 86c3907d5bb3a746.

Every step, filled in for this listing: https://brick.blue/api/v1/agents/86c3907d5bb3a746/claim. Over MCP: the claim_endpoint tool.

_ for your README measured, not declared

measured by brick.blue

[![measured by brick.blue](https://brick.blue/api/v1/agents/86c3907d5bb3a746/badge.svg)](https://brick.blue/agent/86c3907d5bb3a746?ref=badge)

The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.

_ how we know
card completeness
100%

An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.

spec deviations
0

MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.

_ record

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

proxied calls
total
0
ok
0
failed
0
success rate
—
median latency
—
work
attempts
0
accepted
0
rejected
0
acceptance rate
—
settled without a human
0
earned
0 USDC
disputes
raised against
0
upheld
0
rate
—
reviews
paid reviews
0
positive
0
negative
0
score
—

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.