English Français العربية

Market Data (x402)

Official registry Productivity

Paid-per-call market data for agents: trading calendars, futures, macro, contract specs (x402)

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package x402-market-data-mcp
Claude Code 
claude mcp add market-data-x402 -e 'X402_KEY_FILE=<X402_KEY_FILE>' -e 'X402_PRIVATE_KEY=<your x402_private_key>' -e 'MAX_USDC_PER_CALL=0.01' -e 'MAX_USDC_PER_SESSION=0.10' -- uvx x402-market-data-mcp==0.2.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "market-data-x402": {
            "command": "uvx",
            "args": [
                "x402-market-data-mcp==0.2.1"
            ],
            "env": {
                "X402_KEY_FILE": "<X402_KEY_FILE>",
                "X402_PRIVATE_KEY": "<your x402_private_key>",
                "MAX_USDC_PER_CALL": "0.01",
                "MAX_USDC_PER_SESSION": "0.10"
            }
        }
    }
}

Environment variables

  • X402_KEY_FILE Path to a file with the private key of a small, dedicated payment wallet (plain text or JSON with private_key). Without it only free tools work.
  • X402_PRIVATE_KEY secret Alternative to X402_KEY_FILE: private key of a small, dedicated payment wallet.
  • MAX_USDC_PER_CALL Highest price per call in USDC
  • MAX_USDC_PER_SESSION Total budget per server start in USDC

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Market Data MCP
  2. How payment works
  3. Install (Claude Desktop, Cursor, any MCP client)
  4. Direct HTTP use
  5. Disclaimer

Market Data MCP

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

AreaToolsPrice per call
Exchange hoursmarket_is_open, market_next_open_close, market_holidays0.01–0.02 USDC
Futuresfutures_front_month, futures_expirations, futures_roll_calendar0.01–0.02 USDC
Trading timesettlement_date, fx_sessions, dst_gaps, is_dst_gap, market_countdown0.01–0.02 USDC
Macrotreasury_yield_curve, treasury_spread, ecb_fx_rate, ecb_convert, cot_positioning0.01–0.02 USDC
Calendarsoptions_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_dates0.01–0.02 USDC
Briefingtrading_briefing – all market-moving events of the next days in one call0.03 USDC
Futures specscontract_spec, futures_tick_value, futures_position_size0.01 USDC
Freecatalog_list, payment_status, list_markets, list_futures_products, list_cot_marketsfree

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

Frequently asked questions

What is Market Data (x402)?

Paid-per-call market data for agents: trading calendars, futures, macro, contract specs (x402)

How do I install Market Data (x402)?

It runs on your machine. In Claude Code: claude mcp add market-data-x402 -e 'X402_KEY_FILE=<X402_KEY_FILE>' -e 'X402_PRIVATE_KEY=<your x402_private_key>' -e 'MAX_USDC_PER_CALL=0.01' -e 'MAX_USDC_PER_SESSION=0.10' -- uvx x402-market-data-mcp==0.2.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Market Data (x402) need an API key?

Yes. It expects X402_PRIVATE_KEY, which you set in its configuration.

Is Market Data (x402) open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Market Data (x402)?

It is published by r0dell. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.