mcpField
M
Market Data (x402)

Market Data (x402)

Local
github.com/r0dellFinance0Updated 2w ago
Repository

About Market Data (x402)

Market Data (x402) is an MCP server for assistants and agents that need exchange schedules, futures, macro data and contract specifications. Paid calls use x402 and USDC on Base; five helper tools remain free.

Key features

  1. 01Exchange hours and holidays
  2. 02Futures expirations and roll dates
  3. 03Trading-time and FX session data
  4. 04Treasury, ECB and COT data
  5. 05Market calendars and briefings
  6. 06Futures contract specifications

Use cases

  1. 01Check whether an exchange is open
  2. 02Find futures roll and expiration dates
  3. 03Review yield curves and FX rates
  4. 04Get upcoming market events in one briefing

MCP support

Exposes 32 paid market-data tools and five free helper tools to MCP clients. Paid calls are made through x402, with automatic USDC payments on Base when a wallet key is configured.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "r0dell-market-data": {
      "command": "uvx",
      "args": [
        "x402-market-data-mcp"
      ],
      "env": {
        "X402_KEY_FILE": "<X402_KEY_FILE>",
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>",
        "MAX_USDC_PER_CALL": "<MAX_USDC_PER_CALL>",
        "MAX_USDC_PER_SESSION": "<MAX_USDC_PER_SESSION>"
      }
    }
  }
}
Run commanduvx x402-market-data-mcp
Environment variables to set
X402_KEY_FILESecretPath 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_KEYSecretAlternative to X402_KEY_FILE: private key of a small, dedicated payment wallet.
MAX_USDC_PER_CALLHighest price per call in USDC
MAX_USDC_PER_SESSIONTotal budget per server start in USDC

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypix402-market-data-mcp0.2.1

Tools

36

Saved tool list · updated 2w ago

This tool takes no parameters.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.