Market Data (x402)

io.github.r0dellPublished by GitHub account r0dellv0.5.0Updated Nov 1, 2026

Paid-per-call data for agents: trading calendars, futures, macro, LEI, VAT, risk events (x402)

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

Local MCP server giving assistants 53 paid, per-call market data tools (exchange hours, futures, macro, calendars, risk) plus 5 free helpers, paid in USDC via…

What you can do
  • Check exchange hours, holidays, next open/close and trading countdowns
  • Look up futures front month, expirations, roll calendars, contract specs and position sizing
  • Retrieve macro data: Treasury yield curve and spreads, ECB FX rates, COT positioning, reference rates, inflation
  • Query calendars: options and VIX expirations, economic releases, central bank meetings, Treasury auctions, banking days, index rebalances, payment cutoffs
  • Run risk and compliance checks: weather alerts, earthquakes, FDA recalls, sanctions screening
  • Look up reference data such as LEI, time zones, EU VAT rates, VIN, IBAN, BIC, country and currency info; free tools list the catalog, payment status and supported markets
When to use it
Useful when an assistant needs precise trading-calendar, futures, macro or compliance reference data for market analysis, scheduling or settlement questions, and you are willing to pay a few cents in USDC per call.
Requirements
Runs locally via uvx (or pip) with Python; requires uv or Python. Paid tools need a funded USDC wallet on Base, supplied through X402_KEY_FILE or X402_PRIVATE_KEY, with optional MAX_USDC_PER_CALL and MAX_USDC_PER_SESSION budgets. Network access to the x402-protected HTTP APIs is required; free tools work without a key.
Before you install
Paid tools spend real USDC automatically on Base mainnet, up to the per-call and per-session caps (defaults 0.05 and 1.00 USDC). The private key of a wallet is required via X402_KEY_FILE or X402_PRIVATE_KEY; use a separate small wallet, never a main one. Data is provided as is, is not investment advice, and critical dates should be confirmed with the exchange.

Installation

In SourceWeft

  1. Open Market Data (x402) in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Market Data MCP

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

AreaToolsPrice per call
Exchange hoursmarket_is_open, market_next_open_close, market_holidays0.0205–0.0405 USDC
Futuresfutures_front_month, futures_expirations, futures_roll_calendar, crypto_futures_expiry0.0205–0.0405 USDC
Trading timesettlement_date, fx_sessions, dst_gaps, is_dst_gap, market_countdown0.0205–0.0405 USDC
Macrotreasury_yield_curve, treasury_spread, ecb_fx_rate, ecb_convert, cot_positioning, reference_rate, inflation0.0205–0.0405 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_dates, public_holidays, workdays, payment_cutoff0.0205–0.0405 USDC
Briefingtrading_briefing – all market-moving events of the next days in one call0.0455 USDC
Futures specscontract_spec, futures_tick_value, futures_position_size0.0205 USDC
Risk & complianceweather_alerts, earthquakes, fda_recalls, sanctions_check (OFAC, UN, EU, SECO)0.0385–0.0445 USDC
Referencelei_lookup, timezone_info, meeting_window, sun_moon, treasury_reporting_rate, eu_vat_rates, vin_decode, iban_check, bic_check, country_info, currency_info0.0225–0.0365 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) 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. 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):

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:

Disclaimer

Data is provided as is, without warranty. Not investment advice. Always confirm critical dates with the exchange.

License: MIT

Source: README.md at commit 4d31f6e

Tools

0
SourceWeft started this package once in an isolated sandbox, without credentials, to list its tools. That failed: the package type cannot run in the sandbox.

Version history

3
  1. v0.5.0LatestNov 1, 2026
  2. v0.4.0Nov 1, 2026
  3. v0.2.1Oct 19, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts