# MCPFax Public-Data Utility API

> Thin, reliable, per-call JSON wrappers over free public and government data, sold per call via the x402 payment protocol (USDC on Base). Also exposed as an MCP server. No API key or signup — an agent pays each call with a signed USDC authorization.

Payments: HTTP 402 x402 v1, scheme=exact, network=base (Base mainnet, CAIP-2 eip155:8453), asset=USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913. Send a base64 `X-PAYMENT` header to pay. Discovery catalog: https://mcpfax-utility.bowling-anthony.workers.dev/v1/catalog . MCP endpoint: https://mcpfax-utility.bowling-anthony.workers.dev/mcp .

## Free endpoints
- [Health](https://mcpfax-utility.bowling-anthony.workers.dev/health): liveness and configuration
- [Catalog JSON](https://mcpfax-utility.bowling-anthony.workers.dev/v1/catalog): machine-readable endpoint + pricing list
- [MCP](https://mcpfax-utility.bowling-anthony.workers.dev/mcp): JSON-RPC; initialize, tools/list (free), tools/call (paid)

## Geo & Places
- [Forward geocoding](https://mcpfax-utility.bowling-anthony.workers.dev/v1/geocode) ($0.001): Place name → coordinates, country, timezone. Params: q*, country, count. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/geocode?q=London&country=GB&count=3
- [Reverse geocoding](https://mcpfax-utility.bowling-anthony.workers.dev/v1/reverse-geocode) ($0.001): Coordinates → nearest address. Params: lat*, lon*. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/reverse-geocode?lat=34.05&lon=-118.24
- [Timezone by coordinate](https://mcpfax-utility.bowling-anthony.workers.dev/v1/timezone) ($0.001): Coordinates → IANA timezone, UTC offset, local time. Params: lat*, lon*. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/timezone?lat=48.85&lon=2.35
- [Postal code lookup](https://mcpfax-utility.bowling-anthony.workers.dev/v1/zip) ($0.001): ZIP/postal code → place(s) & coordinates. Params: code*, country. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/zip?code=90210&country=US
- [Nearest airports](https://mcpfax-utility.bowling-anthony.workers.dev/v1/airports/nearest) ($0.002): Coordinates → nearest airports (IATA/ICAO) by distance. Params: lat*, lon*, radius, limit. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/airports/nearest?lat=40.71&lon=-74.0&radius=300&limit=5
- [IP geolocation](https://mcpfax-utility.bowling-anthony.workers.dev/v1/ip-geolocation) ($0.001): IP address → location, ASN, ISP. Params: ip*. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/ip-geolocation?ip=8.8.8.8
- [Country metadata](https://mcpfax-utility.bowling-anthony.workers.dev/v1/country) ($0.001): Name/ISO code → currency, capital, calling code, languages, flag. Params: q*. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/country?q=Japan

## Weather & Environment
- [Weather forecast](https://mcpfax-utility.bowling-anthony.workers.dev/v1/weather) ($0.001): Current conditions + multi-day forecast by coordinate or place. Params: lat, lon, q, days. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/weather?lat=51.5&lon=-0.13&q=Berlin&days=3
- [Active weather alerts](https://mcpfax-utility.bowling-anthony.workers.dev/v1/weather-alerts) ($0.002): Active NWS watches/warnings for a US coordinate. Params: lat, lon, q. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/weather-alerts?lat=29.76&lon=-95.37&q=Miami
- [Air quality](https://mcpfax-utility.bowling-anthony.workers.dev/v1/air-quality) ($0.001): US & European AQI plus pollutant concentrations by coordinate. Params: lat, lon, q. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/air-quality?lat=34.05&lon=-118.24&q=Delhi
- [Sunrise / sunset](https://mcpfax-utility.bowling-anthony.workers.dev/v1/sun) ($0.001): Sunrise, sunset, solar noon, day length by coordinate. Params: lat, lon, q, date. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/sun?lat=34.05&lon=-118.24&q=Cairo&date=2026-06-21

## Time & Calendar
- [Public holidays](https://mcpfax-utility.bowling-anthony.workers.dev/v1/holidays) ($0.001): Public holidays for a country & year. Params: country*, year. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/holidays?country=US&year=2026
- [Business-day math](https://mcpfax-utility.bowling-anthony.workers.dev/v1/business-days) ($0.001): Count business days in a range, or add/subtract N business days, skipping weekends & holidays. Params: start*, end, days, country. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/business-days?start=2026-01-02&end=2026-01-31&days=10&country=US

## Finance & Markets
- [Currency exchange rates](https://mcpfax-utility.bowling-anthony.workers.dev/v1/fx) ($0.001): Reference FX rates (ECB) with optional amount conversion. Params: from*, to*, amount. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/fx?from=USD&to=EUR,GBP,JPY&amount=100
- [Crypto spot price](https://mcpfax-utility.bowling-anthony.workers.dev/v1/crypto-price) ($0.001): Spot price for a crypto asset in a fiat/crypto quote currency. Params: symbol*, vs. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/crypto-price?symbol=BTC&vs=USD
- [Stock quote](https://mcpfax-utility.bowling-anthony.workers.dev/v1/stock-quote) ($0.001): Delayed quote & key stats for an equity/ETF/index. Params: symbol*. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/stock-quote?symbol=AAPL
- [SEC EDGAR company facts](https://mcpfax-utility.bowling-anthony.workers.dev/v1/sec-company-facts) ($0.003): Company profile + recent filings; or XBRL financial facts for a concept. Params: ticker, cik, concept, taxonomy. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/sec-company-facts?ticker=AAPL&cik=320193&concept=Revenues&taxonomy=us-gaap
- [Inflation calculator](https://mcpfax-utility.bowling-anthony.workers.dev/v1/inflation) ($0.002): Adjust an amount between years using CPI (any country, not just US). Params: from*, to, amount, country. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/inflation?from=2000&to=2020&amount=100&country=USA
- [Economic indicator](https://mcpfax-utility.bowling-anthony.workers.dev/v1/econ-indicator) ($0.002): World Bank indicator time series for a country (GDP, unemployment, etc.). Params: country*, indicator*. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/econ-indicator?country=US&indicator=NY.GDP.MKTP.CD
- [LEI lookup](https://mcpfax-utility.bowling-anthony.workers.dev/v1/lei) ($0.002): Legal Entity Identifier record by LEI code or entity name. Params: lei, q. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/lei?lei=HWUPKR0MPOU8FGXBT394&q=Apple Inc.

## Reference & Registries
- [VIN decode](https://mcpfax-utility.bowling-anthony.workers.dev/v1/vin-decode) ($0.003): Decode a US-market Vehicle Identification Number. Params: vin*, year. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/vin-decode?vin=1HGCM82633A004352&year=2003
- [ICD-10-CM search](https://mcpfax-utility.bowling-anthony.workers.dev/v1/icd10) ($0.002): Search ICD-10-CM diagnosis codes by term or code. Params: q, code, maxList. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/icd10?q=type 2 diabetes&code=E11&maxList=10
- [NAICS lookup](https://mcpfax-utility.bowling-anthony.workers.dev/v1/naics) ($0.002): Official 2022 NAICS code → title, hierarchy, children; or keyword search. Params: code, q. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/naics?code=541511&q=software publishers
- [CFR legal text](https://mcpfax-utility.bowling-anthony.workers.dev/v1/cfr) ($0.003): Fetch current Code of Federal Regulations text for a citation. Params: title*, part, section, date. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/cfr?title=29&part=1910&section=1910.132&date=2026-01-01
- [FDA drug label](https://mcpfax-utility.bowling-anthony.workers.dev/v1/drug-label) ($0.003): openFDA structured drug labeling (uses, warnings, dosage). Params: q*, field, limit. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/drug-label?q=ibuprofen&field=openfda.generic_name&limit=1
- [Wikipedia summary](https://mcpfax-utility.bowling-anthony.workers.dev/v1/wikipedia) ($0.001): Lead summary/extract for a Wikipedia page. Params: title*, lang. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/wikipedia?title=Cloudflare&lang=en

## Utility & Dev
- [Unit conversion](https://mcpfax-utility.bowling-anthony.workers.dev/v1/unit-convert) ($0.001): Convert between units (length, mass, volume, speed, area, data, time, pressure, energy, temperature, angle). Params: value*, from*, to*. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/unit-convert?value=100&from=mi&to=km
- [DNS lookup](https://mcpfax-utility.bowling-anthony.workers.dev/v1/dns) ($0.001): Resolve DNS records via DNS-over-HTTPS. Params: name*, type. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/dns?name=example.com&type=MX
- [RDAP whois](https://mcpfax-utility.bowling-anthony.workers.dev/v1/rdap) ($0.001): Structured domain/IP registration data (modern whois). Params: domain, ip. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/rdap?domain=example.com&ip=8.8.8.8
- [robots.txt / llms.txt](https://mcpfax-utility.bowling-anthony.workers.dev/v1/robots) ($0.001): Fetch and parse a site's robots.txt and llms.txt. Params: url*. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/robots?url=https://www.cloudflare.com
- [Email validation](https://mcpfax-utility.bowling-anthony.workers.dev/v1/validate-email) ($0.001): Syntax check + live MX/deliverability + disposable-domain flag. Params: email*. Example: https://mcpfax-utility.bowling-anthony.workers.dev/v1/validate-email?email=user@example.com

Source data is public/government (Open-Meteo, US NWS, SEC EDGAR, NHTSA, US Census, GLEIF, openFDA, World Bank, Nager.Date, eCFR, OpenStreetMap, and others). Data is served as-is; do not rely on it for safety-critical or medical decisions.