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_CALLper call (default 0.01) andMAX_USDC_PER_SESSIONper 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_KEYwith 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:
- https://market-hours-api.onrender.com
- https://futures-expiry-api.onrender.com
- https://trading-time-api.onrender.com
- https://macro-data-api-313m.onrender.com
- https://market-calendar-api.onrender.com
- https://filings-specs-api.onrender.com
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)
| File | Size | Uploaded | |
|---|---|---|---|
| x402_market_data_mcp-0.2.0.tar.gz | 12.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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 logRelease 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