LiveDataLink
Server Details
One key for 284 tools across 59 US public-data domains. Resale-safe government and open data.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP
- URL
- Server Listing
- LiveDataLink
Glama MCP Gateway
Connect through Glama MCP Gateway for full control over tool access and complete visibility into every call.
Full call logging
Every tool call is logged with complete inputs and outputs, so you can debug issues and audit what your agents are doing.
Tool access control
Enable or disable individual tools per connector, so you decide what your agents can and cannot do.
Managed credentials
Glama handles OAuth flows, token storage, and automatic rotation, so credentials never expire on your clients.
Usage analytics
See which tools your agents call, how often, and when, so you can understand usage patterns and catch anomalies.
Tool Definition Quality
Average 3.9/5 across 231 of 231 tools scored. Lowest: 2.7/5.
Most tools have distinct purposes and clear descriptions, but the sheer number (231) across many domains causes some potential confusion among similar tools like census_* or stock_quote variants. Overall, an agent can differentiate with careful attention.
Naming conventions are mixed: some domains use consistent prefixes (e.g., cdc_, fred_, nrel_), but the overall pattern is not uniform. Some tools have descriptive names, others are compound. No strict verb_noun pattern.
231 tools is excessive for a single MCP server. It tries to cover 50+ domains, leading to an unfocused and overwhelming tool surface. A typical well-scoped server should have 3-15 tools; this is far beyond that.
Some domains are well-covered (e.g., FRED, EDGAR, EPA), while others have only one or two tools (e.g., cargo_crate, npm_package). Coverage is uneven, and certain workflows may have gaps. Overall, it's a mixed bag.
Available Tools
284 toolsair_qualityRead-onlyIdempotentInspect
Get current air quality data for any location. Returns US AQI index, PM2.5, PM10, ozone, NO2, SO2, and CO levels with health category rating. Use this for 'what's the air quality?', 'is it safe to go outside?', 'pollution levels', 'AQI in Los Angeles', 'should I wear a mask?', 'is there smoke in the air?', or any air quality or pollution question.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| location | Yes | City, zip code, or place name |
bank_health_reportRead-onlyIdempotentInspect
One-call financial-health read for a US bank or savings institution. Give a bank name or an FDIC certificate (CERT) number. Joins FDIC BankFind institution + financials (total assets, deposits, net income, return on assets/equity, active-vs-failed status) with the CFPB Consumer Complaint Database (complaint volume and top complaint products for the matched company) into a HEALTHY / STABLE / WATCH / FAILED read with the numbers behind it. FDIC is the primary signal; CFPB complaint data is best-effort and degrades gracefully if the bank's complaint records cannot be matched. Useful for picking a sponsor/partner bank, treasury counterparty checks, or deposit-safety questions. Informational, not a rating or advice.
| Name | Required | Description | Default |
|---|---|---|---|
| bank | No | Bank or savings institution name (e.g. 'JPMorgan Chase Bank', 'Cross River Bank'). Use the full legal name for best matching. | |
| cert | No | Optional FDIC certificate (CERT) number for an exact institution match, used instead of a name. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
beneficial_owner_screenRead-onlyIdempotentInspect
One-call KYB/AML ownership-chain sanctions screen: answers the real question 'is anyone in this company's ownership chain sanctioned?', not just 'is the top-level name on a list?'. Give a company name or a 20-character LEI; the tool maps the ownership structure via GLEIF (keyless CC0 reference data) - the subject entity, its ULTIMATE parent (top of the chain), and its reported direct subsidiaries, capped at about 15 entities so a broad group stays bounded - then SCREENS each entity in that set against the local sanctions/watchlist matcher (OFAC SDN / EU / UN / BIS), the same first-party matcher company_trust_check uses. Returns the mapped ownership structure, a per-entity CLEAR / HIT result (each hit naming the matched list entry, source, and score), and an overall verdict: CLEAR (no entity matched) vs HITS-FOUND (at least one entity in the chain matched). This catches a sanctioned parent or subsidiary that screening only the counterparty name would miss - the exposure beneficial-ownership rules target. Best-effort: if GLEIF hops fail the subject is still screened; if the sanctions binding is unavailable the screen is noted as unavailable, never silently passed. Only relationships an entity self-reports to GLEIF are shown. A name match is not proof of identity and must be cleared. Informational public-record synthesis, not legal, compliance, or sanctions-clearance advice.
| Name | Required | Description | Default |
|---|---|---|---|
| lei | No | Optional exact 20-character LEI code to anchor the ownership chain directly (e.g. '5493006MHB84DD0ZWV18'). Overrides a name search. | |
| company | No | Company / organization name (e.g. 'Alphabet Inc.', 'JPMorgan') or a 20-character LEI code. Provide this or 'lei'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
bls_indicatorRead-onlyIdempotentInspect
US labor & price statistics from the Bureau of Labor Statistics by friendly name. Available: unemployment_rate, labor_force_participation, employment_population_ratio, cpi, cpi_less_food_energy, nonfarm_payrolls, avg_hourly_earnings, avg_weekly_hours, ppi_final_demand. Returns a monthly time series. Keyless official BLS data.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| end_year | No | End year (optional; defaults to current year). | |
| indicator | No | Indicator name, one of: unemployment_rate, labor_force_participation, employment_population_ratio, cpi, cpi_less_food_energy, nonfarm_payrolls, avg_hourly_earnings, avg_weekly_hours, ppi_final_demand. | |
| start_year | No | Start year (optional; defaults to ~3 years back). |
bls_seriesRead-onlyIdempotentInspect
Fetch any BLS time series by its raw series ID (e.g. 'LNS14000000' for the unemployment rate, or a state/industry series). For when you know the exact BLS series ID.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| end_year | No | End year (optional). | |
| series_id | Yes | BLS series ID, e.g. 'LNS14000000'. | |
| start_year | No | Start year (optional). |
book_detailsRead-onlyIdempotentInspect
Get full catalog metadata for a single book by its Project Gutenberg id (title, authors, subjects, languages, copyright, download count, and whether its full text is indexed here).
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| gutenberg_id | Yes | Project Gutenberg ebook id, e.g. 84 (Frankenstein). |
book_fulltext_searchRead-onlyIdempotentInspect
Search INSIDE the indexed corpus of top public-domain books for a phrase or keywords and get back the matching passages, each with the book title, author, and a snippet around the match. This is the headline feature: agents can find where a passage appears across great books. Optionally restrict to one book by gutenberg_id.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum passages to return (default 10, max 50). | |
| query | Yes | Phrase or keywords to find inside the books, e.g. 'it was the best of times', 'whale'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| gutenberg_id | No | Optional: restrict the search to a single indexed book by its Gutenberg id. |
book_get_textRead-onlyIdempotentInspect
Return the full text of an indexed book by Gutenberg id, paginated by passage. Use from_seq + max_passages to page through it. For books in the catalog that are NOT indexed locally, returns the public gutenberg.org plain-text URL so the agent can fetch it directly.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| from_seq | No | Passage index to start from (0-based, default 0). | |
| gutenberg_id | Yes | Project Gutenberg ebook id. | |
| max_passages | No | Maximum passages to return per call (default 40, max 200). |
book_searchRead-onlyIdempotentInspect
Search the full Project Gutenberg catalog (~78,500 public-domain books) live via Gutendex by title / author / subject keyword, with optional author, subject, and language filters. Ranked by keyword relevance then download popularity. Returns each book's Gutenberg id, title, author(s), language, and download count. Use book_fulltext_search to search inside the locally indexed top books.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return (default 25, max 100). | |
| query | No | Title / author / subject keyword, e.g. 'frankenstein', 'sherlock holmes', 'astronomy'. | |
| author | No | Optional author-name fragment, e.g. 'Shelley', 'Twain'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| subject | No | Optional subject fragment, e.g. 'Science fiction', 'Detective'. | |
| language | No | Optional language code filter, e.g. 'en', 'fr'. |
book_statusRead-onlyIdempotentInspect
Report the books store status: the catalog is served live via Gutendex (78,000+ books), plus the local D1 indexed-corpus counts (books with full text indexed, total indexed passages, last refresh timestamp).
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
bounce_scannerRead-onlyIdempotentInspect
Screen one or more US tickers for a mean-reversion 'bounce' setup on daily bars: price near support (recent pivot low) or the moving average, RSI oversold and turning up, a bullish latest candle, and volume at/above its recent average. Returns per-symbol {isBounce, score 0-100, reasons, price, rsi, distanceToSupportPct, supportLevel}. ALL thresholds are tunable inputs (rsi_threshold, ma_period, proximity_pct, lookback_days) so calibration is a parameter change. HEURISTIC signal for research, not investment advice.
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | No | A single ticker (e.g. 'AAPL'). Use this or `symbols`. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| symbols | No | Multiple tickers to scan (max 15). | |
| ma_period | No | Simple moving-average period used as a dynamic support reference (default 50). | |
| lookback_days | No | Trailing daily bars to analyze (default 180). | |
| proximity_pct | No | How close (percent) price must be to support/MA to count as 'near' (default 3). | |
| rsi_threshold | No | RSI(14) must be at or below this to qualify as oversold (default 35). |
candlestick_signalsRead-onlyIdempotentInspect
Detect classic candlestick patterns on a ticker's recent daily bars: hammer, inverted hammer, bullish/bearish engulfing, doji, morning/evening star, and shooting star. Returns each detected pattern with {pattern, date, direction (bullish/bearish/neutral), barIndex}. HEURISTIC pattern detection with conservative default thresholds; for research, not investment advice.
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | Yes | US ticker (e.g. 'MSFT'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| lookback_days | No | Trailing daily bars to scan for patterns (default 60). |
cargo_crateRead-onlyIdempotentInspect
Look up a Rust crate on crates.io: latest version, description, total downloads, repository, and homepage. Keyless.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Crate name, e.g. 'serde'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
carrier_vetting_scoreRead-onlyIdempotentInspect
Vet a US motor carrier (trucking company) for a freight-brokerage 'is this safe and legit to broker a load to?' decision, in one call. Give a USDOT number, MC number, or carrier name. Joins FMCSA safety data (operating authority, insurance on file, BASIC safety scores, crash and out-of-service history vs the national average, safety rating) with sanctions screening (OFAC/UN/EU/BIS on the carrier's legal name), federal-court litigation history (CourtListener), and USAspending federal awards. Returns a GO / CAUTION / NO-GO verdict with the reasons, plus all the underlying fields. NO-GO is triggered by a sanctions match or lack of active operating authority; CAUTION by BASIC alerts, fatal crashes, missing liability insurance, high out-of-service rates, or litigation. This is an analytical aid, not a substitute for your own carrier-onboarding checks.
| Name | Required | Description | Default |
|---|---|---|---|
| mc | No | MC (motor carrier) number, without the 'MC-' prefix. Used if no DOT number is given. | |
| dot | No | USDOT number of the carrier (most precise). Example: 76830. | |
| name | No | Carrier legal name, used if no DOT/MC number is given. The top FMCSA name match is vetted; prefer a DOT number for an exact carrier. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
caselaw_case_detailsRead-onlyIdempotentInspect
Get full metadata for a single case by its CAP id (name, citations, court, jurisdiction, decision date, reporter location, and the source URL for its full text).
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | CAP case id, e.g. 11301409 (Brown v. Board of Education). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
caselaw_citation_lookupRead-onlyIdempotentInspect
Resolve a reporter citation (e.g. '347 U.S. 483', '347 U. S. 483', '384 U.S. 436') to the case it identifies. Matches official and parallel citations. Returns the case metadata including its CAP id for use with caselaw_opinion_text.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| citation | Yes | A reporter citation, e.g. '347 U.S. 483'. |
caselaw_opinion_textRead-onlyIdempotentInspect
Fetch the full opinion text of a case on demand by its CAP id. Text is retrieved live from the public-domain CAP static mirror (not stored), and includes each opinion (majority, dissent, concurrence) with its author. Use max_chars to bound the response.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | CAP case id (from caselaw_search / caselaw_citation_lookup). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| max_chars | No | Maximum total characters of opinion text (default 50000, max 500000). |
caselaw_searchRead-onlyIdempotentInspect
Search US court opinions (Caselaw Access Project, public domain) by case name / keyword, court, jurisdiction, and decision-date range. Returns matching case metadata with CAP ids and citations. Use caselaw_opinion_text with a returned id to read the full opinion. Note: v1 index covers the U.S. Reports reporter (official US Supreme Court reporter).
| Name | Required | Description | Default |
|---|---|---|---|
| court | No | Optional court-name fragment, e.g. 'Supreme Court'. | |
| limit | No | Maximum rows to return (default 25, max 100). | |
| query | No | Case name or keyword, e.g. 'Brown Board Education', 'Miranda'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| end_date | No | Optional ISO date upper bound (YYYY-MM-DD). | |
| start_date | No | Optional ISO date lower bound (YYYY-MM-DD). | |
| jurisdiction | No | Optional jurisdiction fragment, e.g. 'United States'. |
cdc_dataset_queryRead-onlyIdempotentInspect
Generic SoQL query against any data.cdc.gov dataset. Use this when none of the curated tools fit. Accepts a 4x4 Socrata ID and a where-clause. SoQL reference: https://dev.socrata.com/docs/queries/
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows (default 50) | |
| order | No | SoQL order clause (e.g. 'date DESC') | |
| where | No | SoQL where clause (e.g. "state='Texas' AND year=2024") | |
| select | No | SoQL select clause (default '*') | |
| dataset | Yes | Socrata 4x4 dataset ID (e.g. 'muzy-jte6') | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
cdc_drug_overdose_deathsRead-onlyIdempotentInspect
CDC drug overdose deaths by state and indicator (9j2v-jamp). 12-month rolling counts. Useful for opioid/fentanyl/stimulant policy research and treatment-program siting.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows (default 50) | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| indicator | No | Drug class (e.g. 'Opioids (T40.0-T40.4,T40.6)', 'Synthetic opioids, excl. methadone (T40.4)') | |
| state_name | No | Full state name |
cdc_excess_deaths_covidRead-onlyIdempotentInspect
CDC excess deaths associated with COVID-19 (xkkf-xrst). Modeled expected vs observed deaths by state and week. Used to estimate true pandemic impact beyond reported COVID deaths.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows (default 50) | |
| state | No | Full state name (e.g. 'Texas') or 'United States' | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| outcome | No | Outcome (e.g. 'All causes', 'All causes, excluding COVID-19') |
cdc_flu_surveillanceRead-onlyIdempotentInspect
CDC FluView state-level influenza surveillance (vh55-3he6). Returns weekly ILI (influenza-like illness) activity levels per state.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows (default 50) | |
| season | No | Flu season (e.g. '2023-24') | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| statename | No | Full state name |
cdc_leading_causes_of_deathRead-onlyIdempotentInspect
NCHS leading causes of death by state (bi63-dtpu). Returns total deaths and age-adjusted death rates per cause per state per year. Useful for chronic disease + injury mortality research.
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Year | |
| limit | No | Max rows (default 50) | |
| state | No | Full state name or 'United States' | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| cause_name | No | Cause name (e.g. 'Heart disease', 'Cancer', 'Suicide') |
cdc_outbreak_reportsRead-onlyIdempotentInspect
CDC NORS foodborne / waterborne / enteric outbreak reports (iezt-77pi). Returns outbreak date, state, etiology, illnesses, hospitalizations, deaths, and implicated food/exposure.
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Outbreak year | |
| limit | No | Max rows (default 50) | |
| state | No | Full state name | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| etiology | No | Causative agent (e.g. 'Salmonella', 'Norovirus', 'E. coli') |
cdc_vaccination_coverageRead-onlyIdempotentInspect
COVID-19 vaccination coverage by US county (8xkx-amqh). Returns booster + primary series percentages over time. Useful for public-health gap analysis.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows (default 50) | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| recip_state | No | Two-letter state code (e.g. 'CA') | |
| recip_county | No | County name |
cdc_weekly_deaths_by_stateRead-onlyIdempotentInspect
CDC weekly provisional deaths by state and cause (NCHS dataset muzy-jte6). Returns all-cause and selected-cause death counts per state per ISO week. Useful for excess-mortality and respiratory-disease seasonality analysis.
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Year (e.g. 2024) | |
| cause | No | Cause category (e.g. 'All Cause', 'COVID-19 (U071, Multiple Cause of Death)', 'Influenza and pneumonia') | |
| limit | No | Max rows (default 50) | |
| state | No | Full state name or 'United States' for national. Default 'United States'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
census_businessRead-onlyIdempotentInspect
Business establishments, employment, and annual payroll from County Business Patterns. Optional NAICS industry filter. Used for industry research, competitive intel, supply chain analysis.
| Name | Required | Description | Default |
|---|---|---|---|
| msa | No | 5-digit Metropolitan Statistical Area code. Required for msa level. | |
| year | No | ACS 5-year endpoint year (default 2023). | |
| zcta | No | 5-digit ZIP Code Tabulation Area. Required for zcta level. | |
| level | Yes | Geography level: 'us', 'state', 'county', 'zcta' (ZIP), 'place' (city), 'tract', 'msa'. | |
| naics | No | Optional NAICS 2017 industry code (2 to 6 digits). E.g. '23' for Construction, '54' for Professional Services. | |
| place | No | Census place FIPS (city). Required for place level. | |
| state | No | 2-letter state code (e.g. 'TX') or 2-digit FIPS. Required for state/county/place/tract levels. | |
| tract | No | 6-digit census tract code. Use '*' for all tracts in a county. | |
| county | No | 3-digit county FIPS. Use '*' for all counties in a state. Required for county/tract levels. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
census_commute_employmentRead-onlyIdempotentInspect
Labor force, unemployment, commute times, public transit usage, work-from-home rates for a US geography. Used for site selection, workforce analysis, commercial real estate.
| Name | Required | Description | Default |
|---|---|---|---|
| msa | No | 5-digit Metropolitan Statistical Area code. Required for msa level. | |
| year | No | ACS 5-year endpoint year (default 2023). | |
| zcta | No | 5-digit ZIP Code Tabulation Area. Required for zcta level. | |
| level | Yes | Geography level: 'us', 'state', 'county', 'zcta' (ZIP), 'place' (city), 'tract', 'msa'. | |
| place | No | Census place FIPS (city). Required for place level. | |
| state | No | 2-letter state code (e.g. 'TX') or 2-digit FIPS. Required for state/county/place/tract levels. | |
| tract | No | 6-digit census tract code. Use '*' for all tracts in a county. | |
| county | No | 3-digit county FIPS. Use '*' for all counties in a state. Required for county/tract levels. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
census_demographicsRead-onlyIdempotentInspect
Race, ethnicity, and age breakdown for a US geography. Returns counts for white, black, Asian, AIAN, NHPI, other, two-or-more, plus Hispanic/Latino total and median age. Source: ACS 5-year.
| Name | Required | Description | Default |
|---|---|---|---|
| msa | No | 5-digit Metropolitan Statistical Area code. Required for msa level. | |
| year | No | ACS 5-year endpoint year (default 2023). | |
| zcta | No | 5-digit ZIP Code Tabulation Area. Required for zcta level. | |
| level | Yes | Geography level: 'us', 'state', 'county', 'zcta' (ZIP), 'place' (city), 'tract', 'msa'. | |
| place | No | Census place FIPS (city). Required for place level. | |
| state | No | 2-letter state code (e.g. 'TX') or 2-digit FIPS. Required for state/county/place/tract levels. | |
| tract | No | 6-digit census tract code. Use '*' for all tracts in a county. | |
| county | No | 3-digit county FIPS. Use '*' for all counties in a state. Required for county/tract levels. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
census_geography_lookupRead-onlyIdempotentInspect
Look up Census FIPS codes by name. Supports state name or 2-letter code, ZIP code (5 digits), and (for state) substring matching. Use this to find the FIPS codes needed by other census_* tools.
| Name | Required | Description | Default |
|---|---|---|---|
| level | No | Optional filter: state, county, zcta, place. | |
| limit | No | Max matches (default 10). | |
| query | Yes | Free-text: state name ('Texas'), state code ('TX'), or 5-digit ZIP ('77301'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
census_income_housingRead-onlyIdempotentInspect
Median household income, per capita income, housing units, owner vs renter occupancy, median home value, median gross and contract rent for a US geography. Used for real estate AI, market analysis, location-based pricing.
| Name | Required | Description | Default |
|---|---|---|---|
| msa | No | 5-digit Metropolitan Statistical Area code. Required for msa level. | |
| year | No | ACS 5-year endpoint year (default 2023). | |
| zcta | No | 5-digit ZIP Code Tabulation Area. Required for zcta level. | |
| level | Yes | Geography level: 'us', 'state', 'county', 'zcta' (ZIP), 'place' (city), 'tract', 'msa'. | |
| place | No | Census place FIPS (city). Required for place level. | |
| state | No | 2-letter state code (e.g. 'TX') or 2-digit FIPS. Required for state/county/place/tract levels. | |
| tract | No | 6-digit census tract code. Use '*' for all tracts in a county. | |
| county | No | 3-digit county FIPS. Use '*' for all counties in a state. Required for county/tract levels. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
census_populationRead-onlyIdempotentInspect
Get total population for a US geography (state, county, ZIP/ZCTA, city, census tract, MSA, or national). Returns total, male, female, and median age. Used for market sizing, location intelligence, demographic analysis.
| Name | Required | Description | Default |
|---|---|---|---|
| msa | No | 5-digit Metropolitan Statistical Area code. Required for msa level. | |
| year | No | ACS 5-year endpoint year (default 2023). | |
| zcta | No | 5-digit ZIP Code Tabulation Area. Required for zcta level. | |
| level | Yes | Geography level: 'us', 'state', 'county', 'zcta' (ZIP), 'place' (city), 'tract', 'msa'. | |
| place | No | Census place FIPS (city). Required for place level. | |
| state | No | 2-letter state code (e.g. 'TX') or 2-digit FIPS. Required for state/county/place/tract levels. | |
| tract | No | 6-digit census tract code. Use '*' for all tracts in a county. | |
| county | No | 3-digit county FIPS. Use '*' for all counties in a state. Required for county/tract levels. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
cfpb_complaint_aggregationsRead-onlyIdempotentInspect
Aggregate complaint counts by a single facet (product, issue, company, state, company_response, or submitted_via). Useful for ranking companies by complaint volume or finding the most common issue categories.
| Name | Required | Description | Default |
|---|---|---|---|
| facet | Yes | Field to aggregate by | |
| company | No | Optional company filter | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
cfpb_complaint_detailRead-onlyIdempotentInspect
Fetch a single CFPB complaint by complaint_id. Returns the full record including narrative if consented.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| complaint_id | Yes | CFPB complaint ID |
cfpb_complaint_trendsRead-onlyIdempotentInspect
Time-series trends of complaint volume. lens=overview shows total complaints over time; lens=product shows by product; lens=company shows by company; lens=issue shows by issue. Interval can be month, quarter, or year.
| Name | Required | Description | Default |
|---|---|---|---|
| lens | Yes | Trend dimension | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| product | No | Filter to a specific product | |
| sub_lens | No | Optional sub-dimension | |
| trend_depth | No | Top N to track (default 5) | |
| trend_interval | No | Time bucket size | |
| date_received_max | No | YYYY-MM-DD upper bound | |
| date_received_min | No | YYYY-MM-DD lower bound |
cfpb_search_complaintsRead-onlyIdempotentInspect
Search the CFPB Consumer Complaint Database (4M+ complaints submitted against financial companies since 2011). Filter by free-text term, company, product, state, date range, and narrative-presence. Returns complaint metadata plus public narratives when available.
| Name | Required | Description | Default |
|---|---|---|---|
| from | No | Pagination offset (default 0) | |
| size | No | Page size (default 25, max 100) | |
| state | No | Two-letter state code | |
| company | No | Exact company name (use cfpb_suggest_company for fuzzy matching) | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| product | No | CFPB product category (e.g. 'Credit reporting', 'Mortgage', 'Debt collection') | |
| search_term | No | Free-text search across all complaint fields | |
| has_narrative | No | Only complaints with consumer narratives | |
| date_received_max | No | YYYY-MM-DD upper bound | |
| date_received_min | No | YYYY-MM-DD lower bound |
cfpb_state_complaintsRead-onlyIdempotentInspect
Complaint counts and percentages per US state, with optional product filter and date range. Useful for state-level financial-consumer risk maps.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| product | No | Optional product filter | |
| date_received_max | No | YYYY-MM-DD upper bound | |
| date_received_min | No | YYYY-MM-DD lower bound |
cfpb_suggest_companyRead-onlyIdempotentInspect
Auto-complete company names. Returns up to 10 suggestions matching the partial input. Use the results as exact values for cfpb_search_complaints' company parameter.
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | Partial company name | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
chemical_hazardsRead-onlyIdempotentInspect
Return the public GHS (Globally Harmonized System) hazard classification for a chemical from the NIH/NLM PubChem database (keyless, public-domain data). Given a chemical name or PubChem CID, it resolves the compound and returns the GHS signal word (Danger/Warning) and the list of GHS hazard statements (e.g. 'H302: Harmful if swallowed'). If PubChem has no GHS classification on file for the compound, that is reported gracefully. This is informational public GHS classification data, not regulatory guidance or a safety data sheet - verify against an official SDS before handling any chemical.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | A chemical name (e.g. 'acetone', 'aspirin') or a numeric PubChem CID. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
chemical_lookupRead-onlyIdempotentInspect
Resolve a chemical name (e.g. 'aspirin', 'caffeine') or a PubChem CID to its core identity and physical properties using the NIH/NLM PubChem public database (keyless, public-domain data). Returns the PubChem Compound ID (CID), IUPAC systematic name, molecular formula, molecular weight (g/mol), and the canonical SMILES structure string. Use it to disambiguate a substance and obtain a stable CID join key for further chemistry or safety lookups.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | A chemical name (e.g. 'aspirin', 'sodium chloride') or a numeric PubChem CID (e.g. '2244'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
clinical_site_selectorRead-onlyIdempotentInspect
One-call clinical-trial-activity + local-specialist-availability read for a medical condition in a US geography - the question a trial sponsor, CRO, or site-feasibility analyst asks before choosing where to run a study. Joins three keyless public sources: ClinicalTrials.gov (exact count of RECRUITING trials for the condition, scoped to the geography and compared to the national total, plus the top lead sponsors and phase mix from the recruiting sample), the NPPES NPI Registry (local specialist availability - how many providers carry a specialty taxonomy relevant to the condition in the area, across physicians and NPs/PAs/pharmacists/RNs in the field), and optionally US Census ACS population context for the state (needs a Census key; degrades gracefully). The condition is mapped to a provider specialty heuristically; pass an explicit 'specialty' to override. Returns a readable brief with a headline banding trial activity (HIGH/MODERATE/LOW/NONE) and specialist availability. A source that fails is noted, not fatal. INFORMATIONAL research / site-feasibility synthesis, NOT medical advice or a directive to enroll in any trial.
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | Optional city to further localize the trial-location and provider search (e.g. 'Houston'); use with state. | |
| state | No | Optional 2-letter US state to scope trial and provider counts (e.g. 'TX'). Omit for a national read. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| condition | Yes | Medical condition / disease to evaluate (e.g. 'melanoma', 'type 2 diabetes', 'Alzheimer disease'). | |
| specialty | No | Optional NPPES specialty taxonomy keyword to override the condition-to-specialty mapping (e.g. 'Cardiology', 'Endocrinology'). |
cms_home_health_searchRead-onlyIdempotentInspect
Search Medicare-certified home health agencies from CMS Home Health Compare. Returns agency name, address, services offered, and quality ratings.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results (default 25) | |
| state | No | Two-letter state code (e.g. 'CA', 'NY') | |
| offset | No | Pagination offset (default 0) | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| name_contains | No | Partial provider name match |
cms_hospice_searchRead-onlyIdempotentInspect
Search Medicare-certified hospice agencies from CMS Hospice Compare. Returns provider name, address, ownership, and quality measures.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results (default 25) | |
| state | No | Two-letter state code (e.g. 'CA', 'NY') | |
| offset | No | Pagination offset (default 0) | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| name_contains | No | Partial provider name match |
cms_hospital_searchRead-onlyIdempotentInspect
Search Medicare-certified hospitals from the CMS Hospital General Information dataset. Returns facility name, address, ownership type, emergency-services flag, and CMS overall star rating (1-5). Filter by state, city, and partial facility-name match.
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City name (case-insensitive) | |
| limit | No | Max results (default 25) | |
| state | No | Two-letter state code (e.g. 'CA', 'NY') | |
| offset | No | Pagination offset (default 0) | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| name_contains | No | Partial provider name match |
cms_nursing_home_searchRead-onlyIdempotentInspect
Search Medicare-certified nursing homes from CMS Nursing Home Compare. Returns name, address, ownership, certification status, total beds, and quality measures.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results (default 25) | |
| state | No | Two-letter state code (e.g. 'CA', 'NY') | |
| offset | No | Pagination offset (default 0) | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| name_contains | No | Partial provider name match |
college_accreditationRead-onlyIdempotentInspect
Current institutional accreditation status, accreditor, and (when published by DAPIP) last action date and programmatic accreditations.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| unit_id | Yes | IPEDS UNITID. |
college_compareRead-onlyIdempotentInspect
Side-by-side comparison of 2-5 schools across cost, outcomes, and admissions metrics. Pass UNITIDs.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| unit_ids | Yes | Array of 2-5 IPEDS UNITIDs. |
college_demographicsRead-onlyIdempotentInspect
Student-body demographics for one school: race/ethnicity, gender, age (under/over 25), and geographic origin (in-state, out-of-state, foreign).
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| unit_id | Yes | IPEDS UNITID. |
college_metricsRead-onlyIdempotentInspect
Cost and outcome metrics for one school: published tuition (in-state and out-of-state), average net price, six-year graduation rate, first-year retention, median earnings ten years after entry, admission rate, and SAT/ACT ranges.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| unit_id | Yes | IPEDS UNITID (Scorecard 'id'). |
college_outcomes_by_programRead-onlyIdempotentInspect
Program-level outcomes (4-digit CIP code) for one school: median earnings one year after completion, median debt at completion, and award counts.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| unit_id | Yes | IPEDS UNITID. |
college_searchRead-onlyIdempotentInspect
Search US colleges and universities by name, state, control type, size, or accreditor. Returns matching institutions with location, control, predominant degree, and enrollment.
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Substring of the institution name. | |
| size | No | Carnegie size bucket. | |
| limit | No | Max results, 1-100. Default 25. | |
| state | No | Two-letter state code (e.g. TX). | |
| control | No | Institutional control. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| accreditor | No | Substring match against the school's institutional accreditor. |
college_trendsRead-onlyIdempotentInspect
Multi-year trend for one school sourced from the Urban Institute Education Data Portal (IPEDS). Choose a metric (enrollment, graduation_rate, retention, cost) and a year range.
| Name | Required | Description | Default |
|---|---|---|---|
| metric | Yes | Trend metric. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| unit_id | Yes | IPEDS UNITID. | |
| end_year | Yes | Last academic year, e.g. 2022. | |
| start_year | Yes | First academic year, e.g. 2010. |
college_value_scoreRead-onlyIdempotentInspect
One-call 'is this degree worth the cost' read for a US college (and optionally a named program). Joins the College Scorecard / IPEDS education domain (average net price, six-year completion rate, median earnings ten years after entry, and - when a program is named - program-level median debt and 1-year earnings) with a keyless BLS wage context (CES average hourly earnings, annualized) to place those earnings against the broad US private-sector wage. Returns a plain read - STRONG VALUE / FAIR / WEAK VALUE / INSUFFICIENT DATA - with the cost-vs-earnings evidence itemized and each sub-signal scored. A source that fails is noted, not fatal. Premium cross-source synthesis; Scorecard earnings cover federally-aided students only and lag by years. Informational only, not admissions, financial, or career advice.
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | Optional 2-letter state to disambiguate the school name (e.g. 'OH'). | |
| college | Yes | US college/university name (e.g. 'University of Michigan', 'Ohio State University'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| program | No | Optional program name or CIP prefix (e.g. 'Nursing', 'Computer Science') to add program-level debt-vs-earnings evidence. |
company_complaint_profileRead-onlyIdempotentInspect
One-call CONSUMER-RISK read for a company or brand, LED by the consumer-complaint picture. Joins three public-record legs, CFPB first: CFPB Consumer Complaint Database (complaint volume for the company plus the top complaint products and issues - the primary signal), product recalls (CPSC consumer products + openFDA drug/device/food enforcement, keyed by the company), and federal-court litigation (CourtListener dockets whose caption actually names the company). Returns a rolled-up read (LOW / MODERATE / ELEVATED consumer-risk signals) that leads with complaint volume and the top complaint products/issues, then folds in recall count and severity (FDA Class I / death-related = high) and litigation hits (total + last-3-years). A leg that fails is noted, not fatal. This is consumer-complaint-centered and distinct from product_liability_screen (recall/litigation-centered for manufacturers). NHTSA vehicle recalls need a specific year+make+model so are out of scope here (use recall_screen for a vehicle). Premium cross-source synthesis; informational public-record synthesis, NOT legal advice.
| Name | Required | Description | Default |
|---|---|---|---|
| since | No | Optional lower-bound date (YYYY-MM-DD) for FDA recalls. | |
| state | No | Optional 2-letter state to scope the CFPB complaint leg (e.g. 'CA'). | |
| company | Yes | Company or brand name to profile (e.g. 'Wells Fargo', 'Peloton'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
company_infoRead-onlyIdempotentInspect
Get company profile and financial fundamentals. Returns sector, industry, employee count, business description, revenue, gross profit, EBITDA, profit margins, EPS, P/E ratio, forward P/E, dividend yield, beta, market cap, and shares outstanding. Use this for "tell me about Apple", "what does this company do?", "company financials", "what sector is Netflix in?", "how many employees does Tesla have?", or any company research question.
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | Yes | Stock ticker symbol (e.g., "AAPL") | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
company_trust_checkRead-onlyIdempotentInspect
One-call public-record trust read for a company - answers 'can I trust this company?' for KYB/vendor-diligence agents. Joins the LiveDataLink sources that carry a legitimacy or risk signal into a single standing read: an OFAC SDN / EU / UN / BIS sanctions screen (a hit is decisive), SEC EDGAR registration plus the latest filing date (legitimacy + recency), USAspending federal award history (the US government transacts with them), and EPA ECHO facility compliance (significant-non-compliance, penalty, and non-compliant-quarter flags). Returns a plain-English verdict band (ESTABLISHED PUBLIC-RECORD STANDING / STANDING WITH FLAGS / LIMITED FOOTPRINT / SANCTIONS SCREEN HIT), the positive signals, the flags to review, and the resolved identifiers. A source that fails is noted, not fatal. This is a public-record SIGNAL read, not a credit report, background check, or endorsement: absence of a record is not proof of wrongdoing and a match is not proof of guilt. Premium cross-source synthesis.
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | Optional 2-letter state to disambiguate the EPA facility search. | |
| ticker | No | Optional stock ticker hint to pin the SEC EDGAR match (e.g. 'LMT'). | |
| company | Yes | Company or organization name to check (e.g. 'Lockheed Martin', 'Acme Widgets LLC'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
congress_bill_actionsRead-onlyIdempotentInspect
Get the chronological legislative action history for one bill (introductions, committee referrals, votes, becoming law). Requires Congress number, bill type, and bill number.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max actions (default 50). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| congress | Yes | Congress number. | |
| bill_type | Yes | Bill type code: hr (House Bill), s (Senate Bill), hjres, sjres, hconres, sconres, hres, sres. | |
| bill_number | Yes | Bill number. |
congress_bill_cosponsorsRead-onlyIdempotentInspect
List the cosponsors of one bill with their party and state. Useful for mapping coalitions behind legislation. Requires Congress number, bill type, and bill number.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max cosponsors (default 250). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| congress | Yes | Congress number. | |
| bill_type | Yes | Bill type code: hr (House Bill), s (Senate Bill), hjres, sjres, hconres, sconres, hres, sres. | |
| bill_number | Yes | Bill number. |
congress_bill_detailsRead-onlyIdempotentInspect
Get full detail for one bill, including title, sponsor, latest action, policy area, and a cosponsor party breakdown. Requires the Congress number, bill type, and bill number (e.g. 118, 'hr', 3076).
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| congress | Yes | Congress number, e.g. 118. | |
| bill_type | Yes | Bill type code: hr (House Bill), s (Senate Bill), hjres, sjres, hconres, sconres, hres, sres. | |
| bill_number | Yes | Bill number, e.g. 3076. |
congress_house_votesRead-onlyIdempotentInspect
List recent U.S. House roll-call votes for a Congress, with vote number, question, result, and date. Defaults to the current Congress.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max votes (default 20). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| congress | No | Congress number (default current, 91). |
congress_member_detailsRead-onlyIdempotentInspect
Get detailed profile for one member of Congress by bioguide ID (e.g. 'P000197'), including party history, terms served, and leadership roles.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| bioguide_id | Yes | Bioguide ID, e.g. 'P000197'. |
congress_recent_lawsRead-onlyIdempotentInspect
List bills that have become public or private law in a given Congress. Defaults to the current Congress. Use law_type 'pub' for public laws or 'priv' for private laws.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results (default 20). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| congress | No | Congress number (default current, 91). | |
| law_type | No | Law type: 'pub' or 'priv'. |
congress_search_billsRead-onlyIdempotentInspect
Search or list recent U.S. federal bills and resolutions from Congress.gov. Returns the most recently updated bills, optionally scoped to a Congress number or filtered by a free-text query. Use this to find legislation by topic or to see what is currently moving.
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort order, e.g. 'updateDate+desc' (default) or 'updateDate+asc'. | |
| limit | No | Max results (1-250, default 20). | |
| query | No | Optional free-text keyword filter (e.g. 'inflation', 'semiconductor'). | |
| offset | No | Pagination offset. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| congress | No | Congress number (e.g. 91 is current). Omit for all. |
congress_search_membersRead-onlyIdempotentInspect
Search members of Congress, optionally filtered by Congress number, two-letter state, and district. Returns name, party, chamber, and bioguide ID (use that ID with congress_member_details).
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results (default 20). | |
| state | No | Two-letter state code, e.g. 'TX'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| congress | No | Congress number. | |
| district | No | House district number. | |
| current_member | No | Limit to currently-serving members. |
corporate_ownership_treeRead-onlyIdempotentInspect
One-call FULL corporate-ownership tree for a company from GLEIF (keyless CC0 reference data). Give a company name or a 20-character LEI; the tool resolves the entity, climbs to its ULTIMATE parent (top of the ownership chain), then walks DOWN from that root to list the reported direct subsidiaries plus one level of grand-subsidiaries, each with its LEI, jurisdiction, and status (entity ACTIVE/INACTIVE + LEI registration ISSUED/LAPSED). The queried entity is marked in the tree so you can see where it sits. Distinct from resolve_entity, which returns the ultimate parent plus a subsidiary COUNT only: this returns the actual subsidiary LIST/tree for M&A, diligence, and counterparty mapping. The tree is capped (about 25 nodes) so a broad conglomerate stays bounded, with an 'and N more' note where GLEIF reports additional subsidiaries. Only relationships an entity self-reports to GLEIF are shown, so coverage varies by company. A failing hierarchy hop is noted, not fatal. Informational public-record synthesis; verify against GLEIF before relying on it.
| Name | Required | Description | Default |
|---|---|---|---|
| lei | No | Optional exact 20-character LEI code to anchor the tree directly (e.g. '5493006MHB84DD0ZWV18'). Overrides a name search. | |
| company | No | Company / organization name (e.g. 'Alphabet Inc.', 'JPMorgan') or a 20-character LEI code. Provide this or 'lei'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
cost_of_doing_business_indexRead-onlyIdempotentInspect
One-call comparative 'cost of operating a business here' read for a US state (with optional metro context). Joins three independent public sources, each a real operating-cost dimension expressed RELATIVE to the US national average (national = 1.00) so the result is a readable, comparable index: LABOR cost from BLS QCEW private-sector average annual pay across all industries (keyless), ENERGY cost from EIA retail electricity price for the commercial and industrial sectors (state vs national), and local CONTEXT from US Census ACS median household income, per-capita income, and median gross rent (needs a Census key; degrades gracefully). Returns a headline relative-cost banding (LOW / MODERATE / HIGH cost vs national) from a labor-weighted composite of the labor and energy indices, with each dimension's numbers and its own banding shown. Labor and energy are state-level; a supplied metro refines the context leg and label only. A source that fails is noted, not fatal. Informational, not a guarantee.
| Name | Required | Description | Default |
|---|---|---|---|
| metro | No | Optional 5-digit CBSA/metro code (e.g. '12420' for Austin, TX) to refine the Census local-context leg and the label. Labor and energy remain state-level. | |
| state | Yes | US state as a 2-letter code (e.g. 'TX', 'CA', 'NY') or 2-digit FIPS (e.g. '48'). Required. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
counterparty_risk_scoreRead-onlyIdempotentInspect
Compute a composite 0-100 Counterparty Risk Score for a company name. Combines findings from sanctions screening (OFAC/UN/EU/BIS), SEC EDGAR (registered-filer signal), federal courts (litigation history), EPA ECHO (environmental enforcement), and USAspending (federal contract vetting) into a single weighted metric with an explainable evidence chain. Returns: score, risk band (clean/low/moderate/elevated/high/critical), itemized evidence with citations, sources queried, sources that failed, and a plain-text summary suitable for an AI agent to surface to a user. Sanctions hits zero the score regardless of other signals. Use this when you need a single-call counterparty risk verdict instead of stitching five separate queries.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| company_name | Yes | Company or entity name to score. Examples: 'Lockheed Martin', 'Acme Holdings BV', 'Pfizer Inc'. Common suffixes (Inc/LLC/Ltd/Corp) are normalized automatically. |
court_case_searchRead-onlyIdempotentInspect
Search federal and state court opinions by keyword, court, judge, party name, or date range. Returns case summaries with citations.
| Name | Required | Description | Default |
|---|---|---|---|
| court | No | Court ID, e.g. 'scotus', 'ca9', 'nysd'. | |
| judge | No | Judge name filter. | |
| limit | No | Max results (1-50, default 10). | |
| party | No | Party name filter. | |
| query | No | Free-text search query. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| date_filed_after | No | ISO date YYYY-MM-DD. | |
| date_filed_before | No | ISO date YYYY-MM-DD. |
court_citation_resolverRead-onlyIdempotentInspect
Resolve a legal citation (e.g. '410 U.S. 113') to its CourtListener case record.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| citation | Yes | Citation string, e.g. '410 U.S. 113'. |
court_docket_lookupRead-onlyIdempotentInspect
Look up a federal docket by court ID and docket number. Returns party list and recent entries from PACER/RECAP.
| Name | Required | Description | Default |
|---|---|---|---|
| court | Yes | Court ID, e.g. 'nysd'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| docket_number | Yes | Docket number, e.g. '1:23-cv-04567'. |
court_judge_lookupRead-onlyIdempotentInspect
Look up a judge profile by name or CourtListener person ID. Returns positions, education, and bench history.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Judge full or partial name, or numeric person ID. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
court_opinion_searchRead-onlyIdempotentInspect
Full-text search of court opinions. Returns opinion text snippets, authors, and citations.
| Name | Required | Description | Default |
|---|---|---|---|
| court | No | Optional court ID filter. | |
| limit | No | Max results (1-50, default 10). | |
| query | Yes | Search text required. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
court_oral_argument_searchRead-onlyIdempotentInspect
Search SCOTUS and federal appellate oral argument audio. Returns audio URLs and transcript snippets.
| Name | Required | Description | Default |
|---|---|---|---|
| court | No | Optional court ID filter. | |
| limit | No | Max results (1-50, default 10). | |
| query | Yes | Search text. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
court_recent_filingsRead-onlyIdempotentInspect
Recent docket entries filed in a specific court, ordered newest first.
| Name | Required | Description | Default |
|---|---|---|---|
| court | Yes | Court ID, e.g. 'nysd', 'cand'. | |
| limit | No | Max results (1-50, default 10). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
cpsc_recall_searchRead-onlyIdempotentInspect
Search U.S. Consumer Product Safety Commission (CPSC) product recalls via SaferProducts.gov (keyless). Filter by product name/keyword, title, manufacturer, hazard, recall number, and date range. Returns recall number, date, title, products, hazards, remedy, manufacturers, injuries, and the official CPSC recall URL. Data: CPSC/SaferProducts.gov.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max recalls to return (default 25). | |
| title | No | Recall title keyword filter. | |
| hazard | No | Hazard keyword filter (e.g. 'fire', 'choking', 'laceration'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| product | No | Product name filter (e.g. 'stroller', 'space heater'). | |
| date_end | No | Recalls on/before this date (YYYY-MM-DD). | |
| date_start | No | Recalls on/after this date (YYYY-MM-DD). | |
| manufacturer | No | Manufacturer name filter. | |
| recall_number | No | Exact CPSC recall number (e.g. '26561'). |
cpsc_recent_recallsRead-onlyIdempotentInspect
Return the most recent U.S. CPSC product recalls (date-sorted, newest first) via SaferProducts.gov (keyless). Looks back a configurable window (default 90 days). Each result links to the official CPSC recall page. Data: CPSC/SaferProducts.gov.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of recent recalls to return (default 10). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| lookback_days | No | How many days back to scan (default 90). |
crypto_compareRead-onlyIdempotentInspect
Compare 2-5 cryptocurrencies side by side. Shows price, 24-hour change, market cap, volume, and rank for each coin in a comparison table. Use this for 'compare bitcoin and ethereum', 'BTC vs ETH vs SOL', 'which is bigger bitcoin or ethereum?', 'compare top cryptos', 'crypto head to head', or any multi-coin comparison question.
| Name | Required | Description | Default |
|---|---|---|---|
| coins | Yes | Coin names or tickers, 2-5 coins. Accept either CSV string ('bitcoin,ethereum,solana') or array (['bitcoin','ethereum','solana']). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
crypto_infoRead-onlyIdempotentInspect
Get a detailed profile for any cryptocurrency including description, market data, supply info, all-time high/low, genesis date, blockchain, categories, and website links. Use this for 'tell me about bitcoin', 'what is ethereum?', 'solana info', 'describe cardano', 'crypto profile', 'coin details', or any question asking for background information about a specific cryptocurrency project.
| Name | Required | Description | Default |
|---|---|---|---|
| coin | Yes | Cryptocurrency name or ticker (e.g., 'bitcoin', 'BTC', 'ethereum') | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
crypto_priceRead-onlyIdempotentInspect
Get the current price and market data for any cryptocurrency. Returns price in USD, 24-hour change, market cap, volume, and all-time high. Use this for 'what's the price of bitcoin?', 'how much is ethereum?', 'solana price', 'check dogecoin', 'BTC price', 'ETH value', 'crypto price check', or any question about a specific coin's current value. Supports all major cryptocurrencies: bitcoin, ethereum, solana, cardano, ripple/XRP, dogecoin, polkadot, avalanche, chainlink, polygon/MATIC, litecoin, uniswap, stellar, cosmos, NEAR, arbitrum, optimism, aptos, sui, toncoin, shiba inu, pepe, BNB, tether/USDT, USDC, and thousands more via CoinGecko ID.
| Name | Required | Description | Default |
|---|---|---|---|
| coin | Yes | Cryptocurrency name or ticker (e.g., 'bitcoin', 'BTC', 'ethereum', 'ETH') | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
crypto_trendingRead-onlyIdempotentInspect
See what's trending and hot in cryptocurrency right now. Returns the top trending coins on CoinGecko based on search activity and interest. Use this for 'what's trending in crypto?', 'hot cryptocurrencies', 'trending coins', 'what crypto is popular right now?', 'crypto buzz', 'what tokens are people looking at?', or any question about current crypto market interest and momentum.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
cve_lookupRead-onlyIdempotentInspect
Full detail for a single CVE by ID (format CVE-YYYY-NNNN). Returns CVSS scores, weakness IDs, references, and affected products from the NVD.
| Name | Required | Description | Default |
|---|---|---|---|
| cve_id | Yes | CVE identifier, e.g. CVE-2024-3094. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
cve_recentRead-onlyIdempotentInspect
Recent CVEs published in the last N days (default 7, max 120). Optional vendor and severity filters (CRITICAL, HIGH, MEDIUM, LOW).
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Lookback window in days (1-120). | |
| limit | No | Max results (default 50). | |
| vendor | No | Optional vendor filter. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| severity | No | Optional CVSS severity filter: CRITICAL, HIGH, MEDIUM, or LOW. |
cve_search_by_keywordRead-onlyIdempotentInspect
Free-text CVE search with optional date range. Matches keyword against CVE description text in the NVD.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results to return (1-2000, default 20). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| keyword | Yes | Free-text search phrase. | |
| pub_end_date | No | Optional YYYY-MM-DD upper bound. | |
| pub_start_date | No | Optional YYYY-MM-DD lower bound. |
cve_search_by_vendorRead-onlyIdempotentInspect
Search CVEs by vendor with optional product and date range filters. Vendor is matched against the NVD CPE namespace, e.g. 'apache', 'microsoft'.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results to return (1-2000, default 20). | |
| vendor | Yes | Vendor name, lowercase preferred. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| product | No | Optional product name filter. | |
| pub_end_date | No | ISO date or YYYY-MM-DD upper bound on published date. | |
| pub_start_date | No | ISO date or YYYY-MM-DD lower bound on published date. |
cwe_lookupRead-onlyIdempotentInspect
MITRE CWE detail by ID (format CWE-NNN or NNN). Returns name, abstraction, status, description, and parent/child CWE relationships.
| Name | Required | Description | Default |
|---|---|---|---|
| cwe_id | Yes | CWE identifier, e.g. CWE-79. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
disaster_declarationsRead-onlyIdempotentInspect
Recent FEMA disaster declarations filtered by state, county, incident type, or date range. Returns disaster number, title, dates, and incident category.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows to return (1-1000, default 50). | |
| state | No | Two-letter state code, e.g. 'TX'. | |
| county | No | Designated area / county name as FEMA records it. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| end_date | No | ISO date upper bound on declarationDate. | |
| start_date | No | ISO date lower bound on declarationDate. | |
| incident_type | No | Incident type filter, e.g. 'Hurricane', 'Flood', 'Severe Storm', 'Wildfire'. |
disaster_history_summaryRead-onlyIdempotentInspect
Multi-year FEMA disaster summary for a location. Buckets declarations by incident type and year so insurance brokers and realtors can assess cumulative risk on the same address used in property_lookup.
| Name | Required | Description | Default |
|---|---|---|---|
| state | Yes | Two-letter state code. | |
| years | No | Lookback window in years (default 10). | |
| county | No | County name. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
disaster_recovery_profileRead-onlyIdempotentInspect
One-call disaster-history and recovery read for a US area (county or place), keyed by NAME + state - distinct from location_risk_report, which scores a single site by address/lat-lon. Joins FEMA's OpenFEMA disaster declarations (the area's federally-declared disaster history: incident types, frequency, most-recent event, and the federal-assistance signal - which programs, Individual Assistance / Individuals & Households / Public Assistance / Hazard Mitigation, were authorized) with optional US Census ACS county population for exposure context (keyed off the FIPS codes the FEMA records carry; needs a Census key and degrades gracefully) and an optional best-effort parcel record for property context when an address is given (Maryland statewide / Texas-Harris County only). Returns a readable profile with a headline banding the area's disaster exposure LOW / MODERATE / HIGH from the declaration record. The FEMA leg is keyless and is the core signal; a source that fails is noted, not fatal. INFORMATIONAL public-record synthesis, NOT an insurance rating, a property flood-risk score, or a professional risk assessment.
| Name | Required | Description | Default |
|---|---|---|---|
| area | Yes | County or place name to profile (e.g. 'Harris', 'Orleans', 'New Orleans'). Use the name without the word 'County'. | |
| state | No | 2-letter US state code (or full state name) to scope the FEMA history (e.g. 'TX', 'LA'). Strongly recommended - required for an accurate county read. | |
| county | No | Alias for area; either may be supplied. | |
| address | No | Optional street address to attach a sample parcel/property record (Maryland statewide or Texas-Harris County only). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
earthquake_recentRead-onlyIdempotentInspect
Recent earthquakes from USGS. Filter by region (lat/lon + radius), state name, magnitude threshold, or time window.
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | ||
| lon | No | ||
| limit | No | Max events (default 50). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| end_time | No | ISO datetime upper bound (default now). | |
| location | No | Address, zip, city, or 'lat,lon' to center the search. Optional. | |
| radius_km | No | Search radius around lat/lon (max ~20000). | |
| start_time | No | ISO datetime lower bound (default 30 days ago). | |
| min_magnitude | No | Minimum magnitude (default 2.5). |
edgar_company_factsRead-onlyIdempotentInspect
Get structured XBRL financial facts for a company. Without 'concept', returns the top-level facts catalog (concepts the company has reported). With 'concept' (e.g. 'Revenues', 'Assets', 'EarningsPerShareBasic'), returns the time series of values for that concept.
| Name | Required | Description | Default |
|---|---|---|---|
| concept | No | Optional XBRL concept name (e.g. 'Revenues', 'Assets', 'NetIncomeLoss'). If omitted, returns the catalog of available concepts. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| taxonomy | No | Optional XBRL taxonomy (default 'us-gaap'). | |
| identifier | Yes | Ticker symbol or CIK. |
edgar_company_lookupRead-onlyIdempotentInspect
Look up a public company's CIK (Central Index Key) by ticker symbol or company name. CIK is required for all other EDGAR tools. Returns matches ranked exact-ticker first.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return (default 25, max 100). | |
| query | Yes | Ticker (e.g. 'AAPL') or company-name fragment (e.g. 'Apple'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
edgar_filing_contentRead-onlyIdempotentInspect
Fetch the text content of a specific SEC filing. Returns the primary document (10-K, 10-Q, etc.) stripped of HTML, suitable for LLM consumption. Use edgar_recent_filings first to get the accession number.
| Name | Required | Description | Default |
|---|---|---|---|
| cik | Yes | Filer CIK (with or without leading zeros). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| max_chars | No | Maximum characters of text to return (default 20000, max 200000). | |
| accession_number | Yes | Accession number (e.g. '0000320193-25-000006' or '000032019325000006'). |
edgar_filings_by_form_typeRead-onlyIdempotentInspect
Pull all recent SEC filings of a specific form type across all companies. Useful for monitoring (e.g. 'all 8-Ks today', 'all S-1s this week'). Returns accession numbers, filers, and filing dates.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return (default 25, max 100). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| form_type | Yes | SEC form type (e.g. '8-K', 'S-1', 'DEF 14A', '13F-HR'). | |
| start_date | No | ISO date lower bound (YYYY-MM-DD). Defaults to 30 days ago. |
edgar_full_text_searchRead-onlyIdempotentInspect
Full-text search across all SEC filings via the EDGAR EFTS index. Filter by comma-separated form types and date range. Useful for finding filings that mention specific terms.
| Name | Required | Description | Default |
|---|---|---|---|
| forms | No | Comma-separated form types to filter (e.g. '10-K,10-Q'). Optional. | |
| limit | No | Maximum rows to return (default 25, max 100). | |
| query | Yes | Search query (e.g. 'cybersecurity incident', 'going concern'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| end_date | No | Optional ISO date upper bound (YYYY-MM-DD). | |
| start_date | No | Optional ISO date lower bound (YYYY-MM-DD). |
edgar_insider_transactionsRead-onlyIdempotentInspect
List recent Form 4 insider transaction filings for a company. Returns accession numbers and filing dates; for detailed transaction data, use edgar_filing_content on each.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return (default 25, max 100). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| identifier | Yes | Ticker symbol or CIK. |
edgar_recent_filingsRead-onlyIdempotentInspect
List recent SEC filings for a company. Filter by form type (10-K, 10-Q, 8-K, 4, DEF 14A, etc.) and start date. Use ticker or CIK as identifier.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return (default 25, max 100). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| form_type | No | Optional form type filter (e.g. '10-K', '10-Q', '8-K', '4'). | |
| identifier | Yes | Ticker symbol or CIK. Examples: 'AAPL', '0000320193'. | |
| start_date | No | Optional ISO date lower bound (YYYY-MM-DD). |
eia_electricity_stateRead-onlyIdempotentInspect
Monthly state-level electricity data from EIA. Filter by state (two-letter code or 'US' for national), sector (residential / commercial / industrial / transportation / all), and metric (price / sales / revenue / customers / generation). Default: US, all sectors, price.
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Inclusive upper-bound period (ISO date or YYYY-MM). | |
| limit | No | Maximum rows to return (default 50, max 5000). | |
| start | No | Inclusive lower-bound period (ISO date or YYYY-MM depending on series cadence). | |
| state | No | Two-letter state code (e.g. 'TX', 'CA') or 'US' for national rollup. Default 'US'. | |
| metric | No | Metric: 'price', 'sales', 'revenue', 'customers', 'generation'. Default 'price'. | |
| sector | No | Sector: 'all', 'residential', 'commercial', 'industrial', 'transportation'. Default 'all'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
eia_energy_consumptionRead-onlyIdempotentInspect
Monthly US energy consumption by sector from EIA. Sectors: residential, commercial, industrial, transportation, total. Returns total energy consumed in BTU equivalents.
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Inclusive upper-bound period (ISO date or YYYY-MM). | |
| limit | No | Maximum rows to return (default 50, max 5000). | |
| start | No | Inclusive lower-bound period (ISO date or YYYY-MM depending on series cadence). | |
| state | No | Two-letter state code or 'US' for national rollup. Default 'US'. | |
| sector | No | Sector: 'total', 'residential', 'commercial', 'industrial', 'transportation'. Default 'total'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
eia_gasoline_pricesRead-onlyIdempotentInspect
Weekly US retail gasoline prices from EIA. Filter by region (PADD1-PADD5 or national) and grade (regular, midgrade, premium, diesel, all). Useful for fuel-cost analysis, transportation logistics, and consumer price tracking.
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Inclusive upper-bound period (ISO date or YYYY-MM). | |
| grade | No | Fuel grade: 'all', 'regular', 'midgrade', 'premium', 'diesel'. Default 'all'. | |
| limit | No | Maximum rows to return (default 50, max 5000). | |
| start | No | Inclusive lower-bound period (ISO date or YYYY-MM depending on series cadence). | |
| region | No | PADD region code or 'national'. Examples: 'national', 'PADD1', 'PADD3'. Default 'national'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
eia_natural_gasRead-onlyIdempotentInspect
US natural gas data from EIA. Series options: 'spot' (Henry Hub daily), 'futures' (NYMEX front-month daily), 'residential' (monthly retail to households), 'storage' (weekly working gas in storage). Default 'spot'.
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Inclusive upper-bound period (ISO date or YYYY-MM). | |
| limit | No | Maximum rows to return (default 50, max 5000). | |
| start | No | Inclusive lower-bound period (ISO date or YYYY-MM depending on series cadence). | |
| series | No | Subset to query: 'spot', 'futures', 'residential', 'storage'. Default 'spot'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
eia_oil_supplyRead-onlyIdempotentInspect
Weekly US crude oil supply data from EIA. Metrics: 'production' (US field production), 'imports' (weekly oil imports), 'stocks' (commercial crude stocks), 'refinery_inputs' (gross refinery inputs). Filter by PADD region. Default: national production.
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Inclusive upper-bound period (ISO date or YYYY-MM). | |
| limit | No | Maximum rows to return (default 50, max 5000). | |
| start | No | Inclusive lower-bound period (ISO date or YYYY-MM depending on series cadence). | |
| metric | No | Metric: 'production', 'imports', 'stocks', 'refinery_inputs'. Default 'production'. | |
| region | No | PADD region or 'national'. Examples: 'national', 'PADD1', 'PADD3'. Default 'national'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
eia_renewable_generationRead-onlyIdempotentInspect
Monthly US electricity generation by source from EIA. Sources: solar, wind, hydro, nuclear, geothermal, biomass, all. Optional state filter (default national). Returns generation in megawatt-hours.
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Inclusive upper-bound period (ISO date or YYYY-MM). | |
| limit | No | Maximum rows to return (default 50, max 5000). | |
| start | No | Inclusive lower-bound period (ISO date or YYYY-MM depending on series cadence). | |
| state | No | Two-letter state code or 'US' for national rollup. Default 'US'. | |
| source | No | Generation source: 'all', 'solar', 'wind', 'hydro', 'nuclear', 'geothermal', 'biomass'. Default 'all'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
eia_series_lookupRead-onlyIdempotentInspect
Flexible EIA series lookup. Pass any EIA series ID (e.g. 'PET.RWTC.D' for WTI crude daily, 'NG.RNGWHHD.D' for Henry Hub spot daily, 'ELEC.PRICE.US-ALL.M' for US average electricity retail price monthly). Returns time-series data for that series. Use this when no other tool covers your specific need.
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Inclusive upper-bound period (ISO date or YYYY-MM). | |
| limit | No | Maximum rows to return (default 50, max 5000). | |
| start | No | Inclusive lower-bound period (ISO date or YYYY-MM depending on series cadence). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| series_id | Yes | EIA series ID. See https://www.eia.gov/opendata/browser/ for the full catalog. |
energy_market_snapshotRead-onlyIdempotentInspect
One-call US energy market snapshot from EIA (public domain): the WTI crude (Cushing), Brent crude, and Henry Hub natural-gas benchmark prices, each enriched with derived context - latest level and date, 1-year change, where the current level sits within its own recent history (percentile), and the recent trend direction (rising/falling/flat). Answers 'what is oil/gas doing right now, and is it historically high or low' in a single call. A source that fails is noted, not fatal. Premium synthesis over the EIA domain; informational market data, not trading advice.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| lookback_days | No | Trailing daily history to pull per benchmark for the derived context (default 400 ~ 1.3 years; min 60, max 2000). |
entity_dossierRead-onlyIdempotentInspect
Build a consolidated cross-source dossier for a company in one call: SEC registration and identifiers (EDGAR), environmental footprint and regulated facilities (EPA ECHO), and sanctions/denied-party screening (OFAC/UN/EU/BIS) with a confidence score. Returns a per-source summary plus top records. This is a single AI-native lookup across data that otherwise lives in separate silos. Matches are name-based; verify identity before relying on any link.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Company / organization name, e.g. 'Chevron Corporation', 'Acme Trucking LLC'. | |
| limit | No | Max records to surface per source (default 5, max 15). | |
| state | No | Optional 2-letter US state to disambiguate location-based sources (e.g. 'TX'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
entity_resolveRead-onlyIdempotentInspect
Resolve a company across US government sources in one call. Searches SEC EDGAR, EPA ECHO, and the sanctions lists by name and returns the candidate match and strong identifiers (SEC CIK, ticker, EPA registry id) found in each. Use this to confirm WHO an entity is and gather its IDs before pulling detail. Matches are name-based candidates to verify, not certain identity links.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Company / organization name, e.g. 'Chevron Corporation', 'Acme Trucking LLC'. | |
| state | No | Optional 2-letter US state to disambiguate location-based sources (e.g. 'TX'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
environmental_site_riskRead-onlyIdempotentInspect
One-call environmental-compliance and contamination liability read for a SPECIFIC site or operator - the question a buyer, lender, or Phase-I ESA asks before a deal. Distinct from location_risk_report (which scores natural hazards plus a shallow count of nearby facilities): this drills DEEP into one named facility's EPA record via ECHO/FRS - overall compliance status, per-statute program standing (Clean Air/Water/RCRA/etc.), formal enforcement actions and penalty totals, significant-non-compliance and non-compliant-quarter flags - plus a best-effort parcel record for site context. Returns a verdict band (NO ADVERSE EPA RECORD / REVIEW RECOMMENDED / CONTAMINATION-COMPLIANCE CONCERN / NO FACILITY FOUND), the flags, and the evidence. A source that fails is noted, not fatal. This is an EPA public-record screen, not a Phase-I Environmental Site Assessment or a substitute for one. Premium cross-source synthesis.
| Name | Required | Description | Default |
|---|---|---|---|
| site | Yes | Site, facility, or operator name to screen (e.g. 'Smith Manufacturing', 'Acme Plating Inc'). | |
| state | No | Optional 2-letter state to disambiguate the EPA facility and parcel search. | |
| address | No | Optional street address to pin the parcel record. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
epa_enforcement_searchRead-onlyIdempotentInspect
List formal enforcement actions and penalties taken against a facility, plus a per-program summary of formal/informal actions, cases, and total penalties. Requires an EPA Registry ID (use epa_facility_search to find it).
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| registry_id | Yes | EPA Registry ID (FRS ID), the numeric facility identifier returned by epa_facility_search (e.g. '110001136271'). |
epa_facility_complianceRead-onlyIdempotentInspect
Report a facility's current compliance status and recent non-compliance history by environmental program (Clean Air Act, Clean Water Act, RCRA hazardous waste, Safe Drinking Water Act). Shows quarters in non-compliance, quarters in significant non-compliance, and last inspection per statute. Requires an EPA Registry ID.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| registry_id | Yes | EPA Registry ID (FRS ID), the numeric facility identifier returned by epa_facility_search (e.g. '110001136271'). |
epa_facility_detailsRead-onlyIdempotentInspect
Get a Detailed Facility Report for one facility by its EPA Registry ID: name, address, permits held, and per-statute (CAA/CWA/RCRA/SDWA) compliance and inspection summaries. Use epa_facility_search first to obtain the registry_id.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| registry_id | Yes | EPA Registry ID (FRS ID), the numeric facility identifier returned by epa_facility_search (e.g. '110001136271'). |
epa_facility_searchRead-onlyIdempotentInspect
Search EPA-regulated facilities by state, city, zip, and/or facility name. Returns each facility's Registry ID (needed for the other EPA tools), address, and a snapshot of its compliance status across Clean Air Act, Clean Water Act, RCRA (waste), and Safe Drinking Water programs. Provide at least one filter; broad queries (e.g. state only for a large state) may be rejected as too broad, so add a city, zip, or name.
| Name | Required | Description | Default |
|---|---|---|---|
| zip | No | 5-digit ZIP code (e.g. '20010'). | |
| city | No | City name (e.g. 'Washington'). | |
| name | No | Facility name or fragment (e.g. 'Pepco', 'refinery'). | |
| limit | No | Maximum facilities to return (default 25, max 100). | |
| state | No | Two-letter state or territory code (e.g. 'DC', 'TX', 'CA'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| active_only | No | If true, only return facilities flagged with active enforcement/compliance activity. |
epa_water_or_air_violationsRead-onlyIdempotentInspect
Report a facility's air (Clean Air Act) or water (Clean Water Act / Safe Drinking Water Act) violations and the related compliance summaries. Set media to 'air', 'water', or 'all'. Requires an EPA Registry ID.
| Name | Required | Description | Default |
|---|---|---|---|
| media | No | Which media to report: 'air', 'water', or 'all' (default 'all'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| registry_id | Yes | EPA Registry ID (FRS ID), the numeric facility identifier returned by epa_facility_search (e.g. '110001136271'). |
epss_scoreRead-onlyIdempotentInspect
FIRST EPSS exploit prediction score for a CVE. Returns probability (0-1) of exploitation in the next 30 days plus the percentile rank.
| Name | Required | Description | Default |
|---|---|---|---|
| cve_id | Yes | CVE identifier. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
facility_care_qualityRead-onlyIdempotentInspect
One-call care-quality + provider-identity read for a named US healthcare FACILITY (hospital, nursing home, home-health agency, or hospice). Joins two keyless federal sources: CMS Care Compare (data.cms.gov) for the facility's quality signal - the CMS star rating and, for a hospital, the measure-group highlights (mortality, safety of care, readmission, timely-and-effective care measured better / no different / worse vs national), plus ownership, type, and for a nursing home the health-inspection / staffing / quality-measure star breakdown, certified beds, abuse flag, and fines - and the NPPES NPI Registry for the facility's legal identity (organizational NPI, taxonomy, city/state, active status). Provide a facility name (e.g. 'Cleveland Clinic', 'Mayo Clinic Hospital'); optionally add a 2-letter state to disambiguate and a type (hospital / nursing_home / home_health / hospice) to pin the CMS dataset. When no type is given the tool infers the provider category from the NPPES taxonomy and probes the CMS datasets in order. A leg that fails is noted, not fatal. This is an INFORMATIONAL public-record read, NOT medical advice, a substitute for CMS Care Compare, or an endorsement of any facility.
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Optional provider category to pin the CMS dataset: 'hospital', 'nursing_home', 'home_health', or 'hospice'. Omit to auto-detect. | |
| state | No | Optional 2-letter state to disambiguate the facility (e.g. 'OH', 'AZ'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| facility | Yes | Facility name to look up (e.g. 'Cleveland Clinic', 'Mayo Clinic Hospital', 'Burns Nursing Home'). |
fbi_wantedRead-onlyIdempotentInspect
Search the FBI's public Wanted/fugitive list by name or keyword. Returns matching subjects with aliases, the responsible field offices, and a link. Complements sanctions screening for person due diligence. Keyless.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results (1-25, default 10). | |
| query | No | Name or keyword to search (optional; omit for the current featured list). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
fda_device_510kRead-onlyIdempotentInspect
FDA 510(k) clearances for medical devices. The 510(k) pathway is how most non-high-risk devices come to market in the US. Filter by manufacturer (applicant), device name, product code, or decision date range. Used for competitive intel, device R&D scouting, M&A research.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return (default 25, max 100). | |
| query | No | Manufacturer (applicant) name or device name search term. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| end_date | No | Inclusive ISO date upper bound (YYYY-MM-DD). | |
| start_date | No | Inclusive ISO date lower bound (YYYY-MM-DD). | |
| product_code | No | Optional product code (e.g. 'DXJ' for ECG). |
fda_device_recallsRead-onlyIdempotentInspect
FDA medical device recalls. Filter by device name or recalling manufacturer, classification (Class 1 most severe), or date range. Used for medical device supply chain monitoring and hospital biomed compliance.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return (default 25, max 100). | |
| query | No | Optional device name or recalling firm search term. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| end_date | No | Inclusive ISO date upper bound (YYYY-MM-DD). | |
| start_date | No | Inclusive ISO date lower bound (YYYY-MM-DD). | |
| classification | No | Recall classification: 1 (Class I, most severe), 2, 3. |
fda_drug_adverse_eventsRead-onlyIdempotentInspect
FDA Adverse Event Reporting System (FAERS) reports for a specific drug. Each result describes a reported adverse reaction including patient demographics, reactions, outcome, and seriousness. Used for pharmacovigilance and post-market safety analysis.
| Name | Required | Description | Default |
|---|---|---|---|
| drug | Yes | Drug name (brand or generic) to query FAERS for. Example: 'Lipitor' or 'atorvastatin'. | |
| limit | No | Maximum rows to return (default 25, max 100). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| end_date | No | Inclusive ISO date upper bound (YYYY-MM-DD). | |
| reaction | No | Optional MedDRA-preferred-term reaction filter (e.g. 'headache', 'nausea', 'liver injury'). | |
| start_date | No | Inclusive ISO date lower bound (YYYY-MM-DD). | |
| serious_only | No | If true, only return serious adverse events (death, hospitalization, life-threatening, disability). |
fda_drug_lookupRead-onlyIdempotentInspect
Look up FDA drug label info by NDC code, brand name, or generic name. Returns indications, dosage, warnings, contraindications, mechanism, manufacturer, and DEA scheduling. Used for clinical decision support, pharmacy automation, drug-info chatbots.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return (default 25, max 100). | |
| query | Yes | NDC code (e.g. '0002-1407'), brand name (e.g. 'Lipitor'), or generic name (e.g. 'atorvastatin'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
fda_drug_recallsRead-onlyIdempotentInspect
FDA drug enforcement actions (recalls). Filter by product name, recall classification (I=most severe, II, III), state, or date range. Useful for pharmacy compliance, supply chain monitoring, pharmacovigilance.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return (default 25, max 100). | |
| query | No | Optional product description / generic name / brand name search term. | |
| state | No | Optional 2-letter state filter. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| end_date | No | Inclusive ISO date upper bound (YYYY-MM-DD). | |
| start_date | No | Inclusive ISO date lower bound (YYYY-MM-DD). | |
| classification | No | Recall severity: I (most severe), II, III. |
fda_food_recallsRead-onlyIdempotentInspect
FDA food enforcement actions (food recalls). Filter by product description, recall classification, state, or date range. Used for retail food safety monitoring, supply chain compliance, restaurant management.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return (default 25, max 100). | |
| query | No | Optional product description search term. | |
| state | No | Optional 2-letter state filter. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| end_date | No | Inclusive ISO date upper bound (YYYY-MM-DD). | |
| start_date | No | Inclusive ISO date lower bound (YYYY-MM-DD). | |
| classification | No | Recall severity: I (most severe), II, III. |
fdic_depositsRead-onlyIdempotentInspect
Branch-office deposit data from the FDIC Summary of Deposits (annual snapshot). Returns deposits per branch sorted by deposit volume, useful for measuring local-market banking concentration.
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City name | |
| limit | No | Max branches (default 25) | |
| state | No | Two-letter state code | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
fdic_failuresRead-onlyIdempotentInspect
List FDIC bank failures. Filter by state and/or date range. Returns failure date, institution name, location, estimated cost, and resolution type. Sorted most-recent first. Use this for systemic-risk research, historical bank-stability analysis, or compliance work.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results (default 25) | |
| state | No | Two-letter state code | |
| offset | No | Pagination offset | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| end_date | No | End date YYYY-MM-DD | |
| start_date | No | Start date YYYY-MM-DD |
fdic_financialsRead-onlyIdempotentInspect
Get quarterly financial data for a specific bank by CERT number (FDIC Certificate Number). Returns recent quarters of assets, deposits, loans, capital ratios, income, and asset quality metrics. Most recent quarters first.
| Name | Required | Description | Default |
|---|---|---|---|
| cert | Yes | FDIC Certificate Number (get this from fdic_search_institutions) | |
| limit | No | Number of recent quarters (default 4) | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
fdic_historyRead-onlyIdempotentInspect
Institution history events for a specific bank by CERT: mergers, acquisitions, name changes, charter conversions, failures. Returns most-recent first.
| Name | Required | Description | Default |
|---|---|---|---|
| cert | Yes | FDIC Certificate Number | |
| limit | No | Max events (default 25) | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
fdic_search_institutionsRead-onlyIdempotentInspect
Search FDIC-insured banks and savings institutions by name, state, or city. Returns CERT number, name, location, total assets, deposits, net income, ROA, ROE, charter class. Use the CERT number for follow-up queries to fdic_financials or fdic_history.
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City name (exact) | |
| name | No | Institution name (partial match) | |
| limit | No | Max results (default 25) | |
| state | No | Two-letter state code (e.g. 'CA', 'TX') | |
| offset | No | Pagination offset (default 0) | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| active_only | No | Only currently-active banks (default true) |
fdic_summaryRead-onlyIdempotentInspect
Industry-level summary financials. Returns year-by-year aggregates across all FDIC-insured institutions, optionally filtered to a single state. Useful for macro banking-sector analysis.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of years (default 20) | |
| state | No | Two-letter state code (omit for national) | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
fec_candidate_detailsRead-onlyIdempotentInspect
Get full detail for a single federal candidate by FEC candidate_id (e.g. 'P80001571'). Includes office, party, status, election years, and mailing address. Use fec_candidate_search to find the candidate_id.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| candidate_id | Yes | FEC candidate ID (e.g. 'P80001571', 'S2MA00170'). |
fec_candidate_financialsRead-onlyIdempotentInspect
Get aggregate campaign finance totals for a candidate by FEC candidate_id, broken down by election cycle. Includes total receipts, disbursements, individual contributions, cash on hand, and debts. Filter to one cycle with the cycle parameter.
| Name | Required | Description | Default |
|---|---|---|---|
| cycle | No | Two-year election cycle (even year, e.g. 2024). Optional. | |
| limit | No | Maximum cycles to return (default 10, max 50). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| candidate_id | Yes | FEC candidate ID (e.g. 'S2MA00170'). |
fec_candidate_searchRead-onlyIdempotentInspect
Search federal candidates (President, House, Senate) by name, state, office, or party using FEC data. Returns candidate IDs needed for the other FEC tools.
| Name | Required | Description | Default |
|---|---|---|---|
| cycle | No | Two-year election cycle (even year, e.g. 2024). Optional. | |
| limit | No | Maximum candidates to return (default 20, max 100). | |
| party | No | Party code (e.g. 'DEM', 'REP', 'IND', 'LIB'). Optional. | |
| query | No | Candidate name fragment (e.g. 'Warren', 'Smith'). Optional. | |
| state | No | Two-letter state code to filter by (e.g. 'MA', 'TX'). Optional. | |
| office | No | Office: 'P' (President), 'S' (Senate), or 'H' (House). Optional. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
fec_committee_searchRead-onlyIdempotentInspect
Search FEC-registered political committees (campaign committees, PACs, party committees, Super PACs) by name, state, or committee type. Returns committee IDs.
| Name | Required | Description | Default |
|---|---|---|---|
| cycle | No | Two-year election cycle (even year, e.g. 2024). Optional. | |
| limit | No | Maximum committees to return (default 20, max 100). | |
| query | No | Committee name fragment. Optional. | |
| state | No | Two-letter state code to filter by. Optional. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| committee_type | No | Committee type code: 'P' (President), 'S' (Senate), 'H' (House), 'N'/'Q' (PAC), 'O' (Super PAC), 'X'/'Y' (party). Optional. |
fec_independent_expendituresRead-onlyIdempotentInspect
List independent expenditures (FEC Schedule E) supporting or opposing a candidate or made by a committee. Shows spender committee, amount, date, support/oppose, and description. Provide candidate_id or committee_id.
| Name | Required | Description | Default |
|---|---|---|---|
| cycle | No | Two-year election cycle (even year, e.g. 2024). Optional. | |
| limit | No | Maximum expenditures to return (default 20, max 100). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| candidate_id | No | FEC candidate ID the spending targets (e.g. 'P80001571'). Provide this or committee_id. | |
| committee_id | No | FEC committee ID of the spender (e.g. 'C00804856'). Provide this or candidate_id. |
flood_zone_lookupRead-onlyIdempotentInspect
FEMA flood zone designation for an address or coordinate. Returns the zone code, plain-English risk, BFE if applicable, FIRM panel reference, and whether NFIP insurance is mandated for federally-backed mortgages.
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | ||
| lon | No | ||
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| location | No | Address or zip to geocode. |
fmcsa_carrier_authorityRead-onlyIdempotentInspect
Check if a trucking company is legally authorized to operate and has valid insurance. Returns operating authority status (common, contract, broker - active/inactive/revoked), BIPD insurance, cargo insurance, bond/surety status, and whether they're allowed to haul freight. Use this for questions like 'can this carrier legally operate?', 'do they have insurance?', 'is this broker licensed?', 'verify carrier authority', 'check trucking company credentials', 'is this freight company legit?', or any carrier compliance check.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| dot_number | Yes |
fmcsa_carrier_compareRead-onlyIdempotentInspect
Compare 2 to 5 trucking companies side by side on safety, fleet size, insurance, and authority. Returns a comparison table: fleet size, driver count, safety rating, crash history, BASIC safety scores, authority status, insurance, and out-of-service rates. Use this for questions like 'which carrier is safer?', 'compare these trucking companies', 'which freight company should I use?', 'evaluate these carriers against each other', 'help me pick between these haulers', or any carrier vetting decision.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| dot_numbers | Yes | 2-5 USDOT numbers, as an array or comma-separated string. |
fmcsa_carrier_lookupRead-onlyIdempotentInspect
Look up a trucking company, freight carrier, or motor carrier by DOT number or MC number. Returns company name, address, phone, fleet size, number of drivers, safety rating, operating authority, insurance status (BIPD, cargo, bond), crash history, inspection rates, and out-of-service percentages. Use this for questions like 'is this carrier safe?', 'look up this trucking company', 'check this DOT number', 'verify this carrier', 'what's their safety rating?', or any freight carrier lookup. Covers all US carriers registered with FMCSA.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| mc_number | No | ||
| dot_number | No |
fmcsa_carrier_searchRead-onlyIdempotentInspect
Search for trucking companies, freight carriers, or motor carriers by company name. Find any carrier's DOT number, MC number, location, fleet size, and operating status. Supports partial name matching. Use this for questions like 'find this trucking company', 'what's the DOT number for Werner?', 'search for freight carriers in Texas', 'look up this logistics company', or any carrier name search. Returns up to 50 matching carriers from the FMCSA national database.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
fmcsa_safety_scoresRead-onlyIdempotentInspect
Get safety information for a trucking company by DOT number. Returns either CSA BASIC percentile scores (where FMCSA publishes them, rare per FAST Act 2015 restrictions) OR a public safety summary built from crash counts, fatal/injury crashes, driver/vehicle/hazmat out-of-service rates, and inspection volumes (always available). Use this for questions like 'is this carrier safe?', 'what's their safety record?', 'how many crashes?', 'should I hire this carrier?', 'check their inspection history', or any trucking safety evaluation. Higher BASIC percentiles = worse record. For OOS rates, lower is better; national averages provided for comparison.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| dot_number | Yes |
fred_category_seriesRead-onlyIdempotentInspect
List the most popular FRED series in a category. Category IDs are numeric (e.g. 32991 = Interest Rates, 32263 = Money Stock, 9 = National Accounts). Use this to browse FRED structurally rather than via search.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return (default 50 for observations, 25 for catalog queries). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| category_id | Yes | FRED category ID. See https://fred.stlouisfed.org/categories/ for the hierarchy. |
fred_compareRead-onlyIdempotentInspect
Compare 2 to 5 FRED series side-by-side over the same date range. Returns observations for each series. Useful for ratio analysis (e.g. compare 10Y vs 2Y yield) or cross-series correlation.
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Inclusive upper-bound ISO date (YYYY-MM-DD). | |
| limit | No | Maximum rows to return (default 50 for observations, 25 for catalog queries). | |
| start | No | Inclusive lower-bound ISO date (YYYY-MM-DD). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| series_ids | Yes | 2 to 5 FRED series IDs. |
fred_observationsRead-onlyIdempotentInspect
Get time-series observations for a FRED series ID. Workhorse query for any economic indicator. Optional date range, units transformation (lin, chg, pch, log, etc.), and frequency aggregation (m, q, a).
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Inclusive upper-bound ISO date (YYYY-MM-DD). | |
| limit | No | Maximum rows to return (default 50 for observations, 25 for catalog queries). | |
| start | No | Inclusive lower-bound ISO date (YYYY-MM-DD). | |
| units | No | Units transformation: 'lin' (default), 'chg' (change), 'ch1' (change YoY), 'pch' (% change), 'pc1' (% change YoY), 'log', etc. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| frequency | No | Aggregate to a different frequency: 'd', 'w', 'bw', 'm', 'q', 'sa', 'a'. | |
| series_id | Yes | FRED series ID (e.g. 'GDP', 'UNRATE'). See https://fred.stlouisfed.org/ for the catalog. | |
| aggregation_method | No | Aggregation method when changing frequency: 'avg', 'sum', or 'eop' (end of period). |
fred_quick_indicatorRead-onlyIdempotentInspect
Quick-access wrapper for the most-queried FRED indicators by friendly name. Avoids needing to memorize FRED series IDs. Valid indicators: unemployment_rate, fed_funds, fed_funds_target, cpi, core_cpi, gdp, real_gdp, ten_year_yield, two_year_yield, thirty_year_yield, thirty_year_mortgage, m2, industrial_production, retail_sales, nonfarm_payrolls, housing_starts, case_shiller, vix, wti, brent, natural_gas_henry_hub, dollar_index, consumer_sentiment, initial_claims, pce_inflation, recession_indicator.
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Inclusive upper-bound ISO date (YYYY-MM-DD). | |
| limit | No | Maximum rows to return (default 50 for observations, 25 for catalog queries). | |
| start | No | Inclusive lower-bound ISO date (YYYY-MM-DD). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| indicator | Yes | Friendly indicator name. See description for valid options. |
fred_releasesRead-onlyIdempotentInspect
Browse FRED economic releases (e.g. Employment Situation, CPI, GDP). With upcoming_dates=true, returns the upcoming release calendar instead. Useful for knowing when fresh data is expected.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return (default 50 for observations, 25 for catalog queries). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| release_id | No | Optional. If provided, return only that release's metadata. | |
| upcoming_dates | No | If true, return upcoming release date schedule instead of release metadata. Default false. |
fred_searchRead-onlyIdempotentInspect
Full-text search across FRED's 800,000+ economic series. Returns matching series IDs and titles ranked by popularity. Use when you don't know the exact series ID.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return (default 50 for observations, 25 for catalog queries). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| tag_names | No | Optional semicolon-delimited tag filter (e.g. 'usa;monthly'). | |
| search_text | Yes | Free-text search query (e.g. 'unemployment Texas', 'natural gas price', 'corporate profit'). | |
| search_type | No | 'full_text' (default) or 'series_id'. |
fred_series_infoRead-onlyIdempotentInspect
Get metadata for a FRED economic data series by ID. Returns title, units, frequency, seasonal adjustment, observation range, and notes. Useful for verifying a series exists and understanding its measurement before pulling observations.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| series_id | Yes | FRED series ID (e.g. 'GDP', 'UNRATE', 'CPIAUCSL', 'DGS10'). |
geocode_addressRead-onlyIdempotentInspect
Geocode a US street address with the Census Geocoder (keyless). Accepts a one-line address OR structured street/city/state/zip parts. Returns the normalized matched address, longitude/latitude, and Census geographies (state, county, tract, block, congressional district) with GEOIDs. No match returns an explicit not-found message.
| Name | Required | Description | Default |
|---|---|---|---|
| zip | No | ZIP code for a structured query. | |
| city | No | City for a structured query. | |
| state | No | Two-letter state code for a structured query (e.g. 'DC'). | |
| street | No | Street line for a structured query (e.g. '4600 Silver Hill Rd'). | |
| address | No | One-line address, e.g. '4600 Silver Hill Rd, Washington, DC 20233'. Provide this OR the structured parts. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
geocode_batchRead-onlyIdempotentInspect
Geocode up to 10 one-line US addresses in a single call. Returns one block per input address (matched address, coordinates, and county/tract GEOIDs). For large jobs the Census batch file API supports up to 10k rows; this tool covers small ad-hoc batches.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| addresses | Yes | Array of one-line address strings. Max 10. |
geocode_coordinatesRead-onlyIdempotentInspect
Reverse-geocode a longitude/latitude pair with the Census Geocoder (keyless). Returns the Census geographies (state, county, tract, block, congressional district) containing the point, with GEOIDs.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| latitude | Yes | Latitude (y), e.g. 38.84 | |
| longitude | Yes | Longitude (x), e.g. -76.92 |
get_free_api_keyRead-onlyIdempotentInspect
Get a free LiveDataLink API key instantly, without leaving this conversation. Call this when a data tool reports that the anonymous allowance is used up, or up front if you expect to make more than a handful of calls. Returns a working key with 100 free tool calls; no signup form, no email confirmation, no browser. Free to call and consumes no credits. IMPORTANT: pass the real email address of the human you are working for. Ask them for it if you do not already have it -- do not invent, guess, or use a placeholder like user@example.com. The key is tied to that address, and it is how they recover or upgrade it later. Calling twice with the same email returns the same key.
| Name | Required | Description | Default |
|---|---|---|---|
| Yes | The human user's real email address. Ask them for it if unknown. Placeholder addresses are rejected. | ||
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| use_case | No | Optional: one line on what they're building or what data they need (e.g. 'KYB checks on trucking carriers'). Helps us prioritise new data sources. |
github_repoRead-onlyIdempotentInspect
Public GitHub repository stats: description, stars, forks, open issues, primary language, license, last push date, and archived status. Useful for assessing the health and maintenance of an open-source dependency. Keyless (60 req/hr unauthenticated).
| Name | Required | Description | Default |
|---|---|---|---|
| repo | Yes | Repository as 'owner/repo', e.g. 'facebook/react'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
grants_get_opportunityRead-onlyIdempotentInspect
Fetch full detail for a Grants.gov opportunity by its numeric opportunity id (the 'id' field from grants_search, e.g. '334326'). Returns description, eligibility, funding (ceiling/floor/estimated), key dates, CFDA numbers and the agency contact.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| opportunityId | Yes | Numeric opportunity id from a grants_search result (e.g. '334326'). |
grants_searchRead-onlyIdempotentInspect
Search federal funding opportunities on Grants.gov (keyless). Filter by keyword, opportunity status (forecasted/posted/closed/archived), agency, funding category and eligibility. Returns opportunity number, title, agency, status, open/close dates and CFDA numbers.
| Name | Required | Description | Default |
|---|---|---|---|
| rows | No | Max results (default 25, max 100). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| keyword | No | Free-text keyword (e.g. 'clean energy', 'rural health'). | |
| agencies | No | Agency code filter (e.g. 'NSF', 'HHS'). Pipe-separate multiples. | |
| oppStatuses | No | Pipe-separated statuses. Default 'forecasted|posted'. Options: forecasted, posted, closed, archived. | |
| eligibilities | No | Applicant-eligibility code filter (e.g. '25' state governments, '99' unrestricted). Pipe-separate multiples. | |
| fundingCategories | No | Funding category code filter (e.g. 'ENV', 'ED'). Pipe-separate multiples. | |
| fundingInstruments | No | Funding-instrument code filter (e.g. 'G' grant, 'CA' cooperative agreement). Pipe-separate multiples. |
hurricane_trackerRead-onlyIdempotentInspect
Currently-active hurricanes and tropical systems from NOAA NHC, with category, wind/pressure, current position, movement, and forecast cone link.
| Name | Required | Description | Default |
|---|---|---|---|
| basin | No | Optional basin filter: 'AL' (Atlantic), 'EP' (Eastern Pacific), 'CP' (Central Pacific). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
influence_network_mapRead-onlyIdempotentInspect
One-call 'follow the money and influence' map for an organization, joined across three federal public-record streams: FEC (the org's connected political committees / PACs - its political-spending vehicles), the U.S. Senate Lobbying Disclosure Act (filings where the org is the client, the reported lobbying spend, the firms it hired, and the issue areas lobbied), and USAspending (federal contracts + grants the org RECEIVES, with award counts and top agencies). Returns a readable map of money flowing OUT to influence (lobbying + political committees) vs. money flowing IN from federal awards. Built for investigative journalism, govcon, and due-diligence research. Informational public-record synthesis, NOT a risk score (distinct from counterparty_risk_score). The FEC leg needs an api.data.gov key and is noted as skipped if unavailable; a source that fails is noted, not fatal.
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Optional 4-digit lobbying filing year (e.g. '2024'); defaults to the most recent year with filings. | |
| state | No | Optional 2-letter state to scope the FEC committee search. | |
| company | No | Alias for organization. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| organization | Yes | Organization / company name (e.g. 'Lockheed Martin', 'Boeing'). |
ip_reputationRead-onlyIdempotentInspect
Risk profile for an IP address: geolocation and network (ASN/ISP/org) plus two abuse signals - whether it is a known Tor exit node, and whether it appears on the abuse.ch Feodo botnet command-and-control blocklist. For fraud, abuse, and security screening. Keyless.
| Name | Required | Description | Default |
|---|---|---|---|
| ip | Yes | IPv4 or IPv6 address to screen. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
issuer_diligence_dossierRead-onlyIdempotentInspect
One-call NARRATIVE public-record diligence dossier for a public company / SEC issuer. Joins SEC EDGAR (registrant identity, CIK/ticker, recent filings and their form mix), federal courts via CourtListener (RECAP dockets whose name references the issuer), USAspending (federal contract awards, name-matched), and CPSC product-safety recalls into a readable brief with a short headline and four sections: Identity & SEC, Litigation, Federal business, and Product-safety. Every source degrades gracefully - a failing leg is noted, not fatal. This is a narrative synthesis, deliberately distinct from counterparty_risk_score (a 0-100 score) and entity_dossier (SEC+EPA+sanctions only). Informational public-record synthesis, not a background check or legal/financial advice.
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | Optional 2-letter state hint for disambiguation (currently informational). | |
| ticker | No | Optional stock ticker hint to pin the SEC EDGAR match (e.g. 'LMT'). | |
| company | Yes | Public company / SEC issuer name (e.g. 'Lockheed Martin', 'Pfizer'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
iv_analyticsRead-onlyIdempotentInspect
Compute derived options-volatility analytics for a US ticker from LiveDataLink's historical volatility series (2019-2024): IV Rank (where current implied vol sits in its own range over the lookback window), IV Percentile (share of days with lower IV), Variance Risk Premium (implied minus realized vol), 52-week IV high/low, and 1-week/1-month IV momentum. Premium synthesis over the options-history store. Analytical aid, not investment advice.
| Name | Required | Description | Default |
|---|---|---|---|
| as_of | No | Optional as-of date (YYYY-MM-DD); defaults to the latest available day. | |
| ticker | Yes | US stock ticker with listed options (e.g. 'AAPL', 'SPY'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| lookback_days | No | Trailing window for rank/percentile (default 252 ~ 1 trading year). |
kev_status_checkRead-onlyIdempotentInspect
Check whether a CVE is in the CISA Known Exploited Vulnerabilities catalog. Returns date added, due date, ransomware association, and required action.
| Name | Required | Description | Default |
|---|---|---|---|
| cve_id | Yes | CVE identifier. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
lei_hierarchyRead-onlyIdempotentInspect
Map a company's corporate family tree from the GLEIF relationship register (keyless, CC0 open data): given a company name or LEI, returns its direct parent, ultimate (top-of-tree) parent, and a list of its direct children/subsidiaries with the total subsidiary count. Answers 'who ultimately owns this company?' and 'what does this company own?' — core due-diligence and beneficial-ownership questions. Each node includes the LEI, legal name, and jurisdiction so you can drill further. Relationships GLEIF has no filing for are reported as 'none reported' (not an error).
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | A company legal name (e.g. 'Apple Inc') or a 20-character LEI code. Names resolve to the top-ranked match. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| children_limit | No | Max direct children to list (default 15, max 50). The total count is always reported. |
lei_lookupRead-onlyIdempotentInspect
Resolve a company name to its Legal Entity Identifier (LEI), or look up an LEI code directly, using the GLEIF public register (keyless, CC0 open data). Returns each matching entity's 20-character LEI, exact legal name, operating status (ACTIVE/INACTIVE), jurisdiction (ISO 3166-2), legal-form code, legal address (city/region/country), LEI registration status (ISSUED/LAPSED/RETIRED), and last-update date. The LEI is the global standard join key for entity resolution — use it to disambiguate a company and cross-reference it against sanctions, SEC EDGAR, federal spending, and due-diligence tools. Pass a name (fuzzy match, returns ranked candidates) or a 20-char LEI (exact).
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max candidate records for a name search (default 10, max 25). Ignored for an exact LEI. | |
| query | Yes | A company legal name (e.g. 'Apple Inc') or a 20-character LEI code (e.g. 'HWUPKR0MPOU8FGXBT394'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
list_tool_groupsRead-onlyIdempotentInspect
List every tool group (category) available on LiveDataLink with its domain count and tool count. Use this to discover which groups exist, then connect to https://livedatalink.ai/mcp?groups=<comma,separated> (or send the header X-Tool-Groups: <comma,separated>) to load ONLY those groups. Filtering keeps the tool list small so an agent selects tools accurately and uses less context. Free to call, no credits consumed. Optional 'query' filters group names.
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Optional substring to filter group names (case-insensitive). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
lobbying_contributionsRead-onlyIdempotentInspect
Search LDA contribution reports (political contributions disclosed by lobbyists/registrants). Filter by year, registrant, or lobbyist name.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| page_size | No | Results per page (default 20). | |
| filing_year | No | Filing year, e.g. 2025. | |
| lobbyist_name | No | Lobbyist name, partial match. | |
| registrant_name | No | Registrant (firm) name, partial match. |
lobbying_detailRead-onlyIdempotentInspect
Get the full detail of one lobbying filing by its UUID (from lobbying_search results), including all lobbying activities, issues, covered officials contacted, and the lobbyists involved.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| filing_uuid | Yes | Filing UUID from lobbying_search results. |
lobbying_lobbyistsRead-onlyIdempotentInspect
Search individual lobbyists by name (and optionally by their registrant firm). Returns lobbyist records with their associated firm.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| page_size | No | Results per page (default 20). | |
| lobbyist_name | No | Lobbyist name, partial match. | |
| registrant_name | No | Optional registrant (firm) name to scope the search. |
lobbying_registrantsRead-onlyIdempotentInspect
Search registered lobbying firms (registrants) by name. Returns registrant profile records.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| page_size | No | Results per page (default 20). | |
| registrant_name | No | Registrant (firm) name, partial match. |
lobbying_searchRead-onlyIdempotentInspect
Search U.S. federal lobbying disclosure filings (Senate LDA). Filter by year, filing type, registrant (lobbying firm), client (who hired them), or general issue code. Returns filings with the client, registrant, period, income/expenses, and lobbying issues. Pair with FEC and Congress tools to follow the money.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| page_size | No | Results per page (default 20, max 25). | |
| issue_code | No | General issue area code, e.g. 'ENG' (energy), 'TAX', 'HCR' (health). | |
| client_name | No | Client name (the entity that hired the lobbyist), partial match. | |
| filing_type | No | Filing type code, e.g. 'RR' (registration), 'Q1'-'Q4' (quarterly reports). | |
| filing_year | No | Filing year, e.g. 2025. | |
| registrant_name | No | Lobbying firm / registrant name (partial match). |
local_searchRead-onlyIdempotentInspect
Find local businesses, restaurants, services, and places near any location. Returns name, type, address, phone, website, hours, cuisine, and distance. Use this for 'find restaurants near me', 'coffee shops in downtown Houston', 'gas stations near 60601', 'best pizza in Chicago', 'pharmacies nearby', 'hotels in Austin', 'find a mechanic', 'gyms near me', or any local business or place discovery question. Supports: restaurants, cafes, bars, gas stations, pharmacies, hospitals, doctors, dentists, gyms, hotels, grocery stores, banks, schools, parks, libraries, auto repair, salons, and more.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | What to find (e.g., 'restaurants', 'coffee', 'gas station') | |
| radius | No | Search radius in miles (default: 1.5) | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| location | Yes | Where to search (city, zip, or address) |
location_risk_reportRead-onlyIdempotentInspect
One-call, site-bound hazard + environmental profile with an explainable 0-100 risk score. Geocodes an address (or takes lat/lon) then fans out to FEMA flood zone, recent FEMA disaster declarations (county), active NWS alerts, USGS earthquakes within 50km, EPA ECHO regulated facilities (by ZIP/state), and parcel records (Maryland statewide / Texas-Harris County only). The score starts at 100 and subtracts itemized deductions (flood SFHA, active alerts, declarations, EPA non-compliance, strong quakes). A failing source is noted, not fatal. Premium cross-source synthesis; not a substitute for a professional site assessment.
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Latitude (use with lon instead of address). | |
| lon | No | Longitude (use with lat instead of address). | |
| state | No | Optional 2-letter state override (helps EPA/parcel/declaration scoping). | |
| address | No | Full US street address to geocode. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
market_size_estimatorRead-onlyIdempotentInspect
One-call TAM / market-size read for an industry (NAICS) in a US geography. Joins two independent federal sources that both count business activity by NAICS + area so each corroborates the other: US Census County Business Patterns (establishments, employment, annual payroll - needs a Census API key) and BLS QCEW (keyless: private establishment count, total wages, average annual pay, with employment implied from wages / avg pay). Returns the establishment count, employment, and a wage/payroll-based market-size anchor with the per-source evidence. Pass an 'industry' (e.g. 'restaurants', 'software publishers') or an explicit 'naics' code, and an optional 'state' or 'metro' (defaults to national). Market size here is the total annual wages/payroll paid in the industry+area - a concrete lower bound, NOT total revenue/receipts. A source that fails is noted, not fatal. Informational, not a guarantee.
| Name | Required | Description | Default |
|---|---|---|---|
| metro | No | Optional 5-digit CBSA/metro code (e.g. '12420' Austin, TX). Census leg only; requires the Census key. | |
| naics | No | Explicit 2 to 6 digit NAICS industry code (e.g. '722' food services, '5112' software publishers). Overrides 'industry'. | |
| state | No | Optional 2-letter state code or 2-digit FIPS (e.g. 'TX', '48'). Omit for a national estimate. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| industry | No | Free-text industry to map to a NAICS code (e.g. 'restaurants', 'software publishers', 'construction'). Provide this or 'naics'. |
nfip_flood_claimsRead-onlyIdempotentInspect
National Flood Insurance Program claim history aggregated by zip, county, or state. Useful for insurance brokers and homebuyers assessing prior loss patterns.
| Name | Required | Description | Default |
|---|---|---|---|
| zip | No | Five-digit zip code. | |
| limit | No | Max rows (default 200). | |
| state | No | Two-letter state code. | |
| county | No | FEMA county code. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| end_year | No | Latest year of loss. | |
| start_year | No | Earliest year of loss. |
nonprofit_detailsRead-onlyIdempotentInspect
Full IRS EO BMF record for one organization by EIN, with the coded fields (subsection, foundation status, deductibility, EO status, ruling date) decoded to human-readable labels. Includes address, NTEE code, and the most recent reported asset/income/revenue figures.
| Name | Required | Description | Default |
|---|---|---|---|
| ein | Yes | Employer Identification Number (EIN). Accepts 9 digits with or without a dash, e.g. "13-1837418" or "131837418". | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
nonprofit_lookup_einRead-onlyIdempotentInspect
Look up a US tax-exempt organization by exact EIN from the IRS Exempt Organizations Business Master File (~1.27M orgs). Returns name, address, IRC subsection, and current EO status. Use nonprofit_details for the fully decoded record.
| Name | Required | Description | Default |
|---|---|---|---|
| ein | Yes | Employer Identification Number (EIN). Accepts 9 digits with or without a dash, e.g. "13-1837418" or "131837418". | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
nonprofit_search_locationRead-onlyIdempotentInspect
Find tax-exempt organizations by location: city, state, and/or 5-digit ZIP. At least one filter is required. Useful for discovering charities, churches, and foundations in an area. Returns up to 100 organizations.
| Name | Required | Description | Default |
|---|---|---|---|
| zip | No | 5-digit ZIP code. | |
| city | No | City name (combine with state for best results). | |
| limit | No | Max results to return (default 20, max 100). | |
| state | No | 2-letter US state/territory code, e.g. "TX". | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
nonprofit_search_nameRead-onlyIdempotentInspect
Fuzzy-search tax-exempt organizations by name, optionally filtered to a US state. Tolerant of word reordering and minor spelling differences. Returns ranked matches with EIN, location, and IRC subsection. Use the returned EIN with nonprofit_details or nonprofit_lookup_ein.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Organization name or partial name to search for. | |
| limit | No | Max matches to return (default 10, max 50). | |
| state | No | Optional 2-letter US state/territory code to narrow results, e.g. "NY", "TX", "CA". | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
nonprofit_statusRead-onlyIdempotentInspect
Current exempt-organization status for one organization by EIN: whether the IRS recognition is active, revoked, or terminated, plus the decoded status label, contribution deductibility, and the ruling (recognition) date. Tells donors and grantmakers if an org is still in good standing.
| Name | Required | Description | Default |
|---|---|---|---|
| ein | Yes | Employer Identification Number (EIN). Accepts 9 digits with or without a dash, e.g. "13-1837418" or "131837418". | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
npi_lookupRead-onlyIdempotentInspect
Look up a single US healthcare provider by their 10-digit NPI (National Provider Identifier). Returns name, type, credential, primary specialty (taxonomy), practice location, and status. Keyless CMS data.
| Name | Required | Description | Default |
|---|---|---|---|
| npi | Yes | 10-digit NPI number. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
npi_search_organizationRead-onlyIdempotentInspect
Search healthcare organizations (hospitals, clinics, group practices, labs) by name. Requires organization_name; state and city optional.
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City to narrow results (optional). | |
| limit | No | Max results (1-50, default 10). | |
| state | No | Two-letter state code to narrow results (optional). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| organization_name | Yes | Organization name (required). |
npi_search_providerRead-onlyIdempotentInspect
Search individual US healthcare providers by name. Requires a last_name (first_name, state, city optional). Returns NPI, specialty, location for each match.
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City to narrow results (optional). | |
| limit | No | Max results (1-50, default 10). | |
| state | No | Two-letter state code to narrow results (optional). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| last_name | Yes | Provider last name (required). | |
| first_name | No | Provider first name (optional). |
npi_search_specialtyRead-onlyIdempotentInspect
Find healthcare providers by specialty (taxonomy description) in a location. Requires taxonomy (e.g. 'Cardiology', 'Pediatrics', 'Nurse Practitioner'); state and city optional but recommended.
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City to narrow results (optional). | |
| limit | No | Max results (1-50, default 10). | |
| state | No | Two-letter state code to narrow results (optional). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| taxonomy | Yes | Specialty / taxonomy description, e.g. 'Cardiology'. |
npm_packageRead-onlyIdempotentInspect
Look up an npm (Node.js) package: latest version, description, license, repository, last publish date, deprecation status, and last-month download count. Pair with cve_search_by_keyword to check for known vulnerabilities. Keyless.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | npm package name, e.g. 'express' or '@scope/pkg'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
nrel_alt_fuel_station_detailRead-onlyIdempotentInspect
Detailed info for a single alternative fuel station by station ID. Get the ID from nrel_alt_fuel_stations results.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| station_id | Yes | Station ID from the alt-fuel stations dataset. |
nrel_alt_fuel_stationsRead-onlyIdempotentInspect
Find alternative fuel stations near a location: electric (EV) charging, CNG, LNG, E85, hydrogen, propane, biodiesel. Used by route planning agents, fleet operators, and EV/clean-fuel tech.
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Latitude. Use with lon as alternative to location. | |
| lon | No | Longitude. Use with lat as alternative to location. | |
| limit | No | Max stations to return (default 25, max 200). | |
| state | No | Optional 2-letter state code filter. | |
| radius | No | Search radius in miles (default 5, max 500). | |
| status | No | Optional status filter: E (available, default), P (planned), T (temporarily unavailable). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| location | No | Address or city/state. Either location OR lat+lon required. | |
| fuel_type | No | Comma-separated fuel types: ELEC (default), CNG, LNG, E85, HY, LPG, BD. |
nrel_pvwattsRead-onlyIdempotentInspect
Estimate solar PV system production using NREL's PVWatts v8 model. Returns annual and monthly AC energy output (kWh), solar resource (kWh/m²/day), and capacity factor. Used by solar developers, homeowners, and ESG analysts to size and estimate solar arrays.
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Latitude in decimal degrees. Use with lon as alternative to address. | |
| lon | No | Longitude in decimal degrees. Use with lat as alternative to address. | |
| tilt | No | Array tilt angle in degrees (default 20). | |
| losses | No | Total system losses percent (default 14). | |
| address | No | Street address, city/state, or place name. Either address OR lat+lon required. | |
| azimuth | No | Array azimuth in degrees (default 180 = south for northern hemisphere). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| array_type | No | 0=fixed open rack, 1=fixed roof (default), 2=1-axis tracking, 3=1-axis backtracking, 4=2-axis tracking. | |
| module_type | No | 0=standard (default), 1=premium, 2=thin film. | |
| system_capacity | Yes | System size in kilowatts DC (e.g. 5 for a 5 kW residential system). |
nrel_solar_resourceRead-onlyIdempotentInspect
Annual and monthly solar resource data (Direct Normal Irradiance, Global Horizontal Irradiance, Latitude-Tilt Irradiance) for a location. Useful for site evaluation before sizing a solar system.
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Latitude in decimal degrees. Use with lon as alternative to address. | |
| lon | No | Longitude in decimal degrees. Use with lat as alternative to address. | |
| address | No | Street address, city/state, or place name. Either address OR lat+lon required. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
nrel_utility_ratesRead-onlyIdempotentInspect
Average residential, commercial, and industrial electric utility rates (cents per kWh) for a location, plus the utility name. Used for ROI analysis on solar, EV charging, building electrification.
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Latitude in decimal degrees. Use with lon as alternative to address. | |
| lon | No | Longitude in decimal degrees. Use with lat as alternative to address. | |
| address | No | Street address, city/state, or place name. Either address OR lat+lon required. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
nws_active_alertsRead-onlyIdempotentInspect
Currently-active National Weather Service alerts (tornado, flood, severe thunderstorm, winter, heat, fire) for a point, state, or NWS zone.
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | ||
| lon | No | ||
| zone | No | NWS zone id, e.g. 'TXZ123'. | |
| state | No | Two-letter state code (e.g. 'TX'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| location | No | Address, zip, or city. Will be geocoded to a point. |
ok_wells_searchRead-onlyIdempotentInspect
Search Oklahoma oil & gas wells by county, operator, API number, and/or well type using the Oklahoma Corporation Commission (OCC) RBDMS well database (keyless public record). Unlike a pure map layer, this returns the OPERATOR, well status, well type (OIL/GAS/DRY/etc.), well name, county, and location for each match, plus the total matching count and a by-operator/by-type breakdown. Use it for 'who operates wells in county X', 'how many wells does operator Y have', or an operator's well portfolio. Oklahoma covers the Anadarko Basin / SCOOP / STACK plays. At least one of county, operator, or api is recommended to narrow the search.
| Name | Required | Description | Default |
|---|---|---|---|
| api | No | API well number (digits; non-digits are ignored). | |
| limit | No | Max well records to return (default 25, max 100). The total matching count is always reported. | |
| county | No | Oklahoma county name (e.g. 'Canadian', 'Kingfisher', 'Grady'). Matched case-insensitively. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| operator | No | Operator name or fragment (e.g. 'Chesapeake', 'Devon'). Substring, case-insensitive. | |
| well_type | No | Filter by well type: OIL, GAS, DRY, SWD (saltwater disposal), etc. |
open_payments_by_companyRead-onlyIdempotentInspect
Pre-aggregated payment summary grouped by reporting company across all years. Returns total dollars and payment count per manufacturer/GPO. Use this to rank companies by their pharma-influence spend.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of companies (default 20, max 50) | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
open_payments_by_specialtyRead-onlyIdempotentInspect
Payment totals grouped by medical specialty. Reveals which specialties receive the most pharma money: orthopedic surgeons, cardiologists, psychiatrists, etc.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max specialties (default 50) | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
open_payments_national_summaryRead-onlyIdempotentInspect
National-level Open Payments totals and averages across all years. Shows how much money flows from pharma to doctors nationally, broken down by payment-nature category.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
open_payments_ownershipRead-onlyIdempotentInspect
Search Open Payments OWNERSHIP / investment-interest data -- doctors with equity stakes in pharma/device companies. The deepest disclosure category and the strongest conflict-of-interest signal.
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Program year (auto-discovers latest if omitted, e.g. '2024') | |
| limit | No | Max rows (default 20, max 100) | |
| state | No | Two-letter state code (e.g. 'CA', 'TX') | |
| doctor | No | Doctor last name (case-insensitive) | |
| company | No | Manufacturer/GPO name (partial match), e.g. 'Pfizer', 'Stryker', 'Johnson & Johnson' | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| specialty | No | Medical specialty (partial), e.g. 'Cardiology', 'Orthopaedic' |
open_payments_researchRead-onlyIdempotentInspect
Search Open Payments RESEARCH payments -- clinical research grants and study funding from pharma/device companies to doctors. Separate dataset from general payments.
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Program year (auto-discovers latest if omitted, e.g. '2024') | |
| limit | No | Max rows (default 20, max 100) | |
| state | No | Two-letter state code (e.g. 'CA', 'TX') | |
| doctor | No | Doctor last name (case-insensitive) | |
| company | No | Manufacturer/GPO name (partial match), e.g. 'Pfizer', 'Stryker', 'Johnson & Johnson' | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| specialty | No | Medical specialty (partial), e.g. 'Cardiology', 'Orthopaedic' |
open_payments_searchRead-onlyIdempotentInspect
Search CMS Open Payments general payments (Sunshine Act) -- pharmaceutical/device company payments to doctors and teaching hospitals. Filter by company, doctor surname, state, specialty, and year. Returns payment amount, type (food/travel/consulting/gift/royalty), drug/device name, and recipient details. 15M+ records per year.
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Program year (auto-discovers latest if omitted, e.g. '2024') | |
| limit | No | Max rows (default 20, max 100) | |
| state | No | Two-letter state code (e.g. 'CA', 'TX') | |
| doctor | No | Doctor last name (case-insensitive) | |
| company | No | Manufacturer/GPO name (partial match), e.g. 'Pfizer', 'Stryker', 'Johnson & Johnson' | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| specialty | No | Medical specialty (partial), e.g. 'Cardiology', 'Orthopaedic' |
open_payments_state_totalsRead-onlyIdempotentInspect
State-level Open Payments totals. Returns payment totals and average per recipient per state. Useful for state-level pharma-influence research.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max states (default 60) | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
open_payments_topRead-onlyIdempotentInspect
Same filters as open_payments_search but sorted by payment amount descending. Use this to find the LARGEST individual pharma payments by company, state, or specialty.
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Program year (auto-discovers latest if omitted, e.g. '2024') | |
| limit | No | Max rows (default 20, max 100) | |
| state | No | Two-letter state code (e.g. 'CA', 'TX') | |
| doctor | No | Doctor last name (case-insensitive) | |
| company | No | Manufacturer/GPO name (partial match), e.g. 'Pfizer', 'Stryker', 'Johnson & Johnson' | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| specialty | No | Medical specialty (partial), e.g. 'Cardiology', 'Orthopaedic' |
options_chainRead-onlyIdempotentInspect
Get the options chain for a stock - calls and puts with strike prices, bid/ask spread, volume, open interest, implied volatility, and available expirations. Use this for "show me AAPL options", "what are the puts on Tesla?", "options expiring this Friday", "what's the implied volatility?", or any options trading question.
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Filter by option type (default: "both") | |
| symbol | Yes | Stock ticker symbol (e.g., "AAPL") | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| expiration | No | Expiration date in YYYY-MM-DD format. Defaults to nearest expiration. |
options_history_atm_ivRead-onlyIdempotentInspect
Get the historical at-the-money implied volatility time series for a ticker. For each date, returns the strike closest to 50-delta and its IV. Default to call ATM IV but supports puts. Useful for VRP calculations, term structure, regime detection, and as a primary feature in directional/vol forecasting models.
| Name | Required | Description | Default |
|---|---|---|---|
| ticker | Yes | Stock ticker | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| call_put | No | Call (default) or Put | |
| expiration | Yes | Expiration date YYYY-MM-DD (pick the same expiration across dates for consistency) |
options_history_chainRead-onlyIdempotentInspect
Get the full historical options chain for a ticker on a specific date (2019-2024). Returns every strike + expiration available that day with bid, ask, implied volatility, and all five Greeks (delta, gamma, theta, vega, rho). Use this for point-in-time backtesting, vol surface snapshots, or single-day analysis. Data source: DoltHub free options dataset, indexed in LiveDataLink's R2 storage.
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | Date in YYYY-MM-DD format. Coverage: 2019-02-09 to 2024-11-11. | |
| ticker | Yes | Stock ticker (uppercase) | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
options_history_contractRead-onlyIdempotentInspect
Track a specific options contract (same ticker + strike + expiration) over time. Returns all daily observations of that contract with its evolving bid/ask, IV, and Greeks. Useful for studying single-contract behavior leading up to expiration, gamma squeezes around specific strikes, etc.
| Name | Required | Description | Default |
|---|---|---|---|
| strike | Yes | Strike price (e.g. 450.00) | |
| ticker | Yes | Stock ticker | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| call_put | Yes | Contract type | |
| expiration | Yes | Expiration date YYYY-MM-DD |
options_history_volhistRead-onlyIdempotentInspect
Get per-day implied volatility and historical volatility summary for a ticker. Returns iv_current, hv_current, plus year-high/year-low markers for each. Useful for IV rank/percentile signals, vol regime detection, and time-series feature engineering. Much smaller payload than full chain data.
| Name | Required | Description | Default |
|---|---|---|---|
| ticker | Yes | Stock ticker (uppercase) | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| end_date | No | Optional YYYY-MM-DD upper bound | |
| start_date | No | Optional YYYY-MM-DD lower bound |
org_funding_profileRead-onlyIdempotentInspect
One-call federal-money + nonprofit profile for an organization: USAspending contracts and grants recipient summaries (total dollars, award counts, top agencies), IRS 990 exempt-organization details (revenue/assets/income, NTEE, subsection, exempt status) by EIN or name+state, and optionally open Grants.gov OPPORTUNITIES (clearly labeled as available funding to apply for, NOT awards received). Sources degrade gracefully. Premium cross-source synthesis; federal dollars are name-matched and should be verified.
| Name | Required | Description | Default |
|---|---|---|---|
| ein | No | Optional EIN for an exact IRS 990 match. | |
| state | No | Optional 2-letter state to disambiguate a nonprofit name search. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| organization | Yes | Organization / company / nonprofit name. | |
| include_opportunities | No | Also list open Grants.gov funding opportunities (available, not awarded). Default false. |
package_trackRead-onlyIdempotentInspect
Track a package or shipment by tracking number. Auto-detects carrier (USPS, UPS, FedEx, DHL, Amazon). Returns delivery status, current location, estimated delivery date, and tracking history. Use this for 'where is my package?', 'track this shipment', 'when will my order arrive?', 'check delivery status', 'is my package delivered?', or any package tracking question. Just paste the tracking number - the carrier is detected automatically.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| tracking_number | Yes | Package tracking number from any carrier |
paper_detailsRead-onlyIdempotentInspect
Get full catalog metadata for a single scholarly work by OpenAlex id (e.g. 'W2741809807') or DOI (e.g. '10.1038/nature12373'). Returns title, authors, venue, year, citation count, open-access status, and a free full-text URL when available. For a bare arXiv id, use paper_get_text with paper_key 'arxiv:' to read indexed text, or paper_search by title for OpenAlex metadata.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | OpenAlex id ('W...') or DOI ('10.x/...'). For arXiv ids, use paper_get_text or paper_search instead. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
paper_fulltext_searchRead-onlyIdempotentInspect
Search INSIDE the indexed open-access corpus (arXiv + PubMed Central OA full text) for a phrase or keywords and get back the matching passages, each with the paper title, authors, and a snippet around the match. This is the headline feature: agents can find where a finding or method is discussed across open-access papers. Optionally restrict to one paper by paper_key.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum passages to return (default 10, max 50). | |
| query | Yes | Phrase or keywords to find inside the papers, e.g. 'scaled dot-product attention', 'gradient checkpointing'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| paper_key | No | Optional: restrict the search to a single indexed paper by its corpus key, e.g. 'arxiv:2310.12345'. |
paper_get_textRead-onlyIdempotentInspect
Return the full text of an indexed open-access paper by its corpus key (e.g. 'arxiv:2310.12345'), paginated by passage. Use from_seq + max_passages to page through it. For works not indexed locally, returns a pointer to find the open-access URL via paper_search / paper_details.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| from_seq | No | Passage index to start from (0-based, default 0). | |
| paper_key | Yes | Corpus key of an indexed paper, e.g. 'arxiv:2310.12345' or 'pmc:PMC1234567'. | |
| max_passages | No | Maximum passages to return per call (default 40, max 200). |
paper_searchRead-onlyIdempotentInspect
Search ~250M scholarly works (papers, preprints, datasets) live via OpenAlex by keyword across title, abstract, and full text, with optional author, year, and open-access-only filters. Ranked by relevance. Returns each work's OpenAlex id, DOI, title, authors, venue, year, citation count, and a free full-text URL when open access. Use paper_fulltext_search to search inside the locally indexed open-access corpus.
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Optional exact publication year, e.g. 2023. | |
| limit | No | Maximum rows to return (default 25, max 100). | |
| query | No | Keywords across title/abstract/fulltext, e.g. 'attention mechanism transformers', 'CRISPR off-target'. | |
| author | No | Optional author-name fragment, e.g. 'Hinton', 'Doudna'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| open_access_only | No | If true, only return open-access works (default false). |
paper_statusRead-onlyIdempotentInspect
Report the scholarly store status: the catalog is served live via OpenAlex (~250M works), plus the local D1 indexed-corpus counts (papers with full text indexed, total indexed passages, per-source breakdown, last refresh timestamp).
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
parcel_coverageRead-onlyIdempotentInspect
List which states/counties the parcel tools currently cover and how many parcels each holds. Coverage grows by state over time.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
parcel_detailsRead-onlyIdempotentInspect
Get the full record for one parcel by its account id: address, current assessed value (total, land, improvement), land use, zoning, year built, structure square footage, lot size, coordinates, and most recent sale. Valuation and characteristics only, no owner name.
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | 2-letter state code. Coverage: 'MD' (Maryland statewide) or 'TX' (Harris County / Houston only). Defaults to MD. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| account_id | Yes | Parcel account id (from parcel_search). |
parcel_sales_historyRead-onlyIdempotentInspect
Get the recorded sale history (price + date, no party names) for one parcel by account id. Useful for valuation, appreciation, and comp analysis.
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | 2-letter state code. Coverage: 'MD' (Maryland statewide) or 'TX' (Harris County / Houston only). Defaults to MD. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| account_id | Yes | Parcel account id (from parcel_search). |
parcel_searchRead-onlyIdempotentInspect
Search property parcels by street address and get assessed value, land use, and most recent sale for each match. Coverage: Maryland statewide (all 24 jurisdictions, includes sale prices) and Harris County, TX / Houston (appraised value only, no sale prices since Texas is a non-disclosure state). Returns valuation and characteristics only, not owner names. Use parcel_details for the full record.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows (default 10, max 50). | |
| query | Yes | Street address fragment, e.g. '100 Main St' or 'Charles St'. | |
| state | No | 2-letter state code. Coverage: 'MD' (Maryland statewide) or 'TX' (Harris County / Houston only). Defaults to MD. | |
| county | No | Optional county name to narrow results, e.g. 'Baltimore', 'Montgomery'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
patent_assignee_searchRead-onlyIdempotentInspect
Find patent assignees (companies / organizations) by name fragment. Returns assignee id, organization name, location, and total patents owned. Ranked by patent count.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return (default 25, max 100). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| organization | Yes | Company or organization name fragment (e.g. 'Apple', 'Genentech'). |
patent_detailsRead-onlyIdempotentInspect
Fetch full details for a single patent by its USPTO patent_id (e.g. '10757852'). Returns title, grant date, type, abstract, assignees, inventors, and citation count.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| patent_id | Yes | USPTO patent id, e.g. '10757852'. |
patent_inventor_searchRead-onlyIdempotentInspect
Find inventors by last name (and optional first name). Returns inventor id, name, location, and total patent count. Use the inventor name in patent_search to find their patents.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return (default 25, max 100). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| last_name | Yes | Inventor last name (required). | |
| first_name | No | Optional inventor first name. |
patent_recentRead-onlyIdempotentInspect
List the most recently granted US patents since a start date (defaults to 30 days ago), newest first. Useful for monitoring newly issued patents.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return (default 25, max 100). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| start_date | No | Grant-date lower bound (YYYY-MM-DD). Defaults to 30 days ago. |
patent_searchRead-onlyIdempotentInspect
Search granted US patents by keyword (matched against title and abstract), title, and/or grant date range. Provide at least one of query, title, start_date, end_date. Returns title, grant date, assignee, and inventors.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum rows to return (default 25, max 100). | |
| query | No | Keyword(s) matched across patent title and abstract (e.g. 'lithium battery anode'). | |
| title | No | Keyword(s) matched against the patent title only. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| end_date | No | Grant-date upper bound (YYYY-MM-DD). | |
| start_date | No | Grant-date lower bound (YYYY-MM-DD). |
prescriber_ties_profileRead-onlyIdempotentInspect
One-call identity + industry-financial-ties transparency profile for a US healthcare prescriber. Joins two keyless federal sources: the NPPES NPI Registry (identity - NPI, specialty, city/state, active status) and CMS Open Payments / Sunshine Act (industry payments disclosed to that prescriber - total dollars, payment count, top paying manufacturers, and associated drugs/products for the most recent program year with data). Provide a last_name (ideally with first_name + state) or an exact 10-digit npi. The name resolver picks the NPPES record that genuinely matches the requested name (never a blind top hit), and payments are pinned to that exact NPI across recent program years. This is a TRANSPARENCY profile drawn from public records, NOT a judgment: industry payments to physicians are lawful and publicly disclosed, and their presence is not evidence of wrongdoing. A source that fails is noted, not fatal. Premium cross-source synthesis; verify against the primary sources.
| Name | Required | Description | Default |
|---|---|---|---|
| npi | No | Optional exact 10-digit NPI; overrides name search. | |
| year | No | Optional 4-digit CMS program year (e.g. '2023'); defaults to the most recent year with disclosed payments. | |
| state | No | Optional 2-letter state to disambiguate the NPPES match (e.g. 'OH'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| last_name | No | Prescriber last name (e.g. 'Nissen'). Provide this or an npi. | |
| first_name | No | Optional prescriber first name to disambiguate (e.g. 'Steven'). |
price_to_rent_ratioRead-onlyIdempotentInspect
Compute the buy-vs-rent price-to-rent ratio for a US metro or state: Zillow home value (ZHVI) divided by annualized rent (ZORI x 12). Returns the ratio plus a rule-of-thumb signal (below ~15 favors buying, above ~20 favors renting). Premium synthesis over the real-estate market store. Rule-of-thumb only, not financial advice.
| Name | Required | Description | Default |
|---|---|---|---|
| region | Yes | Metro or state name/id (e.g. 'Austin, TX', 'California', or a Zillow region id). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| region_type | No | Optional region type filter: 'metro' or 'state'. |
product_liability_screenRead-onlyIdempotentInspect
One-call product-safety + liability read for a MANUFACTURER or brand. Joins three public-record legs: product recalls (CPSC consumer products + openFDA drug/device/food enforcement, keyed by manufacturer), federal-court litigation (CourtListener dockets whose caption actually names the brand), and CFPB consumer-complaint volume. Returns a rolled-up read (CLEAN / WATCH / ELEVATED LIABILITY SIGNALS) with recall count and severity (FDA Class I / death-related = high), litigation hits (total + last-3-years), and complaint volume, plus an itemized interpretation. A leg that fails is noted, not fatal. NHTSA vehicle recalls need a specific year+make+model so are out of scope here (use recall_screen for a vehicle). Premium cross-source synthesis; informational public-record synthesis, NOT legal advice.
| Name | Required | Description | Default |
|---|---|---|---|
| since | No | Optional lower-bound date (YYYY-MM-DD) for FDA recalls. | |
| state | No | Optional 2-letter state to scope the CFPB complaint leg (e.g. 'CA'). | |
| company | No | Alias for manufacturer; either may be supplied. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| manufacturer | Yes | Manufacturer or brand name to screen (e.g. 'Peloton', 'Fisher-Price'). |
property_lookupRead-onlyIdempotentInspect
Look up real estate property data by street address or account number. Returns property owner name, assessed value, market value, land value, improvement value, year built, square footage, lot size, acreage, exemptions (homestead, over 65, disabled veteran), and legal description. Use this for questions like "who owns this house?", "how much is this property worth?", "what's the tax value of this address?", "what are the property details?", or any real estate lookup. Coverage note: currently demo dataset for Montgomery County, TX (sample properties only). Full live coverage of all Texas counties via ATTOM/Estated is available as a paid upgrade. Email support@livedatalink.ai to enable real CAD data on your account.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Street address or appraisal district account number | |
| county | No | County name (default: montgomery) | montgomery |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
property_search_areaRead-onlyIdempotentInspect
Search for real estate properties in a geographic area. Filter by zip code, subdivision, neighborhood, or street name. Use this for questions like "what homes are in this zip code?", "show me properties in this neighborhood", "find houses on Main Street", "what's the average home value in this area?", or any area-based property search. Returns a list of properties with addresses, owners, values, and property types.
| Name | Required | Description | Default |
|---|---|---|---|
| zip | No | 5-digit ZIP code to search within | |
| county | No | County name (default: montgomery) | montgomery |
| street | No | Street name to search (e.g., 'Main St') | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| subdivision | No | Subdivision or neighborhood name |
property_search_ownerRead-onlyIdempotentInspect
Search for real estate properties by owner name. Find all properties owned by a person, family, trust, LLC, or company. Supports partial name matching. Use this for questions like "what properties does John Smith own?", "find all land owned by this company", "who owns property in this area?", or any property ownership search. Returns addresses, values, property types, and account numbers for all matching properties.
| Name | Required | Description | Default |
|---|---|---|---|
| county | No | County name (default: montgomery) | montgomery |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| owner_name | Yes | Full or partial owner name to search for |
property_value_historyRead-onlyIdempotentInspect
Get property value history and tax assessment trends over multiple years. Shows year-by-year market value, land value, improvement value, and percentage change. Use this for questions like "how has this property's value changed?", "what's the appreciation rate?", "show me the tax assessment history", "has this home gone up in value?", or any property valuation trend question. Requires account number (use property_lookup first to find it).
| Name | Required | Description | Default |
|---|---|---|---|
| county | No | County name (default: montgomery) | montgomery |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| account_number | Yes | County appraisal district account number |
pypi_packageRead-onlyIdempotentInspect
Look up a Python (PyPI) package: latest version, summary, license, author, homepage, and required Python version. Keyless.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | PyPI package name, e.g. 'requests'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
rdap_domainRead-onlyIdempotentInspect
Registration record for a domain via RDAP (the modern WHOIS): registrar, creation/update/expiration dates, status flags, nameservers, and DNSSEC. Useful for due diligence and OSINT on a company's web presence. Keyless.
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes | Domain name, e.g. 'example.com'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
rdap_ipRead-onlyIdempotentInspect
Ownership record for an IP address or block via RDAP: the network name, owning organization, ASN, CIDR range, and country. Pairs with ip_reputation and entity lookups. Keyless.
| Name | Required | Description | Default |
|---|---|---|---|
| ip | Yes | IPv4 or IPv6 address, e.g. '8.8.8.8'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
realestate_home_valuesRead-onlyIdempotentInspect
Get the typical home value for a metro or state (Zillow Home Value Index): the latest value plus 1-year and 5-year-ago values and percent change. Pass a region name or id.
| Name | Required | Description | Default |
|---|---|---|---|
| region | Yes | Metro or state name (e.g. 'Austin, TX', 'Houston', 'Texas') or a Zillow region id. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
realestate_rentsRead-onlyIdempotentInspect
Get the typical asking rent for a metro or state (Zillow Observed Rent Index): the latest value plus 1-year and 5-year-ago values and percent change. Pass a region name or id.
| Name | Required | Description | Default |
|---|---|---|---|
| region | Yes | Metro or state name (e.g. 'Austin, TX', 'Houston', 'Texas') or a Zillow region id. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
realestate_searchRead-onlyIdempotentInspect
Find real-estate markets (metro areas or states) by name and get each one's latest typical home value (Zillow Home Value Index). Use this to discover the region name/id before calling realestate_home_values, realestate_rents, or realestate_trend.
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Optional filter: 'metro' or 'state'. | |
| limit | No | Max rows (default 10, max 50). | |
| query | Yes | Name fragment, e.g. 'Austin', 'Bay Area', 'Texas'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
realestate_statusRead-onlyIdempotentInspect
Report real-estate store coverage: number of regions, total monthly data points, the latest month available, and last refresh. Data is Zillow Research (ZHVI + ZORI), metro and state level.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
realestate_trendRead-onlyIdempotentInspect
Get the monthly time series of home values (ZHVI) or rents (ZORI) for a metro or state, to chart or analyze the trend.
| Name | Required | Description | Default |
|---|---|---|---|
| metric | No | 'home_value' (ZHVI, default) or 'rent' (ZORI). | |
| months | No | How many recent months to return (default 24, max 360). | |
| region | Yes | Metro or state name (e.g. 'Austin, TX', 'Houston', 'Texas') or a Zillow region id. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
recall_screenRead-onlyIdempotentInspect
One-call product-safety recall sweep across CPSC (consumer products), openFDA (drug/device/food enforcement), and NHTSA (vehicles). Provide a product/keyword/manufacturer query and/or a full vehicle (year+make+model). Results are normalized, deduped within and across sources, severity-rolled (FDA Class I or death-related = high), and summarized with a by-classification breakdown. A source that fails is noted, not fatal. Premium cross-source synthesis. Verify against the official sources before acting.
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Product, keyword, or manufacturer to screen (e.g. 'infant formula', 'Acme Corp'). | |
| since | No | Optional lower-bound date (YYYY-MM-DD) for FDA recalls. | |
| domains | No | Optional subset of sources to check; default checks all applicable. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| vehicle_make | No | Vehicle make (e.g. 'Toyota'). | |
| vehicle_year | No | Vehicle model year (required with make+model for NHTSA). | |
| vehicle_model | No | Vehicle model (e.g. 'Camry'). |
recreation_facility_detailRead-onlyIdempotentInspect
Full record for a single federal recreation facility by its RIDB FacilityID: contact, GPS, reservation URL, accessibility, agency.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| facility_id | Yes | RIDB FacilityID, e.g. '234064'. |
recreation_nearbyRead-onlyIdempotentInspect
List federal recreation facilities within a radius of a coordinate. Useful for proximity searches (e.g. campgrounds near a property, fishing spots near a city). Radius is in kilometers.
| Name | Required | Description | Default |
|---|---|---|---|
| lat | Yes | Center latitude. | |
| lon | Yes | Center longitude. | |
| limit | No | Max rows (1-50, default 10). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| activity | No | Optional activity filter. | |
| radius_km | No | Radius in kilometers (default 30, max ~320). |
recreation_search_campsitesRead-onlyIdempotentInspect
Search individual campsites (sites within a campground): loop, accessibility, type, reservable. Provide facility_id to list sites within a known campground, or query to free-text search.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows (1-50, default 10). | |
| query | No | Free-text match on campsite name. Optional. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| facility_id | No | RIDB FacilityID to list campsites within. Optional. |
recreation_search_facilitiesRead-onlyIdempotentInspect
Search US federal recreation facilities (campgrounds, picnic areas, trailheads, marinas, visitor centers) across NPS, USFS, BLM, USACE, BOR, FWS. Filter by name, state, or activity (e.g. 'CAMPING', 'FISHING', 'HIKING').
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows (1-50, default 10). | |
| query | No | Free-text match on facility name. | |
| state | No | Two-letter state code, e.g. 'CA'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| activity | No | Activity name (CAMPING, FISHING, HIKING, etc.). |
recreation_search_recareasRead-onlyIdempotentInspect
Search federal recreation AREAS (broader units: a whole national forest, a national park unit, a BLM management area) by name, state, or activity. For higher-level place search use this; for specific facilities (campgrounds, trailheads) use recreation_search_facilities.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows (1-50, default 10). | |
| query | No | Free-text match on recreation-area name. | |
| state | No | Two-letter state code. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| activity | No | Activity name. |
reg_cfr_searchRead-onlyIdempotentInspect
Full-text search the current Code of Federal Regulations (eCFR, all 50 titles) for a phrase or keywords. Returns matching sections with their citation (e.g. '40 CFR 98.411'), hierarchy heading, a text snippet, effective date, and the official eCFR URL, plus the total match count. Use reg_cfr_section to read a full section's text.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max sections to return (default 20, max 100). | |
| query | Yes | Phrase or keywords to find in the CFR, e.g. 'greenhouse gas reporting'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
reg_cfr_sectionRead-onlyIdempotentInspect
Get the current text of a specific Code of Federal Regulations section. Provide the title number, part, and section (e.g. title 40, part '98', section '98.411'). Returns the section's plain text, the date it is current as of, and the official eCFR URL.
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | Optional point-in-time ISO date yyyy-mm-dd; defaults to current. | |
| part | Yes | CFR part, e.g. '98'. | |
| title | Yes | CFR title number 1-50, e.g. 40. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| section | Yes | CFR section, e.g. '98.411'. |
reg_cfr_titlesRead-onlyIdempotentInspect
List the 50 Code of Federal Regulations titles with their name and the date each title's text is current as of. Useful for discovering title numbers (e.g. Title 26 = Internal Revenue, Title 40 = Protection of Environment) before calling reg_cfr_section.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
reg_documentRead-onlyIdempotentInspect
Get full metadata and a plain-text body excerpt for a single Federal Register document by its document number (e.g. '2026-09905'). Returns title, type, agencies, abstract, affected CFR parts, a leading excerpt of the full rule text, and the URL for the complete document.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| document_number | Yes | Federal Register document number, e.g. '2026-09905'. |
reg_searchRead-onlyIdempotentInspect
Search the Federal Register (the daily journal of the US government) for rules, proposed rules, notices, and presidential documents by keyword, with optional agency, document type, and publication-date filters. Returns each document's number, title, type, publishing agency, abstract, and URL. Use reg_document to get the full text of one document.
| Name | Required | Description | Default |
|---|---|---|---|
| term | No | Keyword(s), e.g. 'methane emissions', 'overtime rule'. | |
| type | No | Optional document type: 'rule', 'proposed-rule', 'notice', or 'presidential-document'. | |
| limit | No | Max rows (default 20, max 100). | |
| agency | No | Optional agency slug, e.g. 'environmental-protection-agency', 'securities-and-exchange-commission'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| published_to | No | Published on/before, ISO date yyyy-mm-dd. | |
| published_from | No | Published on/after, ISO date yyyy-mm-dd. |
resolve_entityRead-onlyIdempotentInspect
Canonical cross-source entity resolution - the join-key primitive to run before other combos. Given a company/organization name (plus optional ticker/CIK/EIN/state hints), fans out across the LiveDataLink sources that carry a strong identifier and returns the best-matched canonical identity plus the IDs it resolves to: SEC EDGAR (CIK, ticker), GLEIF (LEI plus the ownership chain - direct and ultimate parent LEI and the reported subsidiary count), NPPES (organizational NPI for healthcare entities), IRS 990 (EIN), USAspending (federal recipient name), EPA ECHO (facility registry id), and an OFAC/EU/UN/BIS sanctions screen (match/no-match flag). Returns a compact canonical-IDs block with per-source confidence, an entity-type guess, an ownership summary, and an overall match confidence - distinct from entity_dossier's full narrative. A source that fails is noted, not fatal. UEI/SAM.gov and RDAP domain-owner ids are omitted (not wired sources). Premium cross-source synthesis; verify identifiers before relying on a join.
| Name | Required | Description | Default |
|---|---|---|---|
| cik | No | Optional SEC CIK hint. | |
| ein | No | Optional EIN for an exact IRS 990 nonprofit match. | |
| name | Yes | Company or organization name to resolve (e.g. 'Apple', 'Lockheed Martin', 'Red Cross'). | |
| state | No | Optional 2-letter state to disambiguate nonprofit/EPA name searches. | |
| ticker | No | Optional stock ticker hint to pin the SEC EDGAR match (e.g. 'AAPL'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
sanctions_get_changesRead-onlyIdempotentInspect
Return entities added or updated since a given ISO date for a chosen source list. The four official lists do not all expose a public delta feed, so this filters the cached snapshot by listedOn.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum matches to return. Defaults vary per tool. | |
| since | Yes | ISO date string (e.g. 2026-01-01) to compute the delta from. | |
| source | Yes | ||
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
sanctions_get_entityRead-onlyIdempotentInspect
Fetch a full record by entity ID (e.g. "OFAC_SDN-44705"). The ID is self-describing and includes the source; obtain it from a screening result.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Entity ID from a screening result, e.g. "OFAC_SDN-44705". | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
sanctions_screen_addressRead-onlyIdempotentInspect
Match a physical address against listed addresses. Useful for KYC / supplier vetting when the counterparty's name is generic but the address is distinctive.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum matches to return. Defaults vary per tool. | |
| address | Yes | Free-form address string. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| sources | No | Restrict screening to a subset of source lists. Defaults to all four. Allowed: OFAC_SDN, EU_CFSP, UN_SC, BIS_DPL. | |
| threshold | No | Minimum confidence score (0..1) for a result to be returned. Defaults to 0.85. |
sanctions_screen_batchRead-onlyIdempotentInspect
Screen up to 50 names in a single call. Returns one result block per input, in input order. Each name counts as one screen for billing purposes.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum matches to return. Defaults vary per tool. | |
| names | Yes | Array of names to screen. Max 50. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| sources | No | Restrict screening to a subset of source lists. Defaults to all four. Allowed: OFAC_SDN, EU_CFSP, UN_SC, BIS_DPL. | |
| threshold | No | Minimum confidence score (0..1) for a result to be returned. Defaults to 0.85. |
sanctions_screen_entityRead-onlyIdempotentInspect
Screen a single name or entity against the four major sanctions / denied-party lists (OFAC SDN, EU consolidated, UN consolidated, BIS DPL). Returns matches with confidence scores. Free tier: 50 screens/month; standard rate $0.05/screen.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Name or entity string to screen. | |
| limit | No | Maximum matches to return. Defaults vary per tool. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| sources | No | Restrict screening to a subset of source lists. Defaults to all four. Allowed: OFAC_SDN, EU_CFSP, UN_SC, BIS_DPL. | |
| threshold | No | Minimum confidence score (0..1) for a result to be returned. Defaults to 0.85. |
sanctions_search_aliasRead-onlyIdempotentInspect
Search aliases / AKAs across selected lists. Distinct from screen_entity in that only the alias fields are matched, which is helpful when the primary listed name differs sharply from the popular spelling.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum matches to return. Defaults vary per tool. | |
| query | Yes | Alias / AKA to search for. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| sources | No | Restrict screening to a subset of source lists. Defaults to all four. Allowed: OFAC_SDN, EU_CFSP, UN_SC, BIS_DPL. | |
| threshold | No | Minimum confidence score (0..1) for a result to be returned. Defaults to 0.85. |
sanctions_status_summaryRead-onlyIdempotentInspect
Counts and last-update timestamps for all four lists in the cache. No screening is performed; this call is free.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
search_available_datasetsRead-onlyIdempotentInspect
Your guide to LiveDataLink's entire data catalog. Call this FIRST when you're unsure which tool to use, or when the user asks about data availability. LiveDataLink has 284 tools across 50+ data domains: finance (stocks, options), crypto, transportation/FMCSA carriers, property records, weather/air quality, vehicle VIN/recalls, package tracking, local business search, sanctions screening (OFAC SDN, EU, UN, BIS), FEMA disasters and flood data, federal courts (CourtListener), cybersecurity (CVE/CWE/EPSS/CISA KEV), US college metrics (IPEDS), EIA energy data (gasoline, natural gas, electricity, oil supply, renewables), FRED Federal Reserve macroeconomic series (GDP, CPI, fed funds, unemployment, yields), SEC EDGAR filings (10-K, 10-Q, 8-K, insider transactions), and NREL renewable energy (PVWatts solar, utility rates, EV charging stations), US Census demographics, EPA environmental compliance, FEC campaign finance, USPTO patents, IRS nonprofits (Form 990/EO BMF), US caselaw, public-domain books (full-text search), open-access scholarly papers (OpenAlex catalog + arXiv/PMC full-text search), federal regulations (Federal Register rules/notices + the Code of Federal Regulations), US Census geocoding (address to coordinates + Census geographies), federal grants (Grants.gov funding opportunities), and product recalls (CPSC / SaferProducts.gov). New domains ship weekly based on which queries customers actually run. Returns exact tool names for matched domains AND logs every search to a roadmap database. High-frequency unmet queries jump the build queue. Use this freely; it costs no credits. Call for: 'what data do you have?', 'can you look up X?', 'do you have Y data?', 'what tools are available?', or any data coverage question.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | What data the user is looking for (e.g., 'trucking safety', 'stock prices', 'property records', 'VIN lookup') | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
security_exposureRead-onlyIdempotentInspect
One-call known-vulnerability exposure for a vendor/product/package, built on the LiveDataLink cyber domain. Fans out to NVD (CVE search by vendor+product or keyword), the CISA KEV catalog (actively-exploited flag - the highest signal), FIRST EPSS (exploit-probability scores for the most-severe CVEs), and aggregates MITRE CWE weakness types from the matched CVEs. Returns total CVEs, counts by CVSS severity band, KEV membership with the actively-exploited CVEs listed, the highest EPSS score, the critical CVEs, top CWE weakness types, an overall exposure rollup (KEV present -> high), and an evidence list. No matches returns a friendly 0-exposure result; if the cyber source is unavailable that is noted per-source. Exactly one NVD call per invocation. INFORMATIONAL security research, not advice. Package-registry maintenance/staleness signals are out of scope for this tool.
| Name | Required | Description | Default |
|---|---|---|---|
| vendor | No | Optional vendor to narrow the NVD CPE match (e.g. 'apache', 'openbsd'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| product | Yes | Product or package name to assess (e.g. 'log4j', 'openssl', 'struts'). | |
| version | No | Optional version string (informational; shown in the report). | |
| max_cves | No | Max CVEs to pull from NVD for analysis (default 40). |
spending_award_detailsRead-onlyIdempotentInspect
Get full detail for one federal award by its award id (the generated id from spending_search_awards): recipient, amount, type, awarding and funding agencies, period of performance, NAICS/PSC, place of performance, and description.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| award_id | Yes | Generated award id from spending_search_awards. |
spending_recipient_summaryRead-onlyIdempotentInspect
Summarize a company's federal awards: total dollars and top awards for a recipient name in a category (contracts by default). Useful for due diligence and to see who the government pays.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Top awards to list (default 5, max 25). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| category | No | Award category: 'contracts' (default), 'grants', 'loans', or 'other'. | |
| recipient | Yes | Recipient company/org name. |
spending_search_awardsRead-onlyIdempotentInspect
Search federal awards (contracts, grants, loans) from USAspending.gov by recipient company, keyword, and/or awarding agency, with optional fiscal year and minimum amount. Returns each award's id, recipient, amount, awarding agency, type, start date, and description, sorted by amount.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows (default 10, max 50). | |
| agency | No | Awarding agency name, e.g. 'Department of Defense'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| keyword | No | Free-text keyword across the award. | |
| category | No | Award category: 'contracts' (default), 'grants', 'loans', or 'other'. | |
| recipient | No | Recipient company/org name, e.g. 'Lockheed Martin'. | |
| min_amount | No | Minimum award amount in USD. | |
| fiscal_year | No | Federal fiscal year, e.g. 2024. |
stock_compareRead-onlyIdempotentInspect
Compare 2 to 5 stocks side by side. Returns price, daily change, market cap, P/E ratio, dividend yield, volume, 52-week range, sector, revenue, profit margin, EPS, and beta. Use this for "compare Apple and Microsoft", "which is a better investment, NVDA or AMD?", "tech stock comparison", or any stock-vs-stock analysis.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| symbols | Yes | Ticker symbols, 2-5 stocks. Accept either CSV string ("AAPL,MSFT,GOOGL") or array (["AAPL","MSFT","GOOGL"]). |
stock_historyRead-onlyIdempotentInspect
Get historical stock price data - open, high, low, close, and volume (OHLCV). Supports intraday (1-minute) through multi-year (5-year, max) ranges. Use this for "how has AAPL performed this year?", "show me the price chart for Tesla", "what was the stock price last month?", "historical performance", or any stock price history question.
| Name | Required | Description | Default |
|---|---|---|---|
| period | No | Time range (default: "1mo") | |
| symbol | Yes | Stock ticker symbol (e.g., "AAPL") | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| interval | No | Data interval (default: "1d") |
stock_quoteRead-onlyIdempotentInspect
Get a real-time stock price and market data. Returns current price, daily change, volume, market cap, P/E ratio, dividend yield, 52-week high/low, open, and previous close. Use this for "what's the stock price of X?", "how is AAPL doing?", "check the market", "what's Apple trading at?", or any stock/equity price question.
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | Yes | Stock ticker symbol (e.g., "AAPL", "MSFT", "TSLA") | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
stock_quote_batchRead-onlyIdempotentInspect
Get real-time stock prices for multiple stocks at once (up to 10). Returns a comparison table with price, daily change, volume, market cap, and P/E. Use this for "show me FAANG stocks", "compare tech stock prices", "how are energy stocks doing?", or any multi-stock price check.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| symbols | Yes | Ticker symbols, max 10. Accept either CSV string ("AAPL,MSFT,GOOGL") or array (["AAPL","MSFT","GOOGL"]). |
sun_timesRead-onlyIdempotentInspect
Compute sunrise, sunset, solar noon, and civil twilight for any latitude/longitude on a given date. Times are computed in code from the standard NOAA solar-position equations (no third-party API is called, so the result is dependency-free and resale-safe). Times are returned in UTC by default; pass tz_offset (hours from UTC, e.g. -7 for US Pacific Daylight Time) to shift the output to local clock time. Polar day and polar night are reported when the sun does not rise or set. Use it for daylight planning, photography golden-hour timing, or agriculture and energy calculations.
| Name | Required | Description | Default |
|---|---|---|---|
| lat | Yes | Latitude in decimal degrees (positive north). | |
| lon | Yes | Longitude in decimal degrees (negative west). | |
| date | No | Date, 'YYYY-MM-DD'. Defaults to today (UTC). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| tz_offset | No | Hours from UTC applied to output times, e.g. -7 for US Pacific Daylight Time. Default 0 (UTC). |
supplier_esg_scorecardRead-onlyIdempotentInspect
One-call, resale-safe ESG / supplier-risk read for a company - no proprietary ESG-rating license needed. Joins three public-record governance-signal legs: EPA ECHO/FRS environmental compliance (significant-non-compliance flags, non-compliant quarters, penalties, and formal enforcement actions across the company's facilities, with correct filtering so clean 'No Violation Identified' statuses are never flagged), product recalls (CPSC consumer products + openFDA drug/device/food, keyed by the company), and federal-court litigation (CourtListener v4 dockets whose caption actually names the company). Returns a readable scorecard across Environmental / Product-safety / Litigation dimensions with a rolled-up read (LOW / MODERATE / ELEVATED ESG risk signals) and the evidence behind each. A leg that fails is noted, not fatal. This is informational public-record synthesis of ESG/supplier-risk SIGNALS, NOT an ESG rating, credit/background report, or investment advice.
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | Optional 2-letter state to disambiguate the EPA facility search (e.g. 'PA'). | |
| company | Yes | Company / supplier name to score (e.g. 'US Steel', 'Tyson Foods'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
support_resistance_levelsRead-onlyIdempotentInspect
Return key support/resistance price levels for a US ticker from recent daily pivots (swing highs/lows) plus nearby round-number levels, with the latest close for context. HEURISTIC levels for research, not investment advice.
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | Yes | US ticker (e.g. 'TSLA'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| lookback_days | No | Trailing daily bars to derive levels from (default 180). |
talent_market_briefRead-onlyIdempotentInspect
One-call 'can I hire this role here, and at what cost' read for an occupation in a US geography. Joins two independent federal sources: BLS OEWS (Occupational Employment and Wage Statistics, keyless) for the occupation's employment LEVEL and wage distribution (mean plus 10th / 50th-median / 90th annual percentiles) in the area, and US Census ACS labor-force context (civilian labor force and local unemployment rate - needs a Census API key) to band how TIGHT / BALANCED / SLACK the local hiring market is. Pass an 'occupation' (e.g. 'registered nurses', 'software developers') or an explicit 'soc_code' (e.g. '29-1141'), and an optional 'state' or 'metro' (defaults to national). Returns a readable brief with a headline (employment, median/mean wage, market tightness), the wage percentiles, and per-source evidence. The BLS OEWS leg is the core signal and is keyless; the Census leg degrades gracefully if no key is set. Informational, NOT a guarantee that a role can be filled at any given wage.
| Name | Required | Description | Default |
|---|---|---|---|
| metro | No | Optional 5-digit CBSA/metro code (e.g. '12420' Austin, TX). OEWS metro coverage varies; an unmatched metro is noted, not fatal. | |
| state | No | Optional 2-letter state code or 2-digit FIPS (e.g. 'TX', '48'). Omit for a national read. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| soc_code | No | Explicit 6-digit SOC occupation code, with or without a dash (e.g. '29-1141' registered nurses, '15-1252' software developers). Overrides 'occupation'. | |
| occupation | Yes | Free-text occupation to map to a SOC code (e.g. 'registered nurses', 'software developers', 'electricians'). Provide this or 'soc_code'. |
tide_predictionsRead-onlyIdempotentInspect
Return high and low tide predictions (times and heights) from the keyless NOAA Tides & Currents (CO-OPS) public API - U.S. Government public-domain data. Give either a NOAA station id (e.g. '9414290' for San Francisco) or a lat/lon (the nearest tide-prediction station is chosen automatically). Returns each high and low tide over the requested inclusive date range, in local station time, relative to the chosen tidal datum (default MLLW). Use it for tide tables, beach and boating planning, or coastal scheduling.
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Latitude in decimal degrees. Used with lon to pick the nearest station when no station id is given. | |
| lon | No | Longitude in decimal degrees (negative west). | |
| datum | No | Tidal datum: MLLW, MSL, MHW, etc. Default MLLW. | |
| units | No | 'english' (feet) or 'metric' (meters). Default english. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| station | No | NOAA CO-OPS station id, e.g. '9414290'. Optional if lat and lon are given. | |
| end_date | No | End date (inclusive), 'YYYY-MM-DD'. Defaults to begin_date + 1 day. | |
| begin_date | No | Start date (inclusive), 'YYYY-MM-DD'. Defaults to today. |
treasury_auctionsRead-onlyIdempotentInspect
Recent US Treasury securities auction results: term, CUSIP, issue/maturity dates, high yield, interest rate, bid-to-cover ratio, and amounts. Optionally filter by security type (Bill, Note, Bond, TIPS, FRN).
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows to return. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| security_type | No | Filter by security type: 'Bill', 'Note', 'Bond', 'TIPS', 'FRN'. |
treasury_cash_balanceRead-onlyIdempotentInspect
Daily operating cash balance of the US Treasury (the Treasury General Account, the government's checking account at the Fed), from the Daily Treasury Statement. Values are in millions of dollars.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows to return. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
treasury_debtRead-onlyIdempotentInspect
US total public debt outstanding (the 'Debt to the Penny' series from the US Treasury). Returns the most recent figure plus history, split into debt held by the public and intragovernmental holdings. Keyless, official Treasury data.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows to return. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| end_date | No | Latest record date (YYYY-MM-DD). | |
| start_date | No | Earliest record date (YYYY-MM-DD). |
treasury_exchange_ratesRead-onlyIdempotentInspect
Official US Treasury Reporting Rates of Exchange (the rates US government agencies use to convert foreign currency balances to dollars). Published quarterly. Provide a country or currency to filter, e.g. 'Canada', 'Euro', 'Yen'.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows to return. | |
| query | No | Country or currency name to match, e.g. 'Canada', 'Euro Zone', 'Japan'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
treasury_interest_ratesRead-onlyIdempotentInspect
Average interest rates the US Treasury pays on its marketable and non-marketable securities (Treasury Bills, Notes, Bonds, TIPS, etc.), by month. Optionally filter by security description.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows to return. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| security | No | Filter by security type/description, e.g. 'Treasury Notes', 'Bills', 'TIPS'. |
trials_detailsRead-onlyIdempotentInspect
Get full detail for one clinical trial by its NCT id (e.g. 'NCT02562313'): title, status, conditions, sponsor, phase, interventions, brief summary, enrollment, start/completion dates, number of sites, and the study URL.
| Name | Required | Description | Default |
|---|---|---|---|
| nct_id | Yes | ClinicalTrials.gov NCT id, e.g. 'NCT02562313'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
trials_searchRead-onlyIdempotentInspect
Search ClinicalTrials.gov for clinical studies by condition, intervention/drug, sponsor, recruitment status, and/or location. Returns each trial's NCT id, title, status, conditions, lead sponsor, phase, and study type.
| Name | Required | Description | Default |
|---|---|---|---|
| term | No | General search term. | |
| limit | No | Max rows (default 10, max 50). | |
| status | No | Recruitment status, e.g. 'RECRUITING', 'COMPLETED', 'TERMINATED'. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| sponsor | No | Sponsor/organization, e.g. 'Pfizer'. | |
| location | No | Location, e.g. 'Houston' or 'Texas'. | |
| condition | No | Disease/condition, e.g. 'breast cancer'. | |
| intervention | No | Drug/intervention, e.g. 'semaglutide'. |
tx_wells_nearRead-onlyIdempotentInspect
Find Texas oil & gas wells near a location using the Texas Railroad Commission (RRC) public well map (keyless public record). Given a longitude/latitude and a radius, returns the wells within it, each with its API well number, well number, and type/status (e.g. 'Oil Well', 'Gas Well', 'Permitted Location', 'Dry Hole', 'Injection/Disposal'), plus a breakdown by type. Use geocode_address first to turn a street address into coordinates. Texas covers the Permian and Eagle Ford basins. This is well LOCATION + type data; operator, production volumes, and permit dates are not in this layer.
| Name | Required | Description | Default |
|---|---|---|---|
| lat | Yes | Latitude of the center point (WGS84), e.g. 31.9974. | |
| lon | Yes | Longitude of the center point (WGS84), e.g. -102.0779. | |
| limit | No | Max wells to return (default 25, max 100). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| radius_km | No | Search radius in kilometers (default 1.5, max 10). |
usgs_earthquake_detailRead-onlyIdempotentInspect
Get full detail for a specific earthquake event by USGS event ID. Returns origin, magnitude details, focal mechanism (if available), shake-map link, felt reports, tsunami flag, and impact estimates.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| event_id | Yes | USGS event ID (e.g. 'us7000m5dt'). Get from feed or search results. |
usgs_earthquake_feedRead-onlyIdempotentInspect
USGS official earthquake summary feed by period and minimum magnitude. period: hour|day|week|month. min_mag: 1.0|2.5|4.5|significant. Returns all events worldwide above the threshold within the period, with magnitude, location, depth, and event detail URL.
| Name | Required | Description | Default |
|---|---|---|---|
| period | No | Time window (default 'day') | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| min_mag | No | Minimum magnitude threshold (default '2.5') |
usgs_earthquake_searchRead-onlyIdempotentInspect
Custom earthquake search via USGS fdsnws. Filter by magnitude, time range, and lat/lon bounding box. Returns up to 100 events sorted by time. Use this for analytical queries instead of the feed when you need historical or geographic filtering.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results (default 25, max 100) | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| end_time | No | ISO date or full datetime | |
| start_time | No | ISO date or full datetime YYYY-MM-DD[THH:MM:SS] | |
| max_latitude | No | Bounding box north | |
| min_latitude | No | Bounding box south | |
| max_longitude | No | Bounding box east | |
| min_longitude | No | Bounding box west | |
| min_magnitude | No | Minimum magnitude (e.g. 4.5) |
usgs_water_realtimeRead-onlyIdempotentInspect
Real-time water data from USGS NWIS streamgages. Filter by site code, state, or parameter (e.g. '00060' = streamflow cfs, '00065' = gage height ft). Useful for flood-stage monitoring, drought tracking, and hydrological research.
| Name | Required | Description | Default |
|---|---|---|---|
| sites | No | Comma-separated USGS site codes (e.g. '01646500') | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| state_cd | No | Two-letter state code; returns all active sites in the state | |
| parameter_cd | No | USGS parameter code (default '00060' streamflow). Common: 00060=streamflow, 00065=gage height, 00010=water temp, 00400=pH |
vehicle_recallsRead-onlyIdempotentInspect
Check for safety recalls on a vehicle by year, make, and model. Returns all NHTSA recall campaigns including affected component, description, safety risk, and recommended remedy. Use this for 'are there recalls on my car?', 'check recalls for 2020 Toyota Camry', 'is this vehicle safe?', 'any open recalls?', or any vehicle recall check. Covers all US vehicles from all manufacturers.
| Name | Required | Description | Default |
|---|---|---|---|
| make | Yes | Vehicle make (e.g., 'Toyota', 'Ford') | |
| year | Yes | Model year (e.g., 2020) | |
| model | Yes | Vehicle model (e.g., 'Camry', 'F-150') | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
vin_decodeRead-onlyIdempotentInspect
Decode a Vehicle Identification Number (VIN) to get full vehicle specifications. Returns year, make, model, trim, body style, engine specs (cylinders, displacement, HP), drivetrain, transmission, fuel type, doors, manufacturer, and assembly plant location. Use this for 'decode this VIN', 'what car is this VIN?', 'look up a VIN number', 'what are the specs on this vehicle?', 'identify this car', or any VIN lookup. Works for all US vehicles - cars, trucks, SUVs, motorcycles, trailers.
| Name | Required | Description | Default |
|---|---|---|---|
| vin | Yes | 17-character Vehicle Identification Number (VIN) | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
water_levelsRead-onlyIdempotentInspect
Return the latest observed water level from a NOAA Tides & Currents (CO-OPS) station using the keyless public API - U.S. Government public-domain data. Give either a NOAA station id or a lat/lon (the nearest station is chosen automatically). Returns the observed water level relative to the chosen datum (default MLLW), the observation time in local station time, and the sample standard deviation when reported. Use it to check current real-world water level versus prediction.
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Latitude in decimal degrees. Used with lon to pick the nearest station when no station id is given. | |
| lon | No | Longitude in decimal degrees (negative west). | |
| datum | No | Tidal datum: MLLW, MSL, MHW, etc. Default MLLW. | |
| units | No | 'english' (feet) or 'metric' (meters). Default english. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| station | No | NOAA CO-OPS station id, e.g. '9414290'. Optional if lat and lon are given. |
weather_currentRead-onlyIdempotentInspect
Get current weather conditions for any location worldwide. Returns temperature, feels-like, humidity, wind speed and direction, cloud cover, pressure, precipitation, UV index, and visibility. Use this for 'what's the weather?', 'is it raining in Houston?', 'how hot is it outside?', 'what's the temperature in New York?', 'do I need a jacket?', or any current weather question. Works for any city, zip code, or place name globally.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| location | Yes | City, zip code, or place name (e.g., 'Houston, TX', '77001', 'Paris') |
weather_forecastRead-onlyIdempotentInspect
Get a multi-day weather forecast for any location worldwide. Returns daily high/low temperatures, conditions, precipitation probability, wind speed, UV index, sunrise and sunset. Use this for 'what's the forecast this week?', 'will it rain tomorrow?', 'weekend weather', 'should I plan outdoor activities?', '7-day forecast for Dallas', or any future weather question. Supports 1-16 day forecasts.
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Forecast days (default: 7) | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| location | Yes | City, zip code, or place name |
worldbank_compareRead-onlyIdempotentInspect
Compare the most recent value of a World Bank indicator across multiple countries (up to 6). Provide a comma-separated list of country codes or names.
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| countries | Yes | Comma-separated country codes/names, e.g. 'US,CN,DE,JP'. | |
| indicator | No | Indicator name (one of: gdp, gdp_per_capita, gdp_growth, inflation, population, unemployment, life_expectancy, exports, imports, gni_per_capita, poverty_rate, internet_users) or a raw WB code. |
worldbank_country_profileRead-onlyIdempotentInspect
Snapshot of a country's key development indicators (GDP, GDP per capita, growth, inflation, population, unemployment, life expectancy), each at its most recent available year.
| Name | Required | Description | Default |
|---|---|---|---|
| country | No | Country ISO2/ISO3 code or name (default 'US'). | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. |
worldbank_indicatorRead-onlyIdempotentInspect
Time series for a World Bank development indicator for one country. Friendly indicators: gdp, gdp_per_capita, gdp_growth, inflation, population, unemployment, life_expectancy, exports, imports, gni_per_capita, poverty_rate, internet_users (or pass a raw World Bank code). Country accepts ISO2/ISO3 codes or common names (e.g. 'US', 'China', 'Germany'). Keyless, official World Bank data.
| Name | Required | Description | Default |
|---|---|---|---|
| country | No | Country ISO2/ISO3 code or name (default 'US'). Use 'WLD' for world. | |
| dry_run | No | If true, do not call any upstream data source. Return a preview of what this tool would do (the tool name and the parsed arguments) so an agent can validate a call before spending a query. | |
| end_year | No | End year (optional). | |
| indicator | No | Indicator name (one of: gdp, gdp_per_capita, gdp_growth, inflation, population, unemployment, life_expectancy, exports, imports, gni_per_capita, poverty_rate, internet_users) or a raw WB code. | |
| start_year | No | Start year (optional). |
Claim this connector by publishing a /.well-known/glama.json file on your server's domain with the following structure:
{
"$schema": "https://glama.ai/mcp/schemas/connector.json",
"maintainers": [{ "email": "your-email@example.com" }]
}The email address must match the email associated with your Glama account. Once published, Glama will automatically detect and verify the file within a few minutes.
Control your server's listing on Glama, including description and metadata
Access analytics and receive server usage reports
Get monitoring and health status updates for your server
Feature your server to boost visibility and reach more users
For users:
Full audit trail – every tool call is logged with inputs and outputs for compliance and debugging
Granular tool control – enable or disable individual tools per connector to limit what your AI agents can do
Centralized credential management – store and rotate API keys and OAuth tokens in one place
Change alerts – get notified when a connector changes its schema, adds or removes tools, or updates tool definitions, so nothing breaks silently
For server owners:
Proven adoption – public usage metrics on your listing show real-world traction and build trust with prospective users
Tool-level analytics – see which tools are being used most, helping you prioritize development and documentation
Direct user feedback – users can report issues and suggest improvements through the listing, giving you a channel you would not have otherwise
The connector status is unhealthy when Glama is unable to successfully connect to the server. This can happen for several reasons:
The server is experiencing an outage
The URL of the server is wrong
Credentials required to access the server are missing or invalid
If you are the owner of this MCP connector and would like to make modifications to the listing, including providing test credentials for accessing the server, please contact support@glama.ai.
Discussions
No comments yet. Be the first to start the discussion!