How do I install Market Data (x402)?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Market Data (x402) need an API key?

The publisher lists these environment variables: X402_KEY_FILE, X402_PRIVATE_KEY, MAX_USDC_PER_CALL, MAX_USDC_PER_SESSION.

What transport does Market Data (x402) use?

Market Data (x402) runs locally over stdio.

When was Market Data (x402) last checked?

Last checked 2026-11-10. Paid-per-call data for agents: trading calendars, futures, macro, LEI, VAT, risk events (x402)

Market Data (x402) MCP server

1{2 "mcpServers": {3 "io.github.r0dell-market-data-mcp": {4 "command": "uvx",5 "args": [6 "x402-market-data-mcp==0.5.0"7 ],8 "env": {9 "X402_KEY_FILE": "<value>",10 "X402_PRIVATE_KEY": "<secret>",11 "MAX_USDC_PER_CALL": "<value>",12 "MAX_USDC_PER_SESSION": "<value>"13 }14 }15 }16}

Market Data MCP

An MCP server that gives AI assistants and agents 32 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.01–0.02 USDC
Futures	`futures_front_month`, `futures_expirations`, `futures_roll_calendar`	0.01–0.02 USDC
Trading time	`settlement_date`, `fx_sessions`, `dst_gaps`, `is_dst_gap`, `market_countdown`	0.01–0.02 USDC
Macro	`treasury_yield_curve`, `treasury_spread`, `ecb_fx_rate`, `ecb_convert`, `cot_positioning`	0.01–0.02 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.01–0.02 USDC
Briefing	`trading_briefing` – all market-moving events of the next days in one call	0.03 USDC
Futures specs	`contract_spec`, `futures_tick_value`, `futures_position_size`	0.01 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.05) and MAX_USDC_PER_SESSION per server start (default 1.00).

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": "1.00"
      }
    }
  }
}

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

Market Data (x402)

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions