Metadata-Version: 2.4
Name: x402-market-data-mcp
Version: 0.5.0
Summary: MCP server with 42 paid data tools for agents (exchange hours, futures expiry, economic and central bank calendars, Treasury yields and auctions, ECB FX, CFTC COT, contract specs, LEI, time zones, EU VAT, VIN, weather alerts, earthquakes, FDA recalls), paid per call with x402 (USDC on Base).
License: MIT
Project-URL: Homepage, https://github.com/r0dell/market-data-mcp
Keywords: mcp,x402,trading,market-hours,futures,treasury,ecb,cot,lei,vat,usdc,base
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp<2,>=1.10
Requires-Dist: x402[clients,evm]==2.25.0
Requires-Dist: requests>=2.31
Requires-Dist: eth-account>=0.13
Requires-Dist: certifi
Requires-Dist: truststore>=0.9
Dynamic: license-file

# Market Data MCP

<!-- mcp-name: io.github.r0dell/market-data-mcp -->

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

| Area | Tools | Price per call |
|---|---|---|
| Exchange hours | `market_is_open`, `market_next_open_close`, `market_holidays` | 0.0205–0.0405 USDC |
| Futures | `futures_front_month`, `futures_expirations`, `futures_roll_calendar`, `crypto_futures_expiry` | 0.0205–0.0405 USDC |
| Trading time | `settlement_date`, `fx_sessions`, `dst_gaps`, `is_dst_gap`, `market_countdown` | 0.0205–0.0405 USDC |
| Macro | `treasury_yield_curve`, `treasury_spread`, `ecb_fx_rate`, `ecb_convert`, `cot_positioning`, `reference_rate`, `inflation` | 0.0205–0.0405 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`, `public_holidays`, `workdays`, `payment_cutoff` | 0.0205–0.0405 USDC |
| Briefing | `trading_briefing` – all market-moving events of the next days in one call | 0.0455 USDC |
| Futures specs | `contract_spec`, `futures_tick_value`, `futures_position_size` | 0.0205 USDC |
| Risk & compliance | `weather_alerts`, `earthquakes`, `fda_recalls`, `sanctions_check` (OFAC, UN, EU, SECO) | 0.0385–0.0445 USDC |
| Reference | `lei_lookup`, `timezone_info`, `meeting_window`, `sun_moon`, `treasury_reporting_rate`, `eu_vat_rates`, `vin_decode`, `iban_check`, `bic_check`, `country_info`, `currency_info` | 0.0225–0.0365 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)
the CFTC Commitments of Traders report, GLEIF (CC0), NWS, USGS, openFDA, U.S. Treasury Fiscal Data and NHTSA vPIC (public domain).

## How payment works

Each paid tool calls an HTTP API protected by [x402](https://x402.org). 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](https://docs.astral.sh/uv/). Add this to your MCP client config
(Claude Desktop: Settings → Developer → Edit Config):

```json
{
  "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:

- 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
