English Français العربية

Market Data (x402)

Registre officiel Productivité

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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
Configuration JSON (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"
            }
        }
    }
}

Variables d'environnement

  • 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

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que Market Data (x402) ?

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

Comment installer Market Data (x402) ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Market Data (x402) ?

Oui. Il attend X402_PRIVATE_KEY, à renseigner dans sa configuration.

Market Data (x402) est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Market Data (x402) ?

Il est publié par r0dell. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.