Tools provided
Tools the agent exposes — your AI client calls them automatically when it needs them.
- search_ai_models — Search current AI models by price, context window, and capability. Use this for up-to-date model pricing/features you don't reliably know. Prices are USD per 1M tokens. Results are cheapest-input-price first. Args: query: match part of a model name/id (e.g. "haiku", "gpt"). provider: filter to one provider (openai, anthropic, google, xai, mistral, deepseek, groq). max_input_price: only models at or below this USD/1M input price. min_context: only models with at least this context windowwrite
- airport_delays — Live FAA airport delays, ground stops, closures & ground-delay programs (US NAS, keyless). `airport` = 3-letter code (LGA, LAX…) or blank for all current disruptions. Ground stops change minute-to-minute — pure post-cutoff state. An empty/short list means the airspace is running normally. Every value is returned in an Ed25519-signed, provenance-stamped envelope (source and observation time) you can verify offline against /.well-known/keys, no account required.write
- drug_shortages — US drug shortages from the FDA (openFDA, keyless). `query` = drug/generic name (amoxicillin…) or blank for the most recently updated. Is drug X in shortage right now — status/reason/company. A model's stale yes/no here is clinically misleading; confirm clinically. Every value is returned in an Ed25519-signed, provenance-stamped envelope (source and observation time) you can verify offline against /.well-known/keys, no account required.write
- sanctions_screen — Screen a name against the US OFAC SDN + UK Sanctions List (FCDO, Open Government Licence) — keyless. `name` = party to check; optional `program` (an OFAC program e.g. IRAN/CUBA, or a UK regime/origin). Each result is tagged with its `list` (US-OFAC | UK). A match means the party is sanctioned — legally binding the instant it's posted, so models can't know recent designations. Confirm the full entry first. Every value is returned in an Ed25519-signed, provenance-stamped envelope (source and obsewrite
- company_lookup — Resolve a company name (or exact 20-char LEI) to its authoritative global Legal Entity Identifier + canonical legal name, address, status and local registration, from GLEIF (CC0 public domain, keyless). The deterministic join key to sanctions_screen and sec_filings — an LLM can't reliably map a name to a real, currently-active registered entity. Pass {"query":"Apple Inc"} or {"lei":"HWUPKR0MPOU8FGXBT394"}; optional `country` (ISO-2) filter. Confirm against the official register before acting. Ewrite
- ephemeris — Solar & lunar timing for a place + day — sunrise/sunset, the full twilight set (civil/nautical/ astronomical), moonrise/moonset, moon phase + illumination — from the U.S. Naval Observatory (public domain, keyless). Pass a `location` (city, geocoded) OR `lat`/`lon`; optional `date` (YYYY-MM-DD, default today) and `tz` offset (default 0=UTC). For agent/robot daylight & moonlight gating, golden-hour windows and night-ops planning — an LLM has no clock or location. Every value is returned in an Ed2write
- emissions — National greenhouse-gas emissions for a country (ISO-3 code, e.g. USA/CHN/IND) + year, from Climate TRACE (CC BY 4.0, keyless): CO2/CH4/N2O + CO2-equivalent (100yr & 20yr GWP), the country's global rank and its share of world emissions. Climate TRACE's own modelled national inventory; annual, lags ~1-2yr. For climate/ESG/policy agents that need a citeable emissions figure an LLM can't reliably recall. Every value is returned in an Ed25519-signed, provenance-stamped envelope (source and observatwrite
- federal_register — Recent US Federal Register documents — rules, proposed rules, notices, executive orders (keyless). `doc_type` = RULE | PRORULE | NOTICE | PRESDOCU. Answers 'what regulation took effect / what did the President sign' — total post-cutoff blindness for models. Every value is returned in an Ed25519-signed, provenance-stamped envelope (source and observation time) you can verify offline against /.well-known/keys, no account required.write
- drought — US drought severity — % of area in each D0-D4 class by week (U.S. Drought Monitor, keyless). `area` = 'total' (US national) or a state FIPS code. D0=abnormally dry … D4=exceptional drought. Weekly. Every value is returned in an Ed25519-signed, provenance-stamped envelope (source and observation time) you can verify offline against /.well-known/keys, no account required.write
- water_levels — Real-time US river levels — gage height (ft) + streamflow/discharge (ft3/s) from USGS NWIS (keyless). US only — see au_water for the Australian (BoM Water Data Online) counterpart. Use for "how high / how fast is river X right now", flood risk (rising gage) or drought (low flow). Provide a 2-letter US `state`, USGS `site` number(s) comma-separated, or neither for major rivers. Args: state: 2-letter US state code (e.g. TX, CA). site: USGS site number(s), comma-separated. limit: max sites.write
- sports_pulse — Global ATTENTION + official schedule for a sporting event, team or competition — e.g. the 2026 FIFA World Cup. Returns the event's hosts/start-end dates/sport plus a worldwide attention signal: daily Wikipedia article views by language edition, with 7-day momentum, peak and a per-language breakdown. Use for "how much buzz is event X getting / where in the world / is interest rising". This is the NEUTRAL attention layer (Wikimedia Pageviews + Wikidata, CC0) — NOT live scores, fixtures or odds. Arwrite
- world_cup — 2026 FIFA World Cup FIXTURES + final RESULTS — all 104 matches, the next `upcoming` fixtures and the `recent` most-recent final scores, plus progress (played / remaining). Source: openfootball (PUBLIC DOMAIN, redistributable). Results appear post-match as the open dataset updates — NOT live minute-by- minute scores (those are licensed) and NO betting odds. Pair with sports_pulse for global attention. Every value is returned in an Ed25519-signed, provenance-stamped envelope (source and observatiwrite
- product_recalls — US product recalls — food, drug & medical-device enforcement reports (openFDA, keyless, CC0). `category` = all | food | drug | device; `query` matches the product description. Most-recent first; Class I = most serious. Use for "is product/brand X recalled right now". Informational — confirm against the official FDA recall notice. Every value is returned in an Ed25519-signed, provenance-stamped envelope (source and observation time) you can verify offline against /.well-known/keys, no account rewrite
- treasury_yields — US Treasury daily par yield curve (1M-30Y) + the 10Y-2Y / 10Y-3M spreads — the classic recession signal (an inverted curve has preceded recessions). Today's curve is post-cutoff; a model can't know it. Use for "what's the yield curve / is it inverted / current 10-year Treasury". Keyless, US public domain. Every value is returned in an Ed25519-signed, provenance-stamped envelope (source and observation time) you can verify offline against /.well-known/keys, no account required.write
- weather_alerts — Active US NWS weather alerts/warnings — tornado, flood, severe thunderstorm, heat, winter, air-quality, marine. `area` = 2-letter US state (CA, TX, FL...) or marine zone; blank = nationwide Severe/Extreme. `event` optionally filters by type. Life-safety data that expires in hours; keyless, US public domain. Pairs with current_weather/weather_forecast. Every value is returned in an Ed25519-signed, provenance-stamped envelope (source and observation time) you can verify offline against /.well-knowrite
- carbon_intensity — Great Britain grid carbon intensity right now (gCO2/kWh + index) + the live fuel mix + the cleanest upcoming half-hour from the 24h forecast. Use to time energy-heavy work / answer "is the grid clean now?". Keyless, CC-BY. GB only — see grid_carbon for Australia (per-NEM-state) + GB. Every value is returned in an Ed25519-signed, provenance-stamped envelope (source and observation time) you can verify offline against /.well-known/keys, no account required.write
- sec_filings — Recent SEC EDGAR filings for a US public company by `ticker` (AAPL, NVDA, TSLA...). `form` optionally filters: 8-K (material event), 10-K/10-Q (financials), S-1 (IPO), 4 (insider trade). Filed continuously — a model can't know the recent ones. Keyless, US public domain. Every value is returned in an Ed25519-signed, provenance-stamped envelope (source and observation time) you can verify offline against /.well-known/keys, no account required.write
- ai_models — Current & trending AI MODELS from the open-model ecosystem (Hugging Face) — name, org, task, popularity (likes/downloads) and release date. Use for "what AI models are trending / newest / what's the latest <X> model". This is the OPEN side (Llama, Qwen, DeepSeek, Mistral, Gemma, Phi…); for the closed flagships (GPT, Claude, Gemini, Grok) with pricing & versions use search_ai_models. Args: query: search a model name (e.g. llama, qwen, whisper). org: filter by org/author (e.g. meta-llama, deepwrite
- service_status — Live up/down/degraded status for major AI & dev services (OpenAI, Anthropic, GitHub, Cloudflare, etc.). Use this to answer "is X up right now?". Services with issues are listed first. Args: category: filter by ai | dev | infra | platform. only_issues: only return services currently degraded or down. limit: max results. Envelope: measured_at = when the freshest status row was last probed (each row's `updated_at`); max_age 300s matches the ~5-min probe cadence, so freshness is honest live/stwrite
- ai_provider_latency — Measured latency & uptime for each major AI provider's API (OpenAI, Anthropic, Google, Mistral, Groq, DeepSeek, xAI) — Dynamic Feed's own measurements, fastest first. Use this to pick the fastest/most-reliable provider right now, or to route. Args: window_hours: rolling window for the averages (default 24). Envelope: this is OUR measurement probe, so measured_at = when we last probed (the freshest row's `last_checked`); max_age 15 min covers the ~10-min probe cadence, so a current reading is "write
- software_version — Latest stable versions & end-of-life (EOL) dates for software — languages, runtimes, frameworks, databases, and OSes (Python, Node.js, PostgreSQL, React, Kubernetes, Ubuntu, ...). Use this instead of guessing: "what's the latest stable version of X?" and "is version Y still supported or end-of-life?". Each result has `latest_version`, `eol_date`, and a `status` (supported / nearing-eol / end-of-life), plus a provenance envelope. Source: endoflife.date. Args: product: exact product slug (e.g. pwrite
- security_advisories — Recent software security advisories / CVEs — each with the affected package, vulnerable version range, the patched version that fixes it, severity, and CVSS score. Use this to check if a package has a recent advisory, or to get the latest critical CVEs. Pairs with software_version (is my stack current AND safe?). Newest first. Source: GitHub Advisory Database. Note: covers recently-published reviewed advisories, not the full historical CVE corpus. Envelope: this is an EVENT feed, so checked_at =write
- market_hours — Returns current open/closed status and next open/close times for major exchanges, crypto (24/7), and forex (24/5). Appropriate when a user asks whether a trading venue or market session is open. Every value is returned in an Ed25519-signed, provenance-stamped envelope (source and observation time) you can verify offline against /.well-known/keys, no account required.write
- interest_rates — Live US benchmark interest rates — Effective Fed Funds Rate, SOFR, OBFR, etc. from the New York Fed. Use instead of guessing the current Fed/benchmark rate (training data is stale). Every value is returned in an Ed25519-signed, provenance-stamped envelope (source and observation time) you can verify offline against /.well-known/keys, no account required.write
- satellites — Satellite/constellation catalog with each satellite's altitude, orbital period, and a derived speed-of-light round-trip latency to ground (the physics floor for orbital networks / data centers in space). Use for "how many Starlink satellites / orbital latency". Args: group: starlink, stations, gps-ops, oneweb, galileo, weather, active, geo, science. limit: max satellites in the sample. Every value is returned in an Ed25519-signed, provenance-stamped envelope (source and observation time) yowrite
- satellite_position — Real-time position of ANY satellite by its NORAD id OR a common name — computed with SGP4 from the latest live TLE: exact latitude/longitude, altitude, velocity, ground-footprint radius, the speed-of-light latency floor, and how old the TLE is. Use for "where is the ISS / Hubble right now" or to get a precise sub-satellite point. This is the TRUE propagated position, not an approximation. Args: norad_id: NORAD catalog number (e.g. 25544 = ISS, 20580 = Hubble, 44714 = a Starlink). name: a comwrite
- rocket_launches — Upcoming or recently-launched orbital rocket launches from Launch Library 2 (The Space Devs). Per launch: name, provider (+ type/country), vehicle (+ family/reusability/flight count), pad + location (+ coordinates), net launch time + a live countdown (T-minus / T-plus), net precision + launch window, mission (name/type/orbit/description), and current go/scrub status. `window` = "upcoming" (default — next launches by net time) | "previous" (recently launched). `limit` = how many to return, 1-30 (write
- gov_contracts — US federal contract & assistance awards from USAspending.gov (keyless, US public domain). Who was awarded what, by which agency, for how much, over what period, the authoritative public spending record routinely cross-examined in audits, FOIA and litigation, so a decision about a vendor or programme can be backed by a signed, contemporaneous record. args (all optional): agency (awarding top-tier agency name contains), recipient (vendor name contains), keyword (free-text on description), award_tywrite
- spacex — Live SpaceX activity — next & recent SpaceX launches + Starlink constellation size, from public data; not financial/stock data. A single composite digest answering "what is SpaceX doing right now": the next SpaceX launches and the most recent ones (name, vehicle, pad, net launch time + live countdown, go/scrub status), plus the size of the Starlink constellation we track (object count + a couple of sample objects). Argless. INDEPENDENT — not affiliated with or endorsed by SpaceX; "SpaceX"/"Starlwrite
- orbital_data_centers — DATA CENTERS IN SPACE — curated registry of compute/AI spacecraft in orbit (Starcloud's NVIDIA H100 GPU, ESA Φsat-2 AI edge, D-Orbit in-orbit cloud), each enriched with LIVE orbital data (altitude, period, inclination) and the speed-of-light round-trip latency floor for ground links. Use for "what data centers / compute are in space, and the latency to reach them". Unique data. Every value is returned in an Ed25519-signed, provenance-stamped envelope (source and observation time) you can verifywrite
- space_weather — Full space-weather now-cast (NOAA SWPC) — the NOAA R/S/G storm scales (radio blackout / radiation storm / geomagnetic storm), geomagnetic Kp index, solar wind (speed, density, and Bz — the storm driver), the latest solar X-ray flux / flare, and an aurora-visibility hint. Affects satellite comms & drag, GPS accuracy, HF radio, power grids, and the radiation/power environment for orbital compute. Use for "is there a geomagnetic/solar storm right now". Every value is returned in an Ed25519-signed,write
- internet_outages — Live BGP routing health for a network resource — an ASN (e.g. "AS3215"), an IP ("8.8.8.8"), or a prefix ("193.0.0.0/22") — from RIPEstat (RIPE NCC's open routing-information service). Returns global visibility (how many of RIPE's route collectors currently see the resource) + an outage signal: healthy ≥0.9 · degraded ≥0.5 · outage <0.5. A sharp visibility drop = the network is losing global reachability. Use for "is network/ASN X reachable right now?". Pass `resource`. Every value is returned iwrite
- gps_interference — Probable GPS/GNSS interference (jamming/spoofing) over an area, MEASURED from live ADS-B navigation integrity (the GPSJam method) — unique to Dynamic Feed, derived from adsb.lol (CC0). Pass a region preset (london · blacksea · baltic · easternmed · persiangulf · korea · finland · caucasus · northsea) OR lat+lon (+ radius_km). A high degraded_fraction = many aircraft losing GPS-grade navigation = probable interference (none <0.1 · low ≥0.1 · medium ≥0.25 · high ≥0.5). Every value is returned inwrite
- energy_grid — Live US electricity grid data by region/operator (US EIA, public domain). region = US48 (national) or a grid operator: CAISO · PJM · MISO · ERCOT · ISONE · NYISO · SPP · BPA. metric = demand | generation | mix (current fuel mix in MW). Hourly. Pairs with carbon_intensity. Every value is returned in an Ed25519-signed, provenance-stamped envelope (source and observation time) you can verify offline against /.well-known/keys, no account required.write
- global_macro — Worldwide macro indicators for ANY country (World Bank Open Data, CC-BY). country = an ISO code (US, GB, DE, IN, BR, JP, CN, ZA…) or name. indicator = gdp · gdp_growth · gdp_per_capita · cpi_inflation · unemployment · population · exports · imports · current_account · fx_reserves · fdi · govt_debt_pct_gdp · all. Globalizes the China-only macro to the whole world. Every value is returned in an Ed25519-signed, provenance-stamped envelope (source and observation time) you can verify offline againswrite
- earthquakes — Recent earthquakes worldwide from USGS — magnitude, depth, location, PAGER impact alert (green→ red, distinct from raw magnitude), tsunami flag, felt reports and significance. Use for "recent / biggest earthquakes" or "was there a quake near X". Sorted by impact then magnitude. Args: min_magnitude: minimum magnitude (default 2.5). period: hour | day | week | month (default day). limit: max results. tsunami_only: only quakes flagged with tsunami potential. Every value is returned in an Ewrite
- natural_events — Active natural events worldwide from NASA EONET — wildfires, severe storms (hurricanes/typhoons), volcanoes, floods, sea/lake ice. Use for "what natural disasters/events are happening right now". Args: category: wildfires | severeStorms | volcanoes | floods | seaLakeIce (blank = all). days: look-back window in days (default 30). limit: max results. Every value is returned in an Ed25519-signed, provenance-stamped envelope (source and observation time) you can verify offline against /.well-write
- wildfires — Active US wildfires from NIFC WFIGS — incident name, size in acres, % contained, cause, state and location. The 'how big / how contained' detail satellite hotspot feeds can't give (pairs with natural_events, which has global fire points but not size/containment). Largest first. Args: state: optional US state filter, e.g. CA, TX (2-letter). only_uncontained: only fires below 100% containment. min_acres: minimum incident size in acres. limit: max results. Every value is returned in an Ed2write
- global_disasters — Active worldwide disaster alerts (GDACS) — ONE cross-hazard feed across earthquakes, tropical cyclones, floods, droughts and volcanoes, each with a Green/Orange/Red humanitarian-impact level and the affected countries. Use for "what major disasters are happening in the world right now / in country X". The global severity layer complementing earthquakes, wildfires and natural_events. Args: alert_level: levels to include — "Orange;Red" (default, impactful) or "Green;Orange;Red" (all). event_tywrite
- volcanoes — Current US volcano alert levels (USGS Volcano Hazards Program, keyless, public domain). `status`: 'elevated' (default — only volcanoes at YELLOW/ORANGE/RED or ADVISORY/WATCH/WARNING) or 'all' (every USGS-monitored volcano). Each result carries the ground `alert_level`, aviation `color_code`, the observatory, when the notice was issued and the official notice URL, most-severe first. SCOPE: US volcanoes only — the global Smithsonian GVP dataset is licensed non-commercial, so it's not included. Evwrite