Skip to main content

Market Data MCP

An MCP server that gives AI assistants and agents 33 paid market-data tools plus 5 free helper tools:

Area Tools Price per call
Exchange hours market_is_open, market_next_open_close, market_holidays 0.001–0.002 USDC
Futures futures_front_month, futures_expirations, futures_roll_calendar 0.001–0.002 USDC
Trading time settlement_date, fx_sessions, dst_gaps, is_dst_gap, market_countdown 0.001–0.002 USDC
Macro treasury_yield_curve, treasury_spread, ecb_fx_rate, ecb_convert, cot_positioning 0.001–0.002 USDC
Calendars options_expiration_check, options_expiration_calendar, vix_expirations, economic_release_next, economic_releases, central_bank_next_meeting, central_bank_meetings, treasury_auctions, treasury_next_auction, is_banking_day, banking_holidays, index_rebalance_dates 0.001–0.002 USDC
Filings & specs sec_filings, insider_transactions, contract_spec, futures_tick_value, futures_position_size 0.001–0.002 USDC
Free catalog_list, payment_status, list_markets, list_futures_products, list_cot_markets free

Exchanges: NYSE, Nasdaq, LSE, Xetra, SIX, Tokyo, Hong Kong, Shanghai, ASX, CME equity futures. Futures: ES, MES, NQ, MNQ, YM, MYM, RTY, M2K, FDAX, FDXM, FESX, FSMI. Macro data comes from the U.S. Treasury (public domain), the ECB (euro reference rates; source: ECB statistics) and the CFTC Commitments of Traders report (public domain).

How payment works

Each paid tool calls an HTTP API protected by x402. The server pays automatically in USDC on Base, using a wallet key you provide, and only:

  • to the known wallets of these APIs (any other payee is refused),
  • in USDC on Base mainnet,
  • up to MAX_USDC_PER_CALL per call (default 0.01) and MAX_USDC_PER_SESSION per server start (default 0.10).

Without a key the free tools work and paid tools explain how to enable payment.

Use a separate, small wallet for X402_PRIVATE_KEY with only a few USDC on Base. Never use your main wallet. No ETH is needed for gas; the x402 facilitator pays it.

Install (Claude Desktop, Cursor, any MCP client)

Requires uv. Add this to your MCP client config (Claude Desktop: Settings → Developer → Edit Config):

{
  "mcpServers": {
    "market-data": {
      "command": "uvx",
      "args": ["--from", "x402-market-data-mcp", "market-data-mcp"],
      "env": {
        "X402_KEY_FILE": "C:\\path\\to\\wallet.json",
        "MAX_USDC_PER_SESSION": "0.10"
      }
    }
  }
}

X402_KEY_FILE points to a file with the key (plain text or JSON with private_key); alternatively set X402_PRIVATE_KEY directly. Without uv: pip install x402-market-data-mcp and use "command": "python", "args": ["-m", "market_data_mcp"].

Then ask for example: "Is the NYSE open on 27 November 2026 at 18:00 UTC?", "What is the ES roll date in December?" or "Show the current US yield curve and the 2s10s spread."

Direct HTTP use

The same data is available as x402 HTTP APIs, listed in the Coinbase x402 Bazaar:

Disclaimer

Data is provided as is, without warranty. Not investment advice. Always confirm critical dates with the exchange.

License: MIT

Metadata

Release files for x402-market-data-mcp 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for x402-market-data-mcp 0.2.0
File Size Uploaded
x402_market_data_mcp-0.2.0.tar.gz 12.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for x402-market-data-mcp 0.2.0
File Interpreter ABI Platform
x402_market_data_mcp-0.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 24.4 kB

Release files / x402_market_data_mcp-0.2.0.tar.gz

Download URL x402_market_data_mcp-0.2.0.tar.gz
Size 12.6 kB
Tags Source
SHA-256 checksum
How to use checksums
a7de257face5d0a02fa5ca55e119494dc429e6610e98344b339322278df6457a
BLAKE2b-256 checksum
How to use checksums
34f343cefb2688353920d7f0cc2046c46e1442decc30114dc3a8c6f7089da9f9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

Release files / x402_market_data_mcp-0.2.0-py3-none-any.whl

Download URL x402_market_data_mcp-0.2.0-py3-none-any.whl
Size 11.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
197691ab3aa531fe8c2c85b9cffeada406bfe7d5089869648a69bf4257ce4a35
BLAKE2b-256 checksum
How to use checksums
059349965fdead7618297b261e248f0cfbe2277d159e868288e33cd39bfd6180
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

Release history Release notifications | RSS feed

0.2.1

2 release files

This release

0.2.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page