# Ready APIs

> 135 MCP tools: geo, email, phone, company, DNS, FX, equities, weather, tax, econ, intel — one key.

- name: com.readyapis/api
- version: 1.2.0
- connection class: R1 (autonomous)
- trust: 88/100
- quality: 88/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.readyapis%2Fapi
- tools: https://api.protogrid.dev/v1/servers/com.readyapis%2Fapi/tools

**An agent can connect on its own if it already holds `READYAPIS_TOKEN`.** Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "readyapis": {
      "type": "http",
      "url": "https://readyapis.com/mcp",
      "headers": {
        "Authorization": "Bearer ${READYAPIS_TOKEN}"
      }
    }
  }
}
```

Placeholders to fill: `${READYAPIS_TOKEN}`.

## Trust

- hygiene: 100
- liveness: 98
- freshness: 65
- provenance: 85
- drivers: +repository +dns-namespace +website +reachable +uptime-95% ~updated-128d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 88/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 93 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 129 of 129 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- warn `tools.token_cost`: about 16,598 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: no tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 129, about 16,598 tokens to load them all
- tool set hash: 782c2a3cc2e4fd4ffa04b1bd8634afed
- badge: [![protogrid quality](https://protogrid.dev/badge/com.readyapis/api.svg)](https://protogrid.dev/servers/com.readyapis/api)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://readyapis.com/mcp (streamable-http, auth api_key ${READYAPIS_TOKEN}, reachable true, uptime30d 0.94690263)

## Packages

_none_

## Tools (129)

- `address_enrich`: Validate a US address and return the full ZIP enrichment (demographics, risk, climate, nearest airport, hazards) in one call.
- `address_validate`: Parse and validate a free-form US address: standardize street/unit/city/state/ZIP and cross-check the ZIP against the geo dataset for state and city consistency.
- `address_validate_batch`: Validate up to 50 US addresses in one request. Per-item errors are returned inline.
- `bin_lookup`: Identify the issuing bank, scheme (Visa / Mastercard / Amex / etc), card type (credit/debit/prepaid), and country behind a card BIN. Accepts a 6-8 digit BIN or a full PAN (Luhn-checked, never echoed). Returns scheme + card_type + brand + issuer_bank + country + risk_band. PCI-safe.
- `calendar_business_days_add`: Add N business days to a date and return the resulting business day.
- `calendar_holidays`: List US federal holidays for a year, including observed dates per OPM rules.
- `calendar_is_business_day`: Check whether a US date is a business day (weekday and not a federal holiday).
- `company_change`: SEC 8-K change-signal envelope for a public company. Pulls recent 8-K filings live from EDGAR, classifies item codes into change categories (M&A, leadership, restructuring, material agreement, financial, auditor, governance, disclosure), and returns a change-velocity score (0-100), dominant theme, and buyer-shaped action_hint tuned by buyer profile (sales_outreach, recruiter, investor_research, competitive_intel).
- `company_changes`: Vendor / counterparty change monitoring. Returns time-ordered entity changes (status flips, parent acquisitions, renames) filtered by since-date, LEI, change_type, or country. Critical for continuous KYC and M&A monitoring.
- `company_cik`: Resolve a SEC EDGAR Central Index Key (CIK) to a unified company profile. Accepts CIK with or without leading zeros (320193 = 0000320193 = Apple).
- `company_classify`: Classify a domain using the loaded curated company profile set.
- `company_domain`: Return a company profile by domain. Demo mode allows selected sample domains.
- `company_domains_batch`: Return multiple company profiles by domain in one bounded request. Demo mode allows selected sample domains.
- `company_enrich`: One-call company enrichment: identity + DNS + tech stack + SEC filings (if public) + cyber risk score.
- `company_industry`: Search loaded curated company profiles by industry, category, or description signals.
- `company_insights`: Single-call mega-endpoint — subject profile + hierarchy + corporate-family network + lifecycle timeline + peer benchmark in one response. The 'everything we know' company call.
- `company_lookup_auto`: Auto-detect identifier type and route. Accepts LEI, CIK, domain, email, ticker, or exact name. Returns resolution.matched_on so caller can confirm what type was used.
- `company_lookup_batch`: Resolve up to 50 mixed identifiers (domain, LEI, ticker, name) in a single POST. Each result preserves the original input for join-back.
- `company_network`: Walk the GLEIF ultimate-parent hierarchy and return every entity sharing the same conglomerate root. Excludes pension/retirement trusts by default.
- `company_nonprofit_ein`: Return a nonprofit identity profile by EIN.
- `company_nonprofit_search`: Search nonprofit identity profiles by name, category, EIN, or state.
- `company_peer_comparison`: Benchmark a company against same-industry/same-country peers — employee distribution, jurisdiction mix, founding-decade histogram, and where the subject ranks within the peer set.
- `company_registration`: Resolve a registry-assigned registration number (Companies House, Delaware file number, Handelsregisternummer, etc.) to a company profile. Pass country= to disambiguate since regnums aren't globally unique.
- `company_search`: Search loaded curated company profiles by name, domain, industry, or ticker. Demo mode allows selected sample queries.
- `company_signal`: Composite B2B buyer-signal score (0-100) for a company. Joins curated identity + live SEC EDGAR filings + DNS/DMARC + WHOIS + curated hiring signals into one explainable score tuned by buyer profile (enterprise_sales, smb_sales, investor_research, vendor_diligence). Returns overall score, tier, verdict, six sub-scores with notes, tech-stack hint, and SEC activity summary.
- `company_stats`: Return aggregate counts across the 3.3M-entity registry — by country, jurisdiction, industry, entity_type, employee_range, decade founded, plus hierarchy/data-quality coverage. Filter the slice with country/jurisdiction/industry/naics.
- `company_ticker`: Return a loaded curated company profile by public ticker.
- `company_timeline`: Chronological lifecycle event list for any company — founding year, SEC former-name rebrand events, current status, parent disclosures.
- `compliance_signal`: Compliance-status snapshot for a company: screens against Treasury OFAC SDN entries and SEC enforcement actions, and returns a 0-100 compliance score, tier, decision_hint (proceed / proceed_with_review / escalate / block_pending_review), and critical flags. Tuned by buyer profile (kyc_onboarding, vendor_diligence, regulated_industry, marketplace_listing). SCOPE: decision-support only — does not replace formal KYC or licensed sanctions screening.
- `counterparty_risk`: B2B counterparty-risk composite: should we extend terms to this company? Joins curated identity + live SEC EDGAR filings + DNS/DMARC + WHOIS into a risk-weighted 0-100 score (higher = lower risk), plus a tier and a decision_hint that maps to AR/AP actions (approve_net_30, approve_with_credit_check, require_prepayment, decline_pending_review). Supports four risk profiles for different underwriting postures.
- `cyber_risk`: DNS-hygiene + tech-stack-exposure surface for a domain. Returns a 0-100 cyber score (higher = lower risk) with six sub-scores (email security, DNS hardening, domain hygiene, infra exposure, tech-stack exposure, spoofability), critical flags, and concrete recommended actions. Tuned by buyer profile. SCOPE: inspects published DNS only — no port scans, breach lookups, or CVE matching.
- `dns_certificates`: Recent SSL certificates from Certificate Transparency logs (crt.sh). Returns recent certs with issuer + expiry, plus the deduped subdomain list discovered across all CT entries. Useful for shadow-IT detection, sales-intel hostname discovery, and phishing-cert monitoring.
- `dns_compare`: Compare a target domain against a reference for phishing / typosquatting / lookalike detection. Computes edit distance, apex/TLD diff, homoglyph substitution detection (0↔o, 1↔l, rn↔m). Flags is_likely_typosquat + is_likely_lookalike with drivers. Pure analytical comparison — no DNS query.
- `dns_history`: Snapshot-on-query passive-DNS view. Returns every (record_type, value) tuple seen for this domain during /dns/lookup calls, with first_seen + last_seen + observation_count. Useful for detecting when A records moved or recovering historical NS/MX values. Not a global feed — accumulates from when our users first resolve a domain.
- `dns_lookup`: Resolve A, AAAA, MX, TXT, NS, CNAME, SOA, and CAA records for a domain.
- `dns_profile`: Complete DNS + WHOIS + security + hosting + email-infrastructure + subdomain-probe + health-verdict picture in one call. Sales-intel and security-audit workflow.
- `dns_reputation`: Composite 0-100 reputation score combining domain age, registrar tier, expiration window, security grade, NS diversity, and hosting tier. Returns band (high/moderate/low/suspect) + contributing factors. Designed for fraud-screening pipelines.
- `dns_tls`: Open a TLS handshake on :443, capture the presented cert + protocol version + cipher, and grade the result A-F. Surfaces days-until-expiry, SAN list, self-signed detection, and findings like 'CBC-mode cipher in use'.
- `dns_whois`: Public WHOIS profile: registrar, creation date, expiration, name servers, age in years.
- `email_disposable`: Test whether a domain belongs to the curated disposable-email-domain list.
- `email_free_provider`: Test whether a domain belongs to the curated free consumer-email-provider list.
- `email_smtp_probe`: Live SMTP RCPT probe (HELO + MAIL FROM + RCPT TO; no DATA). Reports deliverability verdict (deliverable / catch_all / undeliverable / greylisted / inconclusive). Catch-all detection via random-fake-RCPT comparison. Skipped automatically for Gmail / Outlook / Yahoo / iCloud / Fastmail / ProtonMail. ~3-8s latency.
- `email_validate`: Validate an email address: RFC syntax, MX lookup, disposable/free/role-account flags, typo correction, and a composite deliverability score. Demo mode is allowed; no live SMTP probe.
- `equities_concept`: Full observation history for one XBRL concept (any us-gaap tag). Use for fields outside our 35-item headline catalog. Returns every observation across every reported unit, most-recent first.
- `equities_filings`: Live SEC EDGAR submissions API: most recent filings (10-K, 10-Q, 8-K, ...) for a ticker or CIK. Filter by form type.
- `equities_fundamentals`: Headline financial statements parsed from SEC XBRL filings: revenue, net income, total assets, EPS, cash flow, and 30 more curated tags. Annual (10-K) or quarterly (10-Q). Free — backed by SEC's public XBRL companyfacts API.
- `equities_ticker`: Resolve a stock ticker to company name, CIK, exchange, SIC industry code, and headquarters from the SEC EDGAR registry.
- `flight_airline_reliability`: Summarize loaded route reliability signals for a carrier code.
- `flight_airport_delay_profile`: Summarize delay and reliability signals for an airport across loaded loaded route aggregates.
- `flight_cancellation_risk`: Return historical cancellation-risk signals for a route. This is not live tracking.
- `flight_reliability`: Return historical route reliability. Demo mode allows selected loaded routes such as ATL-LGA, ORD-EWR, SFO-SEA, LAX-JFK, DFW-LAX, and ATL-MCO.
- `flight_route_best_times`: Rank loaded departure-hour buckets for a route by historical reliability score.
- `flight_route_summary`: Return a combined historical route summary with reliability, cancellation risk, carriers, months, and best time bucket. This is not live tracking.
- `fred_popular`: List of curated FRED series shortcuts with their underlying FRED ID, title, units, and frequency. Use this catalog to discover what slugs are available for fred_series.
- `fred_search`: Free-text search of FRED's ~800k series catalog. Ordered by popularity. Use when you don't know the series ID — e.g. q='initial jobless claims' surfaces ICSA + state-level variants.
- `fred_series`: Fetch any FRED time-series by curated slug (gdp, cpi, unemployment, fed_funds, treasury_10y, vix, wti, mortgage_30y, ...) or raw FRED ID (CPIAUCSL, UNRATE, DGS10). ~800k series available — covers BLS, Census, Fed, Treasury, OECD, IMF, BIS. Free upstream, server-side key required.
- `funding_signal`: SEC Form D-based funding-signal envelope. Pulls Form D / D-A filings live from EDGAR and surfaces a recency-weighted funding score, cadence hint (fresh_raise, recent_raise, established_cadence, stale), and buyer-shaped action_hint tuned by buyer profile (sales_outreach, vendor_partnerships, investor_research, recruiter). Form D filings are the public, free, authoritative record of private securities offerings.
- `fx_convert`: Convert an amount between two currencies at the most recent reference rate.
- `fx_correlation`: Pearson correlation of daily log-returns vs USD across a basket. Cells banded strong_positive/positive/neutral/negative/strong_negative. Treasury/risk workflow for understanding multi-currency exposure.
- `fx_currencies`: List every currency Ready APIs has reference-rate coverage for, with its issuing central bank and peg classification.
- `fx_historical`: Reference rate for a specific past date. Useful for 'what was USD→EUR on 2024-11-15?' questions.
- `fx_movers`: Top N pairs by absolute % change over the lookback window. Returns signed pct_change + direction (up/down/flat). Daily/weekly market briefing.
- `fx_pair`: Deep enrichment for one currency pair: latest rate + 30/90-day volatility + trend + anomaly z-score + spread estimate + cross-strength + verdict. Decision-grade single-call summary.
- `fx_rates`: Return current daily reference exchange rates relative to a base currency (default EUR), sourced from ECB.
- `fx_strength`: Ranked strength leaderboard for the past N days. For each currency in the basket (g10 or majors), the average move across every pair it participates in. Strongest → weakest with per-currency label.
- `fx_timeseries`: Daily rate series for a single base→quote pair across a date range. Useful for charts and trend analysis.
- `fx_volatility_leaders`: Pairs ranked by annualized realized volatility. Distinct from fx_movers — surfaces pairs that swing wildly day-to-day, even if flat overall. Classes: low/moderate/elevated/extreme.
- `geo_asn`: Resolve an IP to its autonomous system number, organization, and network prefix.
- `geo_city_search`: Return ZIP profiles for a city and state. Demo mode allows selected sample cities.
- `geo_county_lookup`: Return ZIP profiles in a county by county FIPS. Demo mode allows selected sample FIPS values.
- `geo_enrich`: Return the enriched ZIP profile shape used by production enrichment workflows. Demo mode allows selected sample ZIPs.
- `geo_ip`: Resolve an IPv4 or IPv6 address to city, state, country, coordinates, timezone, and the nearest US ZIP profile. Demo mode is limited to selected sample IPs.
- `geo_nearby`: Return distance-sorted ZIP profiles near a coordinate. Demo mode allows selected sample coordinates, radius up to 25 miles, and limit up to 10.
- `geo_timezone`: Resolve a timezone using nearest ZIP centroid logic. Demo mode allows selected sample coordinates.
- `geo_zip_batch`: Look up multiple ZIP profiles in one bounded request. Demo mode allows up to 5 selected sample ZIPs; production accepts up to 10.
- `geo_zip_lookup`: Look up a ZIP profile. Demo mode allows 30301, 30303, 10001, 94105, 60601, 78701, and 98101.
- `hiring_signal`: Buyer-shaped hiring velocity envelope. Pass `domain`/`company` for a company-keyed view, or `location` (+ optional `role`) for a market-keyed view. Returns velocity score (0-100), tier, growth verdict (rapid_growth, active_growth, ...), and a sales_hint mapped to typical actions for the chosen buyer profile (saas_sales, recruiter, investor_diligence, competitive_intel).
- `intel_buyer_profiles`: List supported buyer profiles for /intel/company-signal and how each weights the six sub-scores.
- `intel_change_profiles`: List buyer profiles for /intel/company-change and their category multipliers.
- `intel_compliance_profiles`: List buyer profiles for /intel/compliance-signal and their sub-score weights.
- `intel_cyber_profiles`: List buyer profiles for /intel/cyber-risk and their sub-score weights.
- `intel_funding_profiles`: List buyer profiles for /intel/funding-signal and their sub-score weights.
- `intel_hiring_profiles`: List buyer profiles for /intel/hiring-signal and their weights.
- `intel_rank`: Score and rank up to 100 ZIPs against a single site profile. Returns sorted by risk_score (highest = lowest risk).
- `intel_risk_profiles`: List supported risk profiles for /intel/counterparty-risk and how each weights the six risk sub-scores.
- `intel_role_profiles`: List supported role profiles for /intel/location-score and how each weights the six sub-scores (talent_pool, cost_pressure, tax_burden, connectivity, climate_resilience, quality_of_life).
- `intel_site_profiles`: List supported site profiles for /intel/site-risk and how each weights the six physical-risk sub-scores.
- `jobs_companies_hiring`: Return curated company-level hiring signals for a location and optional role family.
- `jobs_concentration`: HHI-based geographic concentration for a skill. Returns hhi_score (0-100), band (diffuse → dominant), and top N metros with their job-count share. Answers 'where does the candidate pool live?'.
- `jobs_momentum`: Recent vs prior period demand for a skill. Returns score (-100..+100) and band (surging/rising/stable/cooling/falling) so you know if hiring for this skill is accelerating or decelerating.
- `jobs_profile`: Full talent-market profile in one call: skill intel + role intel + market temperature + salary band + hiring velocity + location compete + talent verdict. Replaces ~5 separate calls.
- `jobs_related_skills`: Return ranked related skills for a loaded skill trend.
- `jobs_remote_trends`: Return remote/hybrid/on-site trend buckets for a role title.
- `jobs_role_skills`: Return aggregated skill signals for a role title. Demo mode allows selected sample job titles.
- `jobs_salary_signals`: Return salary signal aggregates for a role title in the loaded trend set.
- `jobs_scarcity`: Estimate candidates-per-open-role for a skill. Bands: severe_shortage / scarce / balanced / abundant. Workforce-planning signal for prioritizing hard-to-fill roles.
- `jobs_skill_graph`: Multi-hop related-skill graph (BFS from seed). Returns nodes with hops_from_seed and edges with frequency-based weights. Use for broadening candidate filters, curriculum design, and job-description templating.
- `jobs_skill_trends`: Return job and skill-demand trend rows. Demo mode allows selected sample skills.
- `location_score`: Composite hiring-location score (0-100) for a US ZIP, weighted by role profile (engineering, sales, operations, warehouse, retail, remote). Joins Census ACS demographics, FEMA flood, IECC climate, FAA airport, BEA cost-of-living, and state income tax into one tuned signal. Returns overall score, tier, verdict, and six sub-scores with notes.
- `meta_catalog`: List public-safe dataset coverage, status, and endpoint counts. Demo mode is allowed.
- `meta_dataset`: Return public-safe coverage, limitations, and endpoint references for one dataset slug.
- `phone_region`: Lightweight country + region + primary timezone lookup for a phone number. Cheaper than phone_validate when you only need the country header.
- `phone_validate`: Validate + enrich a phone number in 200+ countries. Returns E.164/national/international formatting, country, number-type (mobile/fixed/VoIP/toll-free/premium), carrier (where libphonenumber has data), timezones, disposable-carrier flag, and a risk band (low/moderate/elevated/high) for sign-up fraud screening.
- `remote_hire_cost`: Composite remote-hire envelope for a US ZIP + salary: total employer cost (salary + employer FICA + benefits load), employee take-home (federal + state + employee FICA), and the location-fit score under the 'remote' profile. Replaces a 20-40 minute back-and-forth with payroll on every remote candidate.
- `sanctions_search`: Search the US Treasury OFAC SDN list by name. 5-stage match cascade (exact primary, exact AKA, substring primary, substring AKA, fuzzy token-Jaccard) returns matches with programs (RUSSIA/IRAN/SDGT/etc), countries, AKAs, and 0.0-1.0 confidence. Filters by sdn_type / country / program. Decision support — not a substitute for full multi-list KYC.
- `site_risk`: Physical-location risk composite for a US ZIP. Joins FEMA flood + USGS seismic + NOAA tornado/hurricane + climate + EIA grid reliability into a 0-100 risk-weighted score (higher = lower risk). Tuned by site profile: insurance_underwriting, data_center_site, retail_storefront, warehouse_distribution. Returns underwriting_hint mapped to insurance actions.
- `tax_calculate`: Compute progressive federal (and optional state) tax owed from gross income, filing status, year, and deductions. Returns tax, marginal/effective rate, take-home, and per-bracket impact. Demo mode is limited to 2026 and standard filing statuses. Reference data only, not advice.
- `tax_deadlines`: Return filing deadline reference values. Demo mode is limited to 2026.
- `tax_federal_brackets`: Return federal tax bracket reference rows. Demo mode is limited to 2026 and standard filing statuses.
- `tax_mileage_rates`: Return mileage-rate reference values. Demo mode is limited to 2026.
- `tax_retirement_limits`: Return retirement contribution reference values. Demo mode is limited to 2026.
- `tax_standard_deduction`: Return standard deduction reference values. Demo mode is limited to 2026.
- `tax_state_brackets`: Return selected state individual income-tax bracket references. Demo mode is limited to Georgia 2026.
- `tax_summary`: Return a combined federal bracket, standard deduction, mileage, retirement, and filing-deadline reference summary. Demo mode is limited to 2026.
- `tech_stack`: Classify a company's public tech footprint by inspecting MX / A / CNAME / NS / TXT records. Returns detections across categories (email_provider, hosting_provider, cdn_provider, dns_provider, SaaS tools via TXT) with vendor evidence on every detection. Non-intrusive — only looks at DNS the domain owner published.
- `vin_decode`: Decode a 17-character Vehicle Identification Number. Offline ISO 3779/3780 structural decode (syntax, check digit, country, model year) + NHTSA vPIC enrichment (make / model / trim / body / engine / plant). Use for insurance underwriting, used-car listing validation, fleet management.
- `weather_air_quality`: Current air quality at a lat/lon or US ZIP: US EPA AQI + European AQI, plus pollutant concentrations (PM2.5, PM10, ozone, NO₂, SO₂, CO, dust) in µg/m³, a categorical band, and the primary pollutant. Source: Open-Meteo Air Quality (CAMS + EPA AirNow blend).
- `weather_alerts`: Active alerts from the US National Weather Service. Query by lat+lon, US ZIP, or two-letter state code.
- `weather_best_window`: Find the best contiguous N-day or N-hour window in the forecast horizon for an activity (outdoor_event, ski, construction, agriculture_spray, running). Returns top 5 windows ranked 0-100 with drivers.
- `weather_compare`: Rank up to 5 locations by comfort outlook (ideal > mild > poor > severe). Useful for trip planning, expansion site comparison, event location selection.
- `weather_current`: Current conditions at a latitude/longitude in imperial or metric units. Sourced from Open-Meteo.
- `weather_degree_days`: HDD and CDD over a window, with per-day rows. Used for HVAC sizing, utility bill reconciliation, energy forecasting. Default base 65°F is the NOAA HVAC standard.
- `weather_forecast`: Daily forecast with travel-impact score (flight risk, outdoor event suitability) per day plus an overall precipitation outlook (dry/mixed/wet pattern).
- `weather_historical`: Last 1-365 days of daily observations with pre-computed aggregates (frost-day count, summer-day count, rainy days, heavy-rain days, extremes). Answers 'is this a normal year?' questions.
- `weather_hourly`: Hour-by-hour forecast: temperature, apparent temperature, precipitation probability + amount, humidity, cloud cover, wind speed/gusts/direction, and a WMO condition label per hour. For event timing, energy-demand curves, and logistics windows.
- `weather_marine`: Coastal/marine hourly forecast: wave height, period, and direction, plus wind-wave and swell components. For shipping, fishing, surfing, and coastal-event planning. Coastal/open-water coordinates only — inland points return an error.
- `weather_normals`: Same-window decadal climate normals for the next N days, plus a departure-from-normal block comparing the current forecast to the baseline. 'This week is 11°F above normal.'
- `weather_route`: Weather conditions along a polyline route. Pass up to 20 legs, each a lat/lon waypoint with an optional ISO 8601 departs_at. Legs departing within 2 hours (or with no time) return current conditions; future legs return the daily forecast for that date. For trucking, road-trip, and delivery-window planning.
- `weather_zip`: Resolve a US ZIP to coordinates via the geo dataset, then return current weather.