{"openapi":"3.1.0","info":{"title":"Katzilla Data API","version":"1.0.0","description":"Unified REST API aggregating 300+ free, public, and government data sources behind a single API key.","contact":{"name":"Katzilla","url":"https://katzilla.dev","email":"hello@katzilla.dev"},"license":{"name":"MIT","url":"https://opensource.org/licenses/MIT"}},"servers":[{"url":"https://api.katzilla.dev","description":"Production"},{"url":"http://localhost:3001","description":"Local development"}],"security":[{"apiKey":[]}],"paths":{"/agents/hazards/actions/usgs-earthquakes":{"post":{"operationId":"hazards__usgs-earthquakes","summary":"USGS Earthquakes","description":"Query recent earthquake events from the USGS Earthquake Hazards Program. Returns magnitude, location, time, and coordinates.","tags":["hazards"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"minMagnitude":1,"maxMagnitude":1,"limit":10,"orderBy":"time"},"schema":{"type":"object","properties":{"minMagnitude":{"type":"number","description":"Minimum magnitude to include"},"maxMagnitude":{"type":"number","description":"Maximum magnitude to include"},"limit":{"type":"integer","minimum":1,"maximum":500,"default":10,"description":"Number of results to return"},"startTime":{"type":"string","description":"Start time in ISO 8601 format (e.g. 2024-01-01)"},"endTime":{"type":"string","description":"End time in ISO 8601 format"},"orderBy":{"type":"string","enum":["time","magnitude"],"default":"time","description":"Sort order for results"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/hazards/actions/nws-alerts":{"post":{"operationId":"hazards__nws-alerts","summary":"NWS Weather Alerts","description":"Get active weather alerts from the National Weather Service. Filter by state, severity, and urgency.","tags":["hazards"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"severity":"Extreme","limit":10},"schema":{"type":"object","properties":{"area":{"type":"string","minLength":2,"maxLength":2,"description":"Two-letter state abbreviation (e.g. CA, TX)"},"severity":{"type":"string","enum":["Extreme","Severe","Moderate","Minor"],"description":"Filter by alert severity"},"urgency":{"type":"string","description":"Filter by urgency (Immediate, Expected, Future, Unknown)"},"limit":{"type":"integer","minimum":1,"maximum":500,"default":10,"description":"Maximum number of alerts to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/hazards/actions/nasa-wildfires":{"post":{"operationId":"hazards__nasa-wildfires","summary":"NASA FIRMS Wildfires","description":"Get active fire/hotspot data from NASA FIRMS (Fire Information for Resource Management System) using VIIRS satellite imagery.","tags":["hazards"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"west":-125,"south":24,"east":-66,"north":50,"days":1},"schema":{"type":"object","properties":{"west":{"type":"number","minimum":-180,"maximum":180,"default":-125,"description":"Western longitude bound"},"south":{"type":"number","minimum":-90,"maximum":90,"default":24,"description":"Southern latitude bound"},"east":{"type":"number","minimum":-180,"maximum":180,"default":-66,"description":"Eastern longitude bound"},"north":{"type":"number","minimum":-90,"maximum":90,"default":50,"description":"Northern latitude bound"},"days":{"type":"integer","minimum":1,"maximum":10,"default":1,"description":"Number of days of data (1-10)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/hazards/actions/usgs-water":{"post":{"operationId":"hazards__usgs-water","summary":"USGS Water Services","description":"Get real-time water data (streamflow, gage height) from USGS water monitoring sites.","tags":["hazards"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"parameterCd":"00060,00065","period":"P1D"},"schema":{"type":"object","properties":{"sites":{"type":"string","description":"USGS site number(s), comma-separated (e.g. 01646500)"},"parameterCd":{"type":"string","default":"00060,00065","description":"Parameter codes: 00060=discharge, 00065=gage height. Comma-separated."},"period":{"type":"string","default":"P1D","description":"ISO 8601 duration for data period (e.g. P1D, P7D)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["sites"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/hazards/actions/fema-disasters":{"post":{"operationId":"hazards__fema-disasters","summary":"FEMA Disaster Declarations","description":"Query FEMA disaster declaration summaries. Filter by state, year, and number of results.","tags":["hazards"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"year":1953,"limit":10},"schema":{"type":"object","properties":{"state":{"type":"string","minLength":2,"maxLength":2,"description":"Two-letter state abbreviation (e.g. CA, TX)"},"year":{"type":"integer","minimum":1953,"description":"Filter by fiscal year of disaster declaration"},"limit":{"type":"integer","minimum":1,"maximum":1000,"default":10,"description":"Maximum number of records to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/hazards/actions/hurricane-tracking":{"post":{"operationId":"hazards__hurricane-tracking","summary":"NWS Hurricane & Tropical Storm Alerts","description":"Get active hurricane and tropical storm alerts from the National Weather Service API. Includes hurricane warnings, watches, and tropical storm warnings.","tags":["hazards"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":100,"default":10,"description":"Maximum results to return (1–100)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/hazards/actions/fema-nfip-claims":{"post":{"operationId":"hazards__fema-nfip-claims","summary":"FEMA Flood Insurance Claims","description":"National Flood Insurance Program (NFIP) claims data from FEMA. Includes loss amounts, property types, flood zones, and dates of loss. Useful for flood risk assessment and disaster analysis.","tags":["hazards"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"state":"AL","year":1978,"limit":50},"schema":{"type":"object","properties":{"state":{"type":"string","enum":["AL","AK","AZ","AR","CA","CO","CT","DE","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY","DC","AS","GU","MP","PR","VI"],"description":"U.S. state/territory code (e.g. CA, TX, NY, FL, IL)"},"year":{"type":"integer","minimum":1978,"maximum":2026,"description":"Year of loss"},"limit":{"type":"integer","minimum":1,"maximum":1000,"default":50,"description":"Max claims to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/economic/actions/fred-series":{"post":{"operationId":"economic__fred-series","summary":"FRED Series Observations","description":"Fetch time-series observations from the Federal Reserve Economic Data (FRED) API. Supports GDP, unemployment, CPI, and thousands of other economic indicators.","tags":["economic"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"seriesId":"GDP","limit":100},"schema":{"type":"object","properties":{"seriesId":{"allOf":[{"type":"string"},{"type":"string","pattern":"^[A-Z0-9_]+$"}],"default":"GDP","description":"FRED series ID (e.g. GDP, UNRATE, CPIAUCSL, FEDFUNDS, DFF, T10Y2Y)"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":10000,"default":100,"description":"Maximum results to return (1–10000)"},"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Start date (YYYY-MM-DD)"},"endDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"End date (YYYY-MM-DD)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/economic/actions/fred-search":{"post":{"operationId":"economic__fred-search","summary":"FRED Series Search","description":"Search for economic data series in the FRED database by keyword. Returns matching series with their IDs, titles, frequency, and units.","tags":["economic"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"query":"GDP","limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":500,"description":"Search query for FRED series (e.g. GDP, inflation, unemployment)","default":"GDP"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":100,"default":10,"description":"Maximum results to return (1–100)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/economic/actions/bls-series":{"post":{"operationId":"economic__bls-series","summary":"BLS Time Series","description":"Fetch time-series data from the Bureau of Labor Statistics (BLS). Covers CPI, unemployment, employment, and other labor statistics.","tags":["economic"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"seriesId":"LNS14000000","startYear":2025,"endYear":2026},"schema":{"type":"object","properties":{"seriesId":{"allOf":[{"type":"string"},{"type":"string","pattern":"^[A-Z]{2}[A-Z0-9]+$"}],"default":"LNS14000000","description":"BLS series ID (e.g. LNS14000000 for unemployment, CUUR0000SA0 for CPI)"},"startYear":{"type":"integer","minimum":1900,"maximum":2027,"default":2025,"description":"Start year"},"endYear":{"type":"integer","minimum":1900,"maximum":2027,"default":2026,"description":"End year"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/economic/actions/treasury-debt":{"post":{"operationId":"economic__treasury-debt","summary":"US Treasury Debt","description":"Fetch US national debt data from the Treasury Fiscal Data API. Returns total public debt outstanding and debt held by the public. Supports date range filtering for historical data back to 1993.","tags":["economic"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":100,"sortOrder":"desc"},"schema":{"type":"object","properties":{"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Start date (Treasury data available from 1993-01-04)"},"endDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"End date (defaults to today)"},"limit":{"type":"integer","minimum":1,"maximum":10000,"default":100,"description":"Max records (up to 10000)"},"sortOrder":{"type":"string","enum":["asc","desc"],"default":"desc","description":"Sort by record date"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/economic/actions/exchange-rates":{"post":{"operationId":"economic__exchange-rates","summary":"Currency Exchange Rates","description":"Get current or historical currency exchange rates from the Frankfurter API. Supports all major currencies with no API key required.","tags":["economic"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"base":"USD"},"schema":{"type":"object","properties":{"base":{"type":"string","default":"USD","description":"Base currency code e.g. USD, EUR, GBP"},"symbols":{"type":"string","description":"Comma-separated target currencies e.g. EUR,GBP,JPY"},"date":{"type":"string","description":"Historical date in YYYY-MM-DD format (omit for latest)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/economic/actions/world-bank":{"post":{"operationId":"economic__world-bank","summary":"World Bank Indicators","description":"Fetch development indicators from the World Bank API. Covers GDP, population, poverty, education, health, and hundreds of other country-level indicators.","tags":["economic"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"indicator":"NY.GDP.MKTP.CD","startYear":1,"endYear":1,"page":1,"perPage":50},"schema":{"type":"object","properties":{"country":{"allOf":[{"type":"string","default":"US"},{"type":"string","minLength":2,"maxLength":2,"pattern":"^[A-Z]{2}$"}],"description":"ISO 3166-1 alpha-2 country code (e.g. US, DE, JP, BR, GB)"},"indicator":{"type":"string","default":"NY.GDP.MKTP.CD","description":"World Bank indicator e.g. NY.GDP.MKTP.CD (GDP), SP.POP.TOTL (population)"},"startYear":{"type":"integer","description":"Start year for the date range (e.g. 1960)"},"endYear":{"type":"integer","description":"End year for the date range (e.g. 2024)"},"date":{"type":"string","description":"Date range in World Bank format (e.g. '1960:2024')"},"page":{"type":"integer","minimum":1,"default":1,"description":"Page number for pagination"},"perPage":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":1000,"default":50,"description":"Maximum results to return (1–1000)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/economic/actions/wto-trade":{"post":{"operationId":"economic__wto-trade","summary":"WTO Trade Data","description":"Fetch international trade statistics from the World Trade Organization (WTO) API. Covers merchandise trade, services, and tariffs.","tags":["economic"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"indicator":"ITS_MTV_AX","reporter":"840","partner":"000","period":"2023","maxResults":10},"schema":{"type":"object","properties":{"indicator":{"type":"string","pattern":"^[A-Z0-9_]+$","default":"ITS_MTV_AX","description":"WTO indicator code (e.g. ITS_MTV_AX for merchandise exports, ITS_MTV_AM for imports, ITS_CS_AX for commercial services)"},"reporter":{"type":"string","pattern":"^\\d{1,3}$","default":"840","description":"Reporter economy code (e.g. 840=USA, 156=China, 276=Germany, 000=World)"},"partner":{"type":"string","pattern":"^\\d{1,3}$","default":"000","description":"Partner economy code (e.g. 000=World, 840=USA, 156=China)"},"period":{"type":"string","pattern":"^\\d{4}$","default":"2023","description":"Year (e.g. '2023')"},"maxResults":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":100,"default":10,"description":"Maximum results to return (1–100)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/economic/actions/ecb-rates":{"post":{"operationId":"economic__ecb-rates","summary":"ECB Exchange Rates","description":"Get daily exchange rates from the European Central Bank.","tags":["economic"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"currency":"USD","lastN":10},"schema":{"type":"object","properties":{"currency":{"type":"string","default":"USD","description":"Currency code (e.g. USD, GBP, JPY)"},"lastN":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":100,"default":10,"description":"Maximum results to return (1–100)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/economic/actions/imf-commodities":{"post":{"operationId":"economic__imf-commodities","summary":"IMF World Economic Outlook","description":"Get economic indicators from the IMF World Economic Outlook (WEO) DataMapper. Includes GDP growth, inflation, unemployment, government debt, trade, and more for 190+ countries. Supports multi-year ranges back to 1980.","tags":["economic"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"indicator":"NGDP_RPCH","country":"USA","startYear":2000,"endYear":2026},"schema":{"type":"object","properties":{"indicator":{"type":"string","pattern":"^[A-Z0-9_]+$","default":"NGDP_RPCH","description":"WEO indicator code. Common: NGDP_RPCH (real GDP growth %), PCPIPCH (inflation %), LUR (unemployment %), GGXWDG_NGDP (govt debt % GDP), BCA_NGDPD (current account % GDP), NGDPD (GDP $ billions), NGDPDPC (GDP per capita $)"},"country":{"type":"string","default":"USA","description":"ISO3 country code (e.g. USA, GBR, CHN, DEU, JPN, FRA, IND, BRA) or W00 for World"},"startYear":{"type":"integer","minimum":1980,"maximum":2030,"default":2000,"description":"Start year (IMF has data from ~1980)"},"endYear":{"type":"integer","minimum":1980,"maximum":2030,"default":2026,"description":"End year (IMF includes forecasts 2-3 years ahead)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/economic/actions/comtrade":{"post":{"operationId":"economic__comtrade","summary":"UN Comtrade","description":"Query international trade data from the United Nations Comtrade database.","tags":["economic"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"reporterCode":"842","partnerCode":"0","period":"2024","flowCode":"M","cmdCode":"TOTAL"},"schema":{"type":"object","properties":{"reporterCode":{"type":"string","default":"842","description":"Reporter country code (842 = USA)"},"partnerCode":{"type":"string","default":"0","description":"Partner code (0 = World)"},"period":{"type":"string","default":"2024","description":"Year (UN Comtrade data lags ~2 years)"},"flowCode":{"type":"string","default":"M","description":"Trade flow (M = imports, X = exports)"},"cmdCode":{"type":"string","default":"TOTAL","description":"Commodity code (TOTAL for aggregate)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/economic/actions/bea-gdp":{"post":{"operationId":"economic__bea-gdp","summary":"BEA GDP","description":"Get GDP and national income data from the Bureau of Economic Analysis (BEA).","tags":["economic"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"tableName":"T10101","frequency":"Q","year":"2026"},"schema":{"type":"object","properties":{"tableName":{"type":"string","default":"T10101","description":"NIPA table name (e.g. T10101 for GDP, T20100 for income)"},"frequency":{"type":"string","enum":["A","Q","M"],"default":"Q","description":"Frequency: A (annual), Q (quarterly), M (monthly)"},"year":{"type":"string","pattern":"^\\d{4}$","default":"2026","description":"Year or comma-separated years (e.g. '2025' or '2023,2024,2025')"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/economic/actions/oecd-indicators":{"post":{"operationId":"economic__oecd-indicators","summary":"OECD Indicators","description":"Get key economic indicators from the OECD SDMX API.","tags":["economic"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"lastN":5},"schema":{"type":"object","properties":{"country":{"allOf":[{"type":"string","default":"USA"},{"type":"string","minLength":3,"maxLength":3,"pattern":"^[A-Z]{3}$"}],"description":"ISO 3166-1 alpha-3 country code (e.g. USA, GBR, CHN, DEU, JPN)"},"lastN":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":20,"default":5,"description":"Maximum results to return (1–20)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/economic/actions/eurostat-gdp":{"post":{"operationId":"economic__eurostat-gdp","summary":"Eurostat GDP & National Accounts","description":"GDP and main aggregates from Eurostat national accounts. Covers all EU/EEA member states with quarterly and annual data including GDP at market prices, household consumption, government expenditure, and gross capital formation.","tags":["economic"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"geo":"EU27_2020","unit":"CP_MEUR","na_item":"B1GQ"},"schema":{"type":"object","properties":{"geo":{"type":"string","default":"EU27_2020","description":"Eurostat geo code (e.g. EU27_2020, DE, FR, IT, ES, EA20)"},"unit":{"type":"string","enum":["CP_MEUR","CP_MNAC","CLV10_MEUR","PPS_EU27_2020"],"default":"CP_MEUR","description":"Unit: CP_MEUR (current prices M EUR), CLV10_MEUR (chain-linked volumes), PPS_EU27_2020 (purchasing power standard)"},"na_item":{"type":"string","enum":["B1GQ","P31_S14","P3_S13","P51G","P6","P7"],"default":"B1GQ","description":"Indicator: B1GQ (GDP), P31_S14 (household consumption), P3_S13 (gov expenditure), P51G (gross fixed capital), P6 (exports), P7 (imports)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/economic/actions/eurostat-unemployment":{"post":{"operationId":"economic__eurostat-unemployment","summary":"Eurostat Unemployment Rate","description":"Monthly and annual unemployment rates from Eurostat for EU/EEA countries. Seasonally adjusted, broken down by age and sex. Key indicator for European labour market.","tags":["economic"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"geo":"EU27_2020","age":"TOTAL","sex":"T","s_adj":"SA"},"schema":{"type":"object","properties":{"geo":{"type":"string","default":"EU27_2020","description":"Eurostat geo code (e.g. EU27_2020, EA20, DE, FR, IT)"},"age":{"type":"string","enum":["TOTAL","Y_LT25","Y25-74"],"default":"TOTAL","description":"Age group: TOTAL, Y_LT25 (youth <25), Y25-74"},"sex":{"type":"string","enum":["T","M","F"],"default":"T","description":"Sex: T (total), M (male), F (female)"},"s_adj":{"type":"string","enum":["SA","NSA"],"default":"SA","description":"Seasonal adjustment: SA (adjusted), NSA (not adjusted)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/economic/actions/eurostat-inflation":{"post":{"operationId":"economic__eurostat-inflation","summary":"Eurostat HICP Inflation","description":"Harmonised Index of Consumer Prices (HICP) from Eurostat. Monthly inflation rates for EU/EEA countries, the standard measure used by the ECB for monetary policy decisions.","tags":["economic"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"geo":"EA20","coicop":"CP00"},"schema":{"type":"object","properties":{"geo":{"type":"string","default":"EA20","description":"Eurostat geo code (e.g. EA20, EU27_2020, DE, FR)"},"coicop":{"type":"string","enum":["CP00","CP01","CP02","CP04","CP07","CP09","CP11","CP12"],"default":"CP00","description":"COICOP category: CP00 (all items), CP01 (food), CP04 (housing), CP07 (transport), CP09 (recreation), CP11 (restaurants), CP12 (misc)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/economic/actions/boc-rates":{"post":{"operationId":"economic__boc-rates","summary":"Bank of Canada Rates","description":"Interest rates and exchange rates from the Bank of Canada. Includes the policy interest rate, prime rate, government bond yields, and CAD exchange rates against major currencies.","tags":["economic"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"series":"FXUSDCAD"},"schema":{"type":"object","properties":{"series":{"type":"string","default":"FXUSDCAD","description":"Valet series name. Common: FXUSDCAD (USD/CAD), FXEURCAD (EUR/CAD), V39079 (policy rate), V39078 (prime rate), V39055 (5yr bond yield)"},"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Start date"},"endDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"End date"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/economic/actions/treasury-fiscal-data":{"post":{"operationId":"economic__treasury-fiscal-data","summary":"Treasury FiscalData","description":"Access 100+ Treasury fiscal datasets — interest rates, revenue, spending, securities, and more. Select a dataset and filter by date range.","tags":["economic"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"dataset":"avg_interest_rates","limit":100,"sort":"desc"},"schema":{"type":"object","properties":{"dataset":{"type":"string","enum":["avg_interest_rates","daily_treasury_rates","monthly_treasury_statement","top_federal_spending","treasury_securities"],"default":"avg_interest_rates","description":"Which Treasury dataset to query"},"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Start date"},"endDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"End date"},"limit":{"type":"integer","minimum":1,"maximum":10000,"default":100,"description":"Max records"},"sort":{"type":"string","enum":["asc","desc"],"default":"desc","description":"Sort by record date"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/crypto/actions/mempool-fees":{"post":{"operationId":"crypto__mempool-fees","summary":"Mempool Recommended Fees","description":"Get current Bitcoin recommended transaction fees from Mempool.space. Returns fee rates in sat/vB for different confirmation targets.","tags":["crypto"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/crypto/actions/mempool-mining":{"post":{"operationId":"crypto__mempool-mining","summary":"Mempool Mining Pools","description":"Get Bitcoin mining pool statistics from Mempool.space. Returns pool names, block counts, and hashrate share for a given time period.","tags":["crypto"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"period":"1w"},"schema":{"type":"object","properties":{"period":{"type":"string","enum":["24h","3d","1w","1m","3m","6m","1y","all"],"default":"1w","description":"Time period for mining pool statistics"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/crypto/actions/blockchain-stats":{"post":{"operationId":"crypto__blockchain-stats","summary":"Blockchain Stats","description":"Get Bitcoin network statistics from Blockchain.info including market price, hash rate, transaction count, and block time.","tags":["crypto"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/crypto/actions/etherscan-balance":{"post":{"operationId":"crypto__etherscan-balance","summary":"Etherscan Account Balance","description":"Get the ETH balance of an Ethereum address using Etherscan. Supports multiple EVM chains via chain ID.","tags":["crypto"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"chainId":1},"schema":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Ethereum address (e.g. 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe)"},"chainId":{"type":"integer","default":1,"description":"EVM chain ID (1=Ethereum, 137=Polygon, 42161=Arbitrum)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["address"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/crypto/actions/etherscan-txlist":{"post":{"operationId":"crypto__etherscan-txlist","summary":"Etherscan Transaction List","description":"Get recent transactions for an Ethereum address using Etherscan. Returns transaction hash, from, to, value, timestamp, and gas used.","tags":["crypto"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10,"chainId":1},"schema":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Ethereum address (e.g. 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe)"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Number of transactions to return"},"chainId":{"type":"integer","default":1,"description":"EVM chain ID (1=Ethereum, 137=Polygon, 42161=Arbitrum)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["address"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/crypto/actions/etherscan-gas":{"post":{"operationId":"crypto__etherscan-gas","summary":"Etherscan Gas Oracle","description":"Get current Ethereum gas prices from Etherscan gas oracle. Returns safe, proposed, and fast gas prices in Gwei.","tags":["crypto"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/crypto/actions/etherscan-price":{"post":{"operationId":"crypto__etherscan-price","summary":"Etherscan ETH Price","description":"Get the current ETH price in USD and BTC from Etherscan.","tags":["crypto"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/crypto/actions/coinlore-stats":{"post":{"operationId":"crypto__coinlore-stats","summary":"Coinlore Stats","description":"Get global cryptocurrency market statistics from Coinlore.","tags":["crypto"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/crypto/actions/coinpaprika":{"post":{"operationId":"crypto__coinpaprika","summary":"Coinpaprika","description":"Get cryptocurrency market data from Coinpaprika including prices, volume, and market cap.","tags":["crypto"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"coinId":{"type":"string","description":"Coin ID (e.g. btc-bitcoin). If omitted, returns global market data."},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/crypto/actions/gemini":{"post":{"operationId":"crypto__gemini","summary":"Gemini Ticker","description":"Get cryptocurrency ticker data from the Gemini exchange.","tags":["crypto"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"symbol":"btcusd"},"schema":{"type":"object","properties":{"symbol":{"type":"string","default":"btcusd","description":"Trading pair symbol (e.g. btcusd, ethusd, solusd)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/crypto/actions/coinranking":{"post":{"operationId":"crypto__coinranking","summary":"CoinRanking Live Prices","description":"Get live cryptocurrency prices and market data for 2,000+ coins from CoinRanking. Filter by tier, sort by market cap, price, or 24h change. Returns price, market cap, 24h volume, sparkline, and all-time high.","tags":["crypto"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":20,"offset":0,"orderBy":"marketCap","orderDirection":"desc","tiers":1},"schema":{"type":"object","properties":{"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":100,"default":20,"description":"Maximum results to return (1–100)"},"offset":{"type":"integer","minimum":0,"default":0,"description":"Offset for pagination"},"orderBy":{"type":"string","enum":["marketCap","price","24hVolume","change","listedAt"],"default":"marketCap","description":"Sort field"},"orderDirection":{"type":"string","enum":["asc","desc"],"default":"desc","description":"Sort direction"},"tiers":{"type":"integer","minimum":1,"maximum":3,"description":"Filter by tier (1=top, 2=mid, 3=small)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/crypto/actions/dexpaprika":{"post":{"operationId":"crypto__dexpaprika","summary":"DexPaprika DEX & DeFi Data","description":"Free decentralized exchange (DEX) and DeFi data from DexPaprika. Query liquidity pools, token prices, OHLCV charts, and 24h trade volume across Ethereum, Solana, BSC, Arbitrum, Polygon, Base, and 30+ more chains. No API key required.","tags":["crypto"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"action":"networks","limit":10,"page":0,"orderBy":"volume_usd_24h"},"schema":{"type":"object","properties":{"action":{"type":"string","enum":["networks","pools","token"],"default":"networks","description":"Data to fetch: networks list, top pools, or token detail"},"networkId":{"type":"string","description":"Network ID (e.g. 'ethereum', 'solana', 'bsc', 'base') — required for pools/token"},"tokenAddress":{"type":"string","description":"Token contract address — required for 'token' action"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":100,"default":10,"description":"Maximum results to return (1–100)"},"page":{"type":"integer","minimum":0,"default":0,"description":"Page number for pools pagination"},"orderBy":{"type":"string","enum":["volume_usd_24h","price_usd","transactions_24h"],"default":"volume_usd_24h","description":"Sort field for pools"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/demographics/actions/census-acs":{"post":{"operationId":"demographics__census-acs","summary":"Census ACS 5-Year","description":"Query the U.S. Census Bureau American Community Survey (ACS) 5-year estimates. Retrieve population, income, housing, and demographic variables by geography.","tags":["demographics"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"variables":"NAME,B01003_001E","geo":"state:*"},"schema":{"type":"object","properties":{"variables":{"type":"string","default":"NAME,B01003_001E","description":"Comma-separated Census variable codes (e.g. NAME,B01003_001E for population)"},"geo":{"type":"string","default":"state:*","description":"Geography level and filter (e.g. state:*, county:*&in=state:06)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/demographics/actions/eurostat":{"post":{"operationId":"demographics__eurostat","summary":"Eurostat Statistics","description":"Query Eurostat for European statistical data including GDP, population, employment, trade, and more. Returns JSON-stat format data.","tags":["demographics"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"dataset":"nama_10_gdp","geo":"EU27_2020"},"schema":{"type":"object","properties":{"dataset":{"type":"string","default":"nama_10_gdp","description":"Eurostat dataset code (e.g. nama_10_gdp, demo_pjan)"},"geo":{"type":"string","default":"EU27_2020","description":"Geographic area code (e.g. EU27_2020, DE, FR)"},"time":{"type":"string","description":"Time period filter (e.g. 2022, 2020-2022)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/demographics/actions/rest-countries":{"post":{"operationId":"demographics__rest-countries","summary":"REST Countries","description":"Look up country information including population, capital, region, languages, currencies, and flags. Search by name, alpha code, or region.","tags":["demographics"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"endpoint":"name","value":"United States"},"schema":{"type":"object","properties":{"endpoint":{"type":"string","enum":["name","alpha","region"],"default":"name","description":"Search endpoint: name (by country name), alpha (by ISO code), region (by region)"},"value":{"type":"string","default":"United States","description":"Search value (e.g. country name, ISO 3166-1 alpha code, or region name)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/demographics/actions/nager-date":{"post":{"operationId":"demographics__nager-date","summary":"Public Holidays","description":"Get public holidays for any country and year using the Nager.Date API. Covers 100+ countries with holiday types and regional info.","tags":["demographics"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"year":2026,"countryCode":"US"},"schema":{"type":"object","properties":{"year":{"type":"integer","default":2026,"description":"Year to retrieve holidays for"},"countryCode":{"type":"string","minLength":2,"maxLength":2,"default":"US","description":"ISO 3166-1 alpha-2 country code (e.g. US, DE, JP)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/demographics/actions/census-economic-indicators":{"post":{"operationId":"demographics__census-economic-indicators","summary":"Census Economic Indicators","description":"Monthly and quarterly economic indicators from the US Census Bureau — retail sales, construction spending, manufacturing, housing starts, and trade.","tags":["demographics"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"indicator":"resconst","year":2025},"schema":{"type":"object","properties":{"indicator":{"type":"string","enum":["resconst","retail","manufacturing","international_trade"],"default":"resconst","description":"Indicator: resconst (housing/construction), retail (retail sales), manufacturing, international_trade"},"year":{"type":"integer","minimum":2000,"maximum":2026,"default":2025,"description":"Year to query"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/education/actions/nps-education":{"post":{"operationId":"education__nps-education","summary":"NPS Lesson Plans","description":"Search the National Park Service lesson plan database. Find educational resources about national parks, history, science, and the environment.","tags":["education"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query for lesson plans (e.g. geology, civil war, wildlife)"},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Maximum number of lesson plans to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/education/actions/hipolabs-universities":{"post":{"operationId":"education__hipolabs-universities","summary":"World Universities Search","description":"Search universities worldwide using the Hipolabs University Domains API. Filter by country and name to find institution details, domains, and web pages.","tags":["education"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string","description":"Country name to filter by (e.g. United States, Germany, Japan)"},"name":{"type":"string","description":"University name or partial name to search for"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/education/actions/college-scorecard":{"post":{"operationId":"education__college-scorecard","summary":"College Scorecard","description":"Search U.S. colleges and universities via the Department of Education College Scorecard API. Returns admissions rates, tuition costs, and enrollment size.","tags":["education"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10,"fields":"school.name,school.city,school.state,latest.admissions.admission_rate.overall,latest.cost.tuition.in_state,latest.student.size"},"schema":{"type":"object","properties":{"query":{"type":"string","description":"School name to search for (e.g. Harvard, MIT, UCLA)"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Maximum number of schools to return"},"fields":{"type":"string","default":"school.name,school.city,school.state,latest.admissions.admission_rate.overall,latest.cost.tuition.in_state,latest.student.size","description":"Comma-separated list of fields to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/education/actions/ed-demographics":{"post":{"operationId":"education__ed-demographics","summary":"Education Demographics","description":"Query school demographic data from the College Scorecard API including race/ethnicity breakdowns by state.","tags":["education"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"state":"NY","limit":10},"schema":{"type":"object","properties":{"state":{"type":"string","default":"NY","description":"Two-letter state abbreviation (e.g. NY, CA, TX)"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Maximum number of schools to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/education/actions/uk-education":{"post":{"operationId":"education__uk-education","summary":"UK Education Statistics","description":"UK education statistics from the Department for Education. School performance, pupil characteristics, workforce data, and educational outcomes for England.","tags":["education"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"query":"schools","limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","default":"schools","description":"Search query for education datasets"},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Max results"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/consumer/actions/cpsc-recalls":{"post":{"operationId":"consumer__cpsc-recalls","summary":"CPSC Product Recalls","description":"Search U.S. Consumer Product Safety Commission (CPSC) product recall data. Filter by date range and product type.","tags":["consumer"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":25},"schema":{"type":"object","properties":{"startDate":{"type":"string","description":"Start date for recall search (YYYY-MM-DD)"},"endDate":{"type":"string","description":"End date for recall search (YYYY-MM-DD)"},"productType":{"type":"string","description":"Product type to filter (e.g. Toys, Electronics, Furniture)"},"limit":{"type":"integer","minimum":1,"maximum":50,"default":25,"description":"Maximum number of recall records to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/consumer/actions/ftc-dnc":{"post":{"operationId":"consumer__ftc-dnc","summary":"FTC Do Not Call Complaints","description":"Query the FTC Do Not Call (DNC) complaint data. Shows reported unwanted call complaints filed with the Federal Trade Commission.","tags":["consumer"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":20},"schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Maximum number of complaint records to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/consumer/actions/ftc-mergers":{"post":{"operationId":"consumer__ftc-mergers","summary":"FTC HSR Early Termination Notices","description":"Query FTC Hart-Scott-Rodino early termination notices for merger and acquisition filings. Shows companies that received early termination of the HSR waiting period.","tags":["consumer"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":20},"schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Maximum number of early termination notices to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/consumer/actions/cfpb-complaints":{"post":{"operationId":"consumer__cfpb-complaints","summary":"CFPB Consumer Complaints","description":"Search consumer complaints about financial products from the Consumer Financial Protection Bureau. Covers mortgages, credit cards, student loans, debt collection, and more. Supports date range filtering and pagination. Over 4 million complaints since 2011.","tags":["consumer"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"state":"AL","page":1,"limit":25},"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":500,"description":"Search query text"},"product":{"type":"string","description":"Financial product filter (e.g. Mortgage, Credit card, Student loan, Debt collection, Credit reporting)"},"company":{"type":"string","description":"Company name filter (e.g. Bank of America, Wells Fargo)"},"state":{"type":"string","enum":["AL","AK","AZ","AR","CA","CO","CT","DE","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY","DC","AS","GU","MP","PR","VI"],"description":"U.S. state/territory code (e.g. CA, TX, NY, FL, IL)"},"dateReceivedMin":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Start date — complaints received on or after this date"},"dateReceivedMax":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"End date — complaints received on or before this date"},"page":{"type":"integer","minimum":1,"default":1,"description":"Page number for pagination"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Results per page (max 100)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/consumer/actions/cpsc-violations":{"post":{"operationId":"consumer__cpsc-violations","summary":"CPSC Violations & Investigations","description":"Search CPSC product safety violations and section 15 reports for hazardous consumer products.","tags":["consumer"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search term for product recalls (e.g. stroller, battery, toy)"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Maximum number of recall records to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/consumer/actions/cfpb-hmda":{"post":{"operationId":"consumer__cfpb-hmda","summary":"CFPB Mortgage Data (HMDA)","description":"Home Mortgage Disclosure Act data from CFPB — aggregated mortgage lending statistics by action type, year, and geography. Covers loan originations, denials, and applications nationwide.","tags":["consumer"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"year":2022,"state":"AL","actionsTaken":"1"},"schema":{"type":"object","properties":{"year":{"type":"integer","minimum":2018,"maximum":2023,"default":2022,"description":"HMDA reporting year (2018-2023)"},"state":{"type":"string","enum":["AL","AK","AZ","AR","CA","CO","CT","DE","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY","DC","AS","GU","MP","PR","VI"],"description":"U.S. state/territory code (e.g. CA, TX, NY, FL, IL)"},"actionsTaken":{"type":"string","enum":["1","2","3","4","5"],"default":"1","description":"1=originated, 2=approved not accepted, 3=denied, 4=withdrawn, 5=incomplete"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/housing/actions/hud-fmr":{"post":{"operationId":"housing__hud-fmr","summary":"HUD Fair Market Rents","description":"Get Fair Market Rent (FMR) data from the U.S. Department of Housing and Urban Development (HUD). FMRs are used to determine rental voucher payment amounts by metro area.","tags":["housing"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"stateCode":"DC","year":2025},"schema":{"type":"object","properties":{"stateCode":{"type":"string","enum":["AL","AK","AZ","AR","CA","CO","CT","DE","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY","DC","AS","GU","MP","PR","VI"],"description":"U.S. state/territory code (e.g. CA, TX, NY, FL, IL)","default":"DC"},"entityId":{"type":"string","description":"HUD entity ID (e.g. METRO47900M47900 for DC metro). Use this OR stateCode."},"year":{"type":"integer","minimum":2000,"maximum":2026,"default":2025,"description":"FMR fiscal year (2000-present). HUD data for current year may not be published until mid-year."},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/housing/actions/gsa-per-diem":{"post":{"operationId":"housing__gsa-per-diem","summary":"GSA Per Diem Rates","description":"Get federal per diem rates from the U.S. General Services Administration (GSA). Includes lodging and meals & incidentals (M&IE) rates by city and state.","tags":["housing"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"city":"Washington","state":"DC","year":2026},"schema":{"type":"object","properties":{"city":{"type":"string","default":"Washington","description":"City name"},"state":{"type":"string","minLength":2,"maxLength":2,"default":"DC","description":"Two-letter state abbreviation (e.g. DC, CA, NY)"},"year":{"type":"integer","default":2026,"description":"Fiscal year for per diem rates"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/housing/actions/hud-income-limits":{"post":{"operationId":"housing__hud-income-limits","summary":"HUD Income Limits","description":"Get income limit data from the U.S. Department of Housing and Urban Development. Income limits determine eligibility for HUD assisted housing programs by metro area.","tags":["housing"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"stateCode":"VA","year":2025},"schema":{"type":"object","properties":{"stateCode":{"type":"string","enum":["AL","AK","AZ","AR","CA","CO","CT","DE","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY","DC","AS","GU","MP","PR","VI"],"description":"U.S. state/territory code (e.g. CA, TX, NY, FL, IL)","default":"VA"},"entityId":{"type":"string","description":"HUD entity ID (e.g. METRO47900M47900 for DC metro). Use this OR stateCode."},"year":{"type":"integer","minimum":2000,"maximum":2026,"default":2025,"description":"Income limits fiscal year (2000-present). HUD data for current year may not be published until mid-year."},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/housing/actions/hud-chas":{"post":{"operationId":"housing__hud-chas","summary":"HUD CHAS Affordability Data","description":"Query the HUD Comprehensive Housing Affordability Strategy (CHAS) data. Provides housing affordability metrics at nation, state, or county level.","tags":["housing"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"type":"nation","year":"2014-2018"},"schema":{"type":"object","properties":{"type":{"type":"string","enum":["nation","state","county","mcd","place"],"default":"nation","description":"Geographic level: nation, state, county, mcd (minor civil division), or place"},"year":{"anyOf":[{"type":"string"},{"type":"number"}],"default":"2014-2018","description":"CHAS data year range (e.g. '2014-2018'). Latest available: 2014-2018. Or pass a single year to auto-map."},"stateId":{"type":"string","description":"Numeric state FIPS code (required for state/county/mcd/place, e.g. '6' for California, '36' for New York)"},"entityId":{"type":"string","description":"Entity ID for county/mcd/place level queries. Use list endpoints to discover valid IDs."},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/housing/actions/uk-land-registry":{"post":{"operationId":"housing__uk-land-registry","summary":"UK Land Registry House Prices","description":"UK house price data from HM Land Registry. Search property transactions by postcode, town, or county. Includes sale price, property type, tenure, and transaction date for all registered sales in England and Wales.","tags":["housing"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"minPrice":1,"maxPrice":1,"limit":20},"schema":{"type":"object","properties":{"postcode":{"type":"string","description":"UK postcode (e.g. SW1A 1AA, EC2R 8AH)"},"town":{"type":"string","description":"Town or city name (e.g. London, Manchester, Bristol)"},"county":{"type":"string","description":"County name (e.g. GREATER LONDON, WEST MIDLANDS)"},"minPrice":{"type":"number","description":"Minimum sale price filter"},"maxPrice":{"type":"number","description":"Maximum sale price filter"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Max results"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/fun/actions/pokeapi":{"post":{"operationId":"fun__pokeapi","summary":"PokéAPI Pokémon Lookup","description":"Look up a Pokémon by name or ID using the PokéAPI. Returns name, types, stats, abilities, height, weight, and sprite URLs.","tags":["fun"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"nameOrId":"pikachu"},"schema":{"type":"object","properties":{"nameOrId":{"type":"string","default":"pikachu","description":"Pokémon name or Pokédex ID"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/fun/actions/rick-and-morty":{"post":{"operationId":"fun__rick-and-morty","summary":"Rick and Morty Characters","description":"Look up Rick and Morty characters by ID or search by name. Returns character details including status, species, origin, and location.","tags":["fun"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"id":1},"schema":{"type":"object","properties":{"id":{"type":"integer","default":1,"description":"Character ID"},"name":{"type":"string","description":"Search by character name (overrides id if provided)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/fun/actions/swapi":{"post":{"operationId":"fun__swapi","summary":"SWAPI Star Wars","description":"Query the Star Wars API for people, planets, starships, and films. Returns detailed information from the Star Wars universe.","tags":["fun"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"resource":"people","id":1},"schema":{"type":"object","properties":{"resource":{"type":"string","enum":["people","planets","starships","films"],"description":"Resource type to query"},"id":{"type":"integer","default":1,"description":"Resource ID"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["resource"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/fun/actions/random-user":{"post":{"operationId":"fun__random-user","summary":"RandomUser Generator","description":"Generate random user profiles with names, addresses, emails, and photos. Optionally filter by nationality.","tags":["fun"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"count":1},"schema":{"type":"object","properties":{"count":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":100,"default":1,"description":"Maximum results to return (1–100)"},"nationality":{"type":"string","description":"Nationality code (e.g. US, GB, FR, DE)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/fun/actions/chess-com":{"post":{"operationId":"fun__chess-com","summary":"Chess.com Player Stats","description":"Get a Chess.com player's stats including ratings for rapid, blitz, bullet, and puzzle categories.","tags":["fun"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"username":"hikaru"},"schema":{"type":"object","properties":{"username":{"type":"string","default":"hikaru","description":"Chess.com username"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/fun/actions/free-to-game":{"post":{"operationId":"fun__free-to-game","summary":"FreeToGame Free Games List","description":"Browse free-to-play games. Filter by platform (PC, browser) and genre. Sort by popularity, release date, or alphabetically.","tags":["fun"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"platform":"all","sortBy":"release-date"},"schema":{"type":"object","properties":{"platform":{"type":"string","enum":["all","pc","browser"],"description":"Target platform"},"category":{"type":"string","description":"Game genre (e.g. mmorpg, shooter, strategy, moba)"},"sortBy":{"type":"string","enum":["release-date","popularity","alphabetical","relevance"],"description":"Sort order"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/fun/actions/open-trivia":{"post":{"operationId":"fun__open-trivia","summary":"Open Trivia Database","description":"Get trivia questions from the Open Trivia Database. Filter by category and difficulty. Returns questions with correct and incorrect answers.","tags":["fun"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"amount":10,"category":1,"difficulty":"easy"},"schema":{"type":"object","properties":{"amount":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":50,"default":10,"description":"Maximum results to return (1–50)"},"category":{"type":"integer","description":"Category ID (9=General, 18=Computers, 21=Sports, 23=History, etc.)"},"difficulty":{"type":"string","enum":["easy","medium","hard"],"description":"Question difficulty"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/fun/actions/scryfall":{"post":{"operationId":"fun__scryfall","summary":"Scryfall MTG Card Search","description":"Search Magic: The Gathering cards via Scryfall. Supports full-text search or returns a random card. Rich card data with images, prices, and legality.","tags":["fun"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query (Scryfall syntax). Omit for a random card."},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/fun/actions/musicbrainz":{"post":{"operationId":"fun__musicbrainz","summary":"MusicBrainz Music Database","description":"Search the MusicBrainz open music encyclopedia for artists, recordings, and releases. Returns detailed metadata.","tags":["fun"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"resource":"artist","limit":10},"schema":{"type":"object","properties":{"resource":{"type":"string","enum":["artist","recording","release"],"description":"Resource type to search"},"query":{"type":"string","description":"Search query"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":100,"default":10,"description":"Maximum results to return (1–100)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["resource","query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/fun/actions/radio-browser":{"post":{"operationId":"fun__radio-browser","summary":"Radio Browser Stations","description":"Search internet radio stations worldwide. Filter by name and country. Returns station name, URL, codec, bitrate, and tags.","tags":["fun"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"name":{"type":"string","description":"Station name to search for"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":100,"default":10,"description":"Maximum results to return (1–100)"},"country":{"type":"string","description":"Country name to filter by"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/fun/actions/jsonplaceholder":{"post":{"operationId":"fun__jsonplaceholder","summary":"JSONPlaceholder Mock Data","description":"Fetch mock REST data from JSONPlaceholder. Supports posts, comments, users, and todos. Useful for testing and prototyping.","tags":["fun"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"resource":"posts","id":1},"schema":{"type":"object","properties":{"resource":{"type":"string","enum":["posts","comments","users","todos"],"description":"Resource type to fetch"},"id":{"type":"integer","description":"Specific resource ID. Omit to list all."},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["resource"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/fun/actions/mangadex":{"post":{"operationId":"fun__mangadex","summary":"MangaDex Manga Search","description":"Search and discover manga titles from MangaDex — the world's largest manga library. Filter by title, content rating, tags, status, and demographics. Returns titles, descriptions, cover art, and chapter counts.","tags":["fun"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10,"offset":0,"contentRating":["safe","suggestive"],"status":"ongoing","orderByLatest":true},"schema":{"type":"object","properties":{"title":{"type":"string","description":"Manga title to search for"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":100,"default":10,"description":"Maximum results to return (1–100)"},"offset":{"type":"integer","minimum":0,"default":0,"description":"Pagination offset"},"contentRating":{"type":"array","items":{"type":"string","enum":["safe","suggestive","erotica"]},"default":["safe","suggestive"],"description":"Content rating filters"},"status":{"type":"string","enum":["ongoing","completed","hiatus","cancelled"],"description":"Publication status filter"},"orderByLatest":{"type":"boolean","default":true,"description":"Order by latest update (true) or relevance (false)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/culture/actions/loc-search":{"post":{"operationId":"culture__loc-search","summary":"Library of Congress Search","description":"Search the Library of Congress digital collections for books, photographs, maps, manuscripts, and more.","tags":["culture"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Number of results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/culture/actions/mediawiki":{"post":{"operationId":"culture__mediawiki","summary":"Wikipedia Summary","description":"Retrieve a summary of any Wikipedia article using the Wikimedia REST API. Supports multiple languages.","tags":["culture"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"language":"en"},"schema":{"type":"object","properties":{"title":{"type":"string","description":"Wikipedia article title (e.g. 'Albert_Einstein')"},"language":{"type":"string","default":"en","description":"Wikipedia language code (e.g. en, fr, de, es)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["title"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/culture/actions/aic-artworks":{"post":{"operationId":"culture__aic-artworks","summary":"Art Institute of Chicago Artworks","description":"Search the Art Institute of Chicago's collection of over 300,000 artworks. Returns artwork metadata including artist, date, medium, and image links.","tags":["culture"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":500,"description":"Search query text"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Number of results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/culture/actions/open-library":{"post":{"operationId":"culture__open-library","summary":"Open Library Book Search","description":"Search Open Library's catalog of over 20 million books. Returns book metadata including title, author, publication year, and cover images.","tags":["culture"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query (title, author, ISBN, or subject)"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Number of results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/culture/actions/openafrica":{"post":{"operationId":"culture__openafrica","summary":"openAFRICA Dataset Search","description":"Search openAFRICA, the largest independent open data portal on the African continent. Returns dataset metadata from governments, NGOs, and researchers.","tags":["culture"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query (optional, returns recent datasets if omitted)"},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Number of results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/culture/actions/met-museum":{"post":{"operationId":"culture__met-museum","summary":"Metropolitan Museum of Art","description":"Search The Metropolitan Museum of Art's collection of over 470,000 artworks. Returns detailed object metadata including artist, period, medium, and images.","tags":["culture"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":5},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query (e.g. 'sunflowers', 'Egyptian', 'Monet')"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":5,"description":"Number of objects to return (each requires a separate fetch)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/culture/actions/poetrydb":{"post":{"operationId":"culture__poetrydb","summary":"PoetryDB","description":"Search PoetryDB for classic poetry by title, author, or lines. Contains works from poets like Shakespeare, Dickinson, Keats, and more.","tags":["culture"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"field":"title"},"schema":{"type":"object","properties":{"field":{"type":"string","enum":["title","author","lines"],"description":"Field to search by: title, author, or lines"},"value":{"type":"string","description":"Search value (e.g. 'Shakespeare', 'Sonnet', 'love')"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["field","value"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/culture/actions/gutendex":{"post":{"operationId":"culture__gutendex","summary":"Project Gutenberg Books","description":"Search Project Gutenberg's catalog of over 70,000 free ebooks via the Gutendex API. Returns book metadata including authors, subjects, and download links.","tags":["culture"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"query":"shakespeare","limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":500,"description":"Search query text","default":"shakespeare"},"limit":{"type":"integer","minimum":1,"maximum":32,"default":10,"description":"Number of results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/culture/actions/bible-api":{"post":{"operationId":"culture__bible-api","summary":"Bible API","description":"Retrieve Bible verses and passages by reference. Supports single verses (john 3:16), ranges (romans 8:28-39), and multiple references.","tags":["culture"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reference":{"type":"string","description":"Bible reference (e.g. 'john+3:16', 'romans 8:28-39', 'genesis 1:1-10')"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["reference"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/culture/actions/quran-cloud":{"post":{"operationId":"culture__quran-cloud","summary":"Quran Cloud API","description":"Retrieve Quran ayahs (verses) by reference with multiple translations. Supports surah:ayah notation and various editions/translations.","tags":["culture"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"edition":"en.asad"},"schema":{"type":"object","properties":{"reference":{"type":"string","description":"Ayah reference as 'surah:ayah' (e.g. '2:255') or ayah number (e.g. '262')"},"edition":{"type":"string","default":"en.asad","description":"Translation edition identifier (e.g. 'en.asad', 'en.pickthall', 'ar.alafasy')"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["reference"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/culture/actions/free-dictionary":{"post":{"operationId":"culture__free-dictionary","summary":"Free Dictionary","description":"Look up word definitions, phonetics, synonyms, and usage examples from the Free Dictionary API. Supports multiple languages.","tags":["culture"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"language":"en"},"schema":{"type":"object","properties":{"word":{"type":"string","description":"Word to look up"},"language":{"type":"string","default":"en","description":"Language code (e.g. en, es, fr, de, it, pt-BR)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["word"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/culture/actions/wiktionary":{"post":{"operationId":"culture__wiktionary","summary":"Wiktionary Definitions","description":"Look up word definitions, etymology, and usage from Wiktionary, the free multilingual dictionary with over 7 million entries.","tags":["culture"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"word":{"type":"string","description":"Word to look up"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["word"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/culture/actions/colormind":{"post":{"operationId":"culture__colormind","summary":"Colormind Color Palette","description":"Generate harmonious color palettes using Colormind's deep-learning model. Returns a 5-color palette with RGB values and hex codes.","tags":["culture"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"model":"default"},"schema":{"type":"object","properties":{"model":{"type":"string","default":"default","description":"Color model to use (e.g. 'default', 'ui', 'metroid_fusion')"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/culture/actions/emojihub":{"post":{"operationId":"culture__emojihub","summary":"EmojiHub Random Emoji","description":"Get a random emoji from EmojiHub, optionally filtered by category. Categories include smileys-and-people, animals-and-nature, food-and-drink, travel-and-places, activities, objects, symbols, flags.","tags":["culture"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","description":"Emoji category (e.g. 'smileys-and-people', 'animals-and-nature', 'food-and-drink', 'travel-and-places', 'activities', 'objects', 'symbols', 'flags')"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/culture/actions/smithsonian":{"post":{"operationId":"culture__smithsonian","summary":"Smithsonian Open Access","description":"Search the Smithsonian Institution's Open Access collection of art, artifacts, and scientific specimens.","tags":["culture"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"limit":{"type":"number","default":10,"description":"Number of results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/sports/actions/live-scores":{"post":{"operationId":"sports__live-scores","summary":"Live Scores","description":"Get sports events and scores for a specific date from TheSportsDB.","tags":["sports"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string","description":"Date in ISO format (YYYY-MM-DD)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["date"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/sports/actions/team-info":{"post":{"operationId":"sports__team-info","summary":"Team Info","description":"Search for team information by name from TheSportsDB. Returns team details, stadium, badge, and social links.","tags":["sports"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"teamName":{"type":"string","description":"Team name to search for"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["teamName"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/sports/actions/league-schedules":{"post":{"operationId":"sports__league-schedules","summary":"League Schedules","description":"Get all events for a league season from TheSportsDB. Defaults to English Premier League current season.","tags":["sports"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"leagueId":4328,"season":"2025-2026"},"schema":{"type":"object","properties":{"leagueId":{"type":"number","default":4328,"description":"League ID (default 4328 for English Premier League)"},"season":{"type":"string","default":"2025-2026","description":"Season string (e.g. '2025-2026')"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/sports/actions/openligadb":{"post":{"operationId":"sports__openligadb","summary":"OpenLigaDB Football Data","description":"Free German and European football (soccer) data from OpenLigaDB. Get match results, current tables, and team data for Bundesliga (bl1), 2. Bundesliga (bl2), DFB Pokal, Champions League, and many other leagues. No API key required.","tags":["sports"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"type":"matches","league":"bl1","season":2026,"matchday":1},"schema":{"type":"object","properties":{"type":{"type":"string","enum":["matches","table","teams","currentmatches"],"default":"matches","description":"Data type: matches for a round, table for standings, teams for club list, currentmatches for live games"},"league":{"type":"string","default":"bl1","description":"League shortcut: bl1 (Bundesliga), bl2 (2.Bundesliga), bl3, ucl (Champions League), uel (Europa League)"},"season":{"type":"integer","minimum":2000,"default":2026,"description":"Season year (e.g. 2025 for 2025/26)"},"matchday":{"type":"integer","minimum":1,"description":"Match day / round number (for matches type)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/entertainment/actions/book-search":{"post":{"operationId":"entertainment__book-search","summary":"Book Search","description":"Search for books by title, author, or keyword using the Open Library API. Returns title, author, first publish year, and ISBN.","tags":["entertainment"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query (title, author, or keyword)"},"limit":{"type":"number","minimum":1,"maximum":100,"default":10,"description":"Maximum number of results"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/utilities/actions/unit-conversion":{"post":{"operationId":"utilities__unit-conversion","summary":"Unit Conversion","description":"Convert between common units of measurement. Supports length (km, miles, m, ft, cm, inches, yards), weight (kg, lbs, g, oz), volume (liters, gallons, ml, cups), speed (kph, mph, m/s), and temperature (C, F, K).","tags":["utilities"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"value":1},"schema":{"type":"object","properties":{"value":{"type":"number","description":"The numeric value to convert"},"from":{"type":"string","description":"Source unit (e.g. 'km', 'lbs', 'C', 'liters')"},"to":{"type":"string","description":"Target unit (e.g. 'miles', 'kg', 'F', 'gallons')"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["value","from","to"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/utilities/actions/qr-code":{"post":{"operationId":"utilities__qr-code","summary":"QR Code Generator","description":"Generate a QR code image URL for any text or URL. Returns a direct link to the PNG image after verifying the service is reachable.","tags":["utilities"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"size":200},"schema":{"type":"object","properties":{"data":{"type":"string","description":"The text or URL to encode in the QR code"},"size":{"type":"number","minimum":50,"maximum":1000,"default":200,"description":"Size of the QR code image in pixels"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["data"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/utilities/actions/url-shortener":{"post":{"operationId":"utilities__url-shortener","summary":"URL Shortener","description":"Shorten a long URL using the is.gd URL shortening service.","tags":["utilities"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"The URL to shorten"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["url"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/utilities/actions/rdap-whois":{"post":{"operationId":"utilities__rdap-whois","summary":"RDAP/WHOIS Lookup","description":"Look up domain registration information using the RDAP protocol (successor to WHOIS). Returns registrar, status, nameservers, and event dates.","tags":["utilities"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string","description":"Domain name to look up (e.g. 'example.com')"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["domain"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/utilities/actions/fetch-url":{"post":{"operationId":"utilities__fetch-url","summary":"Sandboxed URL Fetch","description":"Fetch a public http(s) URL and return its body as text. Blocks private/loopback/link-local/metadata addresses at DNS resolve time, enforces a 5 MB cap, follows at most 5 redirects, and converts HTML to plain text. Intended as a general-purpose page reader for AI agents.","tags":["utilities"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"format":"text","timeoutMs":15000},"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","maxLength":2048,"description":"Absolute http(s) URL to fetch. Private, loopback, link-local, and metadata addresses are rejected."},"format":{"type":"string","enum":["text","raw"],"default":"text","description":"'text' converts HTML to plain text (default). 'raw' returns the response body as-is."},"timeoutMs":{"type":"integer","minimum":1000,"maximum":30000,"default":15000,"description":"Per-request timeout in milliseconds (1000–30000)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["url"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/usaspending":{"post":{"operationId":"government__usaspending","summary":"USAspending Agencies","description":"List federal agencies from the USAspending.gov API. Returns agency names, budgets, and identifiers.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":20},"schema":{"type":"object","properties":{"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":1000,"default":20,"description":"Maximum results to return (1–1000)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/sec-edgar":{"post":{"operationId":"government__sec-edgar","summary":"SEC EDGAR Filings Search","description":"Search SEC EDGAR for company filings (10-K, 10-Q, 8-K, etc.). Filter by keyword, form type, and date range.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"forms":"10-K","from":0,"limit":100},"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":500,"description":"Search query text"},"forms":{"type":"string","default":"10-K","description":"Form type filter (e.g. 10-K, 10-Q, 8-K)"},"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Start date for filtering"},"endDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"End date for filtering"},"from":{"type":"integer","minimum":0,"default":0,"description":"Pagination offset (number of results to skip)"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":100,"default":100,"description":"Maximum results to return (1–100)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/congress-bills":{"post":{"operationId":"government__congress-bills","summary":"U.S. Congress Bills","description":"Retrieve recent bills from the U.S. Congress API. Optionally filter by congress number.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":20,"congress":1},"schema":{"type":"object","properties":{"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":1000,"default":20,"description":"Maximum results to return (1–1000)"},"congress":{"type":"integer","description":"Congress number (e.g. 118)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/govinfo":{"post":{"operationId":"government__govinfo","summary":"GovInfo Collections","description":"List available document collections from the U.S. Government Publishing Office (GPO) GovInfo API.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":20},"schema":{"type":"object","properties":{"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":1000,"default":20,"description":"Maximum results to return (1–1000)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/govinfo-search":{"post":{"operationId":"government__govinfo-search","summary":"GovInfo Search","description":"Search across all U.S. Government Publishing Office (GPO) GovInfo collections (USCODE, CFR, PLAW, FR, USCOURTS, CREC, BILLS, etc.). Returns packageId / granuleId references plus basic metadata; use govinfo-package, govinfo-granule, or govinfo-content for the underlying documents.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":20,"offsetMark":"*","historical":true},"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":500,"description":"Search term — GovInfo supports field filters like 'collection:(USCOURTS)', 'publishdate:range(2024-01-01,2024-12-31)', 'title:\"fiduciary\"'"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":100,"default":20,"description":"Maximum results to return (1–100)"},"offsetMark":{"type":"string","default":"*","description":"Pagination token from the previous response's `offsetMark`. Start with '*' for the first page."},"historical":{"type":"boolean","default":true,"description":"Include historical documents in results (default: true)"},"collection":{"type":"string","description":"Restrict to a single collection code (e.g. USCOURTS, PLAW, FR, CFR, USCODE, BILLS, CREC). Equivalent to adding 'collection:(CODE)' to the query."},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/govinfo-package":{"post":{"operationId":"government__govinfo-package","summary":"GovInfo Package Summary","description":"Fetch the full metadata summary for a single GovInfo package (court opinion, public law, bill, Federal Register issue, etc.) by packageId. Returns title, dates, collection, and download links for htm/xml/mods/pdf/txt formats.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"packageId":{"type":"string","minLength":1,"maxLength":200,"description":"GovInfo package identifier (e.g. 'BILLS-117hr3684enr', 'PLAW-117publ58', 'USCOURTS-ca9-23-12345'). Get these from govinfo-search results."},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["packageId"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/govinfo-granule":{"post":{"operationId":"government__govinfo-granule","summary":"GovInfo Granule Summary","description":"Fetch the metadata summary for a single granule (a sub-document within a GovInfo package — e.g. a CFR section, a Federal Register notice, an individual floor statement in the Congressional Record). Returns title, dates, and download links.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"packageId":{"type":"string","minLength":1,"maxLength":200,"description":"Parent GovInfo package identifier"},"granuleId":{"type":"string","minLength":1,"maxLength":200,"description":"Granule identifier within the package (from govinfo-search or the package's granules listing)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["packageId","granuleId"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/govinfo-content":{"post":{"operationId":"government__govinfo-content","summary":"GovInfo Document Content","description":"Fetch the actual text content of a GovInfo package or granule (court opinion, public law, Federal Register notice, CFR section, etc.) in HTML, XML, MODS, or PREMIS format. For PDFs use the pdfLink from govinfo-package.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"format":"htm"},"schema":{"type":"object","properties":{"packageId":{"type":"string","minLength":1,"maxLength":200,"description":"GovInfo package identifier"},"granuleId":{"type":"string","minLength":1,"maxLength":200,"description":"Optional granule identifier — fetch a sub-document instead of the full package"},"format":{"type":"string","enum":["htm","xml","mods","premis"],"default":"htm","description":"Content format: htm (HTML body — best for reading), xml (USLM/MODS XML), mods (MODS metadata XML), premis (preservation metadata XML). PDF is not supported here — use the pdfLink from govinfo-package."},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["packageId"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/fec-candidates":{"post":{"operationId":"government__fec-candidates","summary":"FEC Candidates","description":"Search for U.S. federal election candidates from the Federal Election Commission (FEC) API.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"office":"P","cycle":1,"page":1,"limit":20},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query for candidate name"},"office":{"type":"string","enum":["P","S","H"],"description":"Filter by office: P (President), S (Senate), H (House)"},"cycle":{"type":"integer","description":"Election cycle year (e.g. 2024)"},"page":{"type":"integer","minimum":1,"default":1,"description":"Page number for pagination"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Results per page (max 100)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/datagov":{"post":{"operationId":"government__datagov","summary":"Data.gov Dataset Search","description":"Search the U.S. federal data catalog on Data.gov for open government datasets.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query for datasets"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":1000,"default":10,"description":"Maximum results to return (1–1000)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/federal-register":{"post":{"operationId":"government__federal-register","summary":"Federal Register Documents","description":"Search the U.S. Federal Register for rules, proposed rules, notices, and presidential documents. Supports date range filtering for historical regulatory data.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"docType":"RULE","page":1,"perPage":20},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search term for documents (e.g. 'OSHA', 'climate')"},"fromDate":{"type":"string","description":"Start date (YYYY-MM-DD) — publication date filter"},"toDate":{"type":"string","description":"End date (YYYY-MM-DD) — publication date filter"},"docType":{"type":"string","enum":["RULE","PRORULE","NOTICE","PRESDOCU"],"description":"Document type: RULE, PRORULE (proposed rule), NOTICE, PRESDOCU (presidential)"},"page":{"type":"integer","minimum":1,"default":1,"description":"Page number for pagination"},"perPage":{"type":"integer","minimum":1,"maximum":1000,"default":20,"description":"Results per page (max 1000)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/data-ireland":{"post":{"operationId":"government__data-ireland","summary":"Ireland Open Data","description":"Search the Irish government open data portal for public datasets.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query for datasets"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":1000,"default":10,"description":"Maximum results to return (1–1000)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/datos-spain":{"post":{"operationId":"government__datos-spain","summary":"Spain Open Data","description":"Search the Spanish government open data portal (datos.gob.es) for public datasets.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query for datasets"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":1000,"default":10,"description":"Maximum results to return (1–1000)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/podatki-slovenia":{"post":{"operationId":"government__podatki-slovenia","summary":"Slovenia Open Data","description":"Search the Slovenian government open data portal (podatki.gov.si) for public datasets.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query for datasets"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":1000,"default":10,"description":"Maximum results to return (1–1000)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/data-queensland":{"post":{"operationId":"government__data-queensland","summary":"Queensland Open Data","description":"Search the Queensland (Australia) government open data portal for public datasets.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query for datasets"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":1000,"default":10,"description":"Maximum results to return (1–1000)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/data-istanbul":{"post":{"operationId":"government__data-istanbul","summary":"Istanbul Open Data","description":"Search the Istanbul Metropolitan Municipality (IBB) open data portal for public datasets.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query for datasets"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":1000,"default":10,"description":"Maximum results to return (1–1000)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/data-gdansk":{"post":{"operationId":"government__data-gdansk","summary":"Gdansk Open Data","description":"Search the Gdansk (Poland) open data portal for public datasets.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query for datasets"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":1000,"default":10,"description":"Maximum results to return (1–1000)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/data-lviv":{"post":{"operationId":"government__data-lviv","summary":"Lviv Open Data","description":"Search the Lviv (Ukraine) city open data portal for public datasets.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query for datasets"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":1000,"default":10,"description":"Maximum results to return (1–1000)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/receita-ws":{"post":{"operationId":"government__receita-ws","summary":"ReceitaWS CNPJ Lookup","description":"Look up Brazilian company information by CNPJ number using the ReceitaWS API.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cnpj":{"type":"string","description":"Brazilian CNPJ number (digits only, e.g. 06990590000123)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["cnpj"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/camara-brazil":{"post":{"operationId":"government__camara-brazil","summary":"Brazilian Chamber of Deputies","description":"Search for members of the Brazilian Chamber of Deputies (Camara dos Deputados).","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":20},"schema":{"type":"object","properties":{"name":{"type":"string","description":"Filter by deputy name"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":1000,"default":20,"description":"Maximum results to return (1–1000)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/tenders-guru":{"post":{"operationId":"government__tenders-guru","summary":"Tenders.guru Public Procurement","description":"Search public procurement tenders from Tenders.guru. Supports multiple countries.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":20},"schema":{"type":"object","properties":{"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":1000,"default":20,"description":"Maximum results to return (1–1000)"},"country":{"allOf":[{"type":"string","default":"ES"},{"type":"string","minLength":2,"maxLength":2,"pattern":"^[A-Z]{2}$"}],"description":"ISO 3166-1 alpha-2 country code (e.g. US, DE, JP, BR, GB)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/uk-police":{"post":{"operationId":"government__uk-police","summary":"UK Police Street Crimes","description":"Query street-level crime data from the UK Police API by location and date.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"lat":51.5074,"lng":-0.1278},"schema":{"type":"object","properties":{"lat":{"type":"number","default":51.5074,"description":"Latitude (default: London)"},"lng":{"type":"number","default":-0.1278,"description":"Longitude (default: London)"},"date":{"type":"string","description":"Month in YYYY-MM format"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/regulations-gov":{"post":{"operationId":"government__regulations-gov","summary":"Regulations.gov Public Comments & Dockets","description":"Search Regulations.gov for federal regulatory documents including rules, proposed rules, notices, and public submissions.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search term for regulatory documents"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":1000,"default":10,"description":"Maximum results to return (1–1000)"},"documentType":{"type":"string","description":"Filter by document type: Rule, Proposed Rule, Notice, or Public Submission"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/analytics-usa-gov":{"post":{"operationId":"government__analytics-usa-gov","summary":"Analytics.usa.gov Federal Website Analytics","description":"Access federal website analytics data from the Digital Analytics Program (DAP) including visits, pageviews, and users.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"report":"site","limit":10},"schema":{"type":"object","properties":{"report":{"type":"string","default":"site","description":"Report type: site, domain, download, or second-level-domain"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":1000,"default":10,"description":"Maximum results to return (1–1000)"},"after":{"type":"string","description":"Filter results after this date (YYYY-MM-DD)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/site-scanning":{"post":{"operationId":"government__site-scanning","summary":"GSA Site Scanning","description":"Access GSA Site Scanning data for federal website health checks including DAP analytics, USWDS adoption, and mobile readiness.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":1000,"default":10,"description":"Maximum results to return (1–1000)"},"target_url":{"type":"string","description":"Filter by target URL domain"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/datagov-dataset":{"post":{"operationId":"government__datagov-dataset","summary":"Data.gov Dataset","description":"Download and serve any validated Data.gov dataset as structured JSON. Use the datagov action to search for datasets and get their IDs first.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dataset_id":{"type":"string","description":"Data.gov dataset ID (CKAN package UUID) from catalog search"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["dataset_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/data-france":{"post":{"operationId":"government__data-france","summary":"French Open Data Portal","description":"Search the French government open data portal (data.gouv.fr). Over 45,000 datasets from French national and local government agencies, covering demographics, transport, environment, health, and more.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"organization":{"type":"string","description":"Filter by organization slug"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Max results"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/data-germany":{"post":{"operationId":"government__data-germany","summary":"German Open Data Portal","description":"Search the German government open data portal (GovData). Datasets from federal, state, and municipal authorities covering statistics, geospatial data, environment, transport, and public services.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"groups":{"type":"string","description":"Category filter (e.g. transport, health, environment)"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Max results"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/data-netherlands":{"post":{"operationId":"government__data-netherlands","summary":"Netherlands Open Data Portal","description":"Search the Dutch government open data portal (data.overheid.nl). Datasets from national and local Dutch government agencies covering demographics, environment, geospatial data, and public services.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Max results"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/data-italy":{"post":{"operationId":"government__data-italy","summary":"Italian Open Data Portal","description":"Search the Italian government open data portal (dati.gov.it). Datasets from Italian national and regional agencies covering economy, environment, society, transport, and culture.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Max results"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/data-finland":{"post":{"operationId":"government__data-finland","summary":"Finnish Open Data Portal","description":"Search the Finnish open data portal (avoindata.fi). Datasets from Finnish national and municipal authorities covering statistics, geospatial data, environment, transport, and education.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Max results"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/data-poland":{"post":{"operationId":"government__data-poland","summary":"Polish Open Data Portal","description":"Search the Polish open data portal (dane.gov.pl). Datasets from Polish national and regional agencies covering public finance, demographics, education, health, and environment.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Max results"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/data-portugal":{"post":{"operationId":"government__data-portugal","summary":"Portuguese Open Data Portal","description":"Search the Portuguese open data portal (dados.gov.pt). Datasets from Portuguese national and local government agencies covering economy, health, education, transport, and environment.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Max results"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/data-uk":{"post":{"operationId":"government__data-uk","summary":"UK Open Data Portal","description":"Search the UK government open data portal (data.gov.uk). Over 50,000 datasets from UK central and local government covering transport, health, education, environment, crime, economy, and public spending.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"publisher":{"type":"string","description":"Filter by publisher (e.g. department-for-transport)"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Max results"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/data-canada":{"post":{"operationId":"government__data-canada","summary":"Canadian Open Data Portal","description":"Search the Canadian government open data portal (open.canada.ca). Over 90,000 datasets from federal departments covering economics, health, environment, transport, demographics, and natural resources.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"organization":{"type":"string","description":"Filter by organization (e.g. statcan, nrcan, hc-sc)"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Max results"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/data-australia":{"post":{"operationId":"government__data-australia","summary":"Australian Open Data Portal","description":"Search the Australian government open data portal (data.gov.au). Over 100,000 datasets from federal, state, and local government agencies covering health, education, environment, economy, transport, and geospatial data.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"organization":{"type":"string","description":"Filter by organization"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Max results"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/state-travel-advisories":{"post":{"operationId":"government__state-travel-advisories","summary":"State Department Travel Advisories","description":"Current travel advisories from the U.S. Department of State. Returns advisory level (1-4), country, and description. Levels: 1=Exercise Normal Precautions, 2=Exercise Increased Caution, 3=Reconsider Travel, 4=Do Not Travel.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":50},"schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":300,"default":50,"description":"Max advisories to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/government/actions/usajobs":{"post":{"operationId":"government__usajobs","summary":"USAJobs Federal Job Listings","description":"Search current federal government job openings from USAJobs.gov. Filter by keyword, location, salary, and agency.","tags":["government"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":25},"schema":{"type":"object","properties":{"keyword":{"type":"string","description":"Search keyword (e.g. 'software engineer', 'data scientist', 'cybersecurity')"},"locationName":{"type":"string","description":"Location (e.g. 'Washington, DC', 'Remote')"},"payGradeFrom":{"type":"string","description":"Min pay grade (e.g. 'GS-12')"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Max results"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["keyword"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/crime/actions/fbi-most-wanted":{"post":{"operationId":"crime__fbi-most-wanted","summary":"FBI Most Wanted","description":"Retrieve the FBI Most Wanted list with fugitive details, images, and reward information.","tags":["crime"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"page":1,"limit":20},"schema":{"type":"object","properties":{"page":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":1000,"default":1,"description":"Maximum results to return (1–1000)"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":1000,"default":20,"description":"Maximum results to return (1–1000)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/crime/actions/courtlistener":{"post":{"operationId":"crime__courtlistener","summary":"CourtListener Opinions","description":"Search U.S. court opinions from CourtListener (Free Law Project). Access federal and state court decisions.","tags":["crime"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":20},"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":500,"description":"Search query text"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":1000,"default":20,"description":"Maximum results to return (1–1000)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/crime/actions/recap-search":{"post":{"operationId":"crime__recap-search","summary":"RECAP Docket Search","description":"Full-text search across the RECAP Archive (federal court dockets mirrored from PACER by Free Law Project). Filter by court, filing date range, party name, or nature of suit. Returns matching docket entries with their parent docket id and a teaser snippet — feed the docket_id into recap-docket for the full sheet.","tags":["crime"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":20},"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":500,"description":"Full-text search over RECAP docket entries (motion text, entry descriptions, case names). Supports CL's Solr syntax — e.g. 'description:\"motion to dismiss\"' or 'caseName:\"Smith v\"'."},"court":{"type":"string","description":"CourtListener court code to restrict results (e.g. 'scotus', 'ca9', 'cand', 'dcd', 'nysd', 'txsb'). Omit for all federal courts."},"filedAfter":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Only include entries filed on or after this date (YYYY-MM-DD)"},"filedBefore":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Only include entries filed on or before this date (YYYY-MM-DD)"},"partyName":{"type":"string","description":"Restrict to dockets where this party name appears (case-insensitive substring match)."},"natureOfSuit":{"type":"string","description":"Nature-of-suit code or description (e.g. '830' for patent, '440' for civil rights). See https://www.pacer.gov/documents/natsuit.pdf"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":100,"default":20,"description":"Maximum results to return (1–100)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/crime/actions/recap-docket":{"post":{"operationId":"crime__recap-docket","summary":"RECAP Docket Sheet","description":"Fetch a single federal docket from the RECAP Archive by CourtListener docket id, or by court code + docket number (e.g. 'caDC' + '21-5166'). Returns the full docket sheet: parties, judges, cause of action, nature of suit, fees, jurisdictional basis, and a chronological filing list with entry numbers and descriptions.","tags":["crime"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"docket_id":0},"schema":{"type":"object","properties":{"docket_id":{"type":"integer","exclusiveMinimum":true,"minimum":0,"description":"CourtListener docket id (integer). Get this from recap-search results. Use this OR (court + docket_number)."},"court":{"type":"string","description":"CourtListener court code — e.g. 'scotus', 'ca9' (9th Cir), 'cand' (N.D. Cal.), 'dcd' (D.D.C.), 'nysd' (S.D.N.Y.), 'txsb' (Bankr. S.D. Tex.). Required if docket_id is not provided."},"docket_number":{"type":"string","description":"Full docket number as the court uses it (e.g. '1:21-cv-02769', '21-5166', '22-1234'). Required if docket_id is not provided."},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/crime/actions/recap-document":{"post":{"operationId":"crime__recap-document","summary":"RECAP Document","description":"Fetch a single filing (motion, order, brief, exhibit) from RECAP by its CourtListener document id. Returns document metadata (entry number, page count, filed date, description), the plain-text extraction CL has on file when available, and a download URL for the PDF.","tags":["crime"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"document_id":0,"include_text":true},"schema":{"type":"object","properties":{"document_id":{"type":"integer","exclusiveMinimum":true,"minimum":0,"description":"CourtListener recap-document id (integer). Get this from recap-search results or from the docket_entries of a recap-docket response."},"include_text":{"type":"boolean","default":true,"description":"Include the plain-text extraction in the response. Set false to return metadata only — extracted text can be tens of KB per document."},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["document_id"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/crime/actions/recap-party-search":{"post":{"operationId":"crime__recap-party-search","summary":"RECAP Party Search","description":"Search RECAP for federal dockets where a named party appears — adverse-party checks, conflict-of-interest review, tracking a litigant across jurisdictions. Returns one hit per docket (not per filing) with case name, court, docket number, date filed, and the party's role when available.","tags":["crime"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":20},"schema":{"type":"object","properties":{"party_name":{"type":"string","minLength":2,"maxLength":200,"description":"Party name to search for (individual or organization). Case-insensitive substring match against the PACER party list — e.g. 'Acme Corp', 'Monsanto', 'John Smith'."},"court":{"type":"string","description":"Optional CourtListener court code to restrict the search (e.g. 'ca9', 'dcd', 'nysd'). Omit to search all federal courts."},"date_filed_after":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Only include dockets filed on or after this date (YYYY-MM-DD)."},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":100,"default":20,"description":"Maximum results to return (1–100)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["party_name"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/security/actions/cisa-kev":{"post":{"operationId":"security__cisa-kev","summary":"CISA Known Exploited Vulnerabilities","description":"Retrieve the CISA Known Exploited Vulnerabilities (KEV) catalog. Returns the full list of actively exploited vulnerabilities.","tags":["security"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/security/actions/nvd":{"post":{"operationId":"security__nvd","summary":"NVD CVE Search","description":"Search the NIST National Vulnerability Database (NVD) for CVEs by keyword.","tags":["security"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"keyword":{"type":"string","description":"Keyword to search for in CVE descriptions"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":1000,"default":10,"description":"Maximum results to return (1–1000)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/security/actions/ioda":{"post":{"operationId":"security__ioda","summary":"IODA Internet Outages","description":"Query Internet Outage Detection and Analysis (IODA) for internet connectivity signals by country, region, or ASN.","tags":["security"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"entityType":"country","entityCode":"US","from":"-1h","until":"now"},"schema":{"type":"object","properties":{"entityType":{"type":"string","enum":["country","region","asn"],"default":"country","description":"Entity type to query"},"entityCode":{"type":"string","default":"US","description":"Entity code (e.g. US, CN, or ASN number)"},"from":{"type":"string","default":"-1h","description":"Start time (e.g. -1h, -24h, or Unix timestamp)"},"until":{"type":"string","default":"now","description":"End time (e.g. now or Unix timestamp)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/security/actions/ripe-ris":{"post":{"operationId":"security__ripe-ris","summary":"RIPE RIS Peers","description":"Get the current list of RIPE Routing Information Service (RIS) BGP peers and their status.","tags":["security"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/security/actions/rsf-index":{"post":{"operationId":"security__rsf-index","summary":"World Governance Indicators (WGI)","description":"Query World Bank Worldwide Governance Indicators including Voice & Accountability, Political Stability, Government Effectiveness, Regulatory Quality, Rule of Law, and Control of Corruption.","tags":["security"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"indicator":"VA.EST","year":2025,"page":1,"limit":20},"schema":{"type":"object","properties":{"indicator":{"type":"string","enum":["VA.EST","PV.EST","GE.EST","RQ.EST","RL.EST","CC.EST"],"default":"VA.EST","description":"WGI indicator code: VA.EST (Voice & Accountability), PV.EST (Political Stability), GE.EST (Gov Effectiveness), RQ.EST (Regulatory Quality), RL.EST (Rule of Law), CC.EST (Control of Corruption)"},"year":{"type":"integer","default":2025,"description":"Data year (WGI data typically lags ~1 year)"},"page":{"type":"integer","minimum":1,"default":1,"description":"Page number for pagination"},"limit":{"type":"integer","minimum":1,"maximum":500,"default":20,"description":"Number of country records to return per page"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/military/actions/sipri-expenditure":{"post":{"operationId":"military__sipri-expenditure","summary":"SIPRI Military Expenditure","description":"Query SIPRI Military Expenditure Database for global defense spending data by country and year range. Data sourced via World Bank (SIPRI indicator MS.MIL.XPND.CD). Annual data available from 1960 to present.","tags":["military"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"country":"USA","from":2010,"to":2024},"schema":{"type":"object","properties":{"country":{"anyOf":[{"allOf":[{"type":"string"},{"type":"string","minLength":3,"maxLength":3,"pattern":"^[A-Z]{3}$"}],"description":"ISO 3166-1 alpha-3 country code (e.g. USA, GBR, CHN, DEU, JPN)"},{"type":"string","enum":["all"]}],"default":"USA","description":"ISO3 country code (e.g. USA, GBR, CHN) or 'all' for all countries"},"from":{"type":"integer","minimum":1960,"maximum":2026,"default":2010,"description":"Start year (data from 1960)"},"to":{"type":"integer","minimum":1960,"maximum":2026,"default":2024,"description":"End year (SIPRI data lags ~2 years)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/military/actions/sipri-transfers":{"post":{"operationId":"military__sipri-transfers","summary":"SIPRI Military Expenditure by Country","description":"Country-level military expenditure data from the SIPRI Military Expenditure Database. Query by country and year range. Returns both current USD and % of GDP. Data sourced via World Bank.","tags":["military"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"from":2010,"to":2024},"schema":{"type":"object","properties":{"country":{"allOf":[{"type":"string","default":"USA"},{"type":"string","minLength":3,"maxLength":3,"pattern":"^[A-Z]{3}$"}],"description":"ISO 3166-1 alpha-3 country code (e.g. USA, GBR, CHN, DEU, JPN)"},"from":{"type":"integer","minimum":1960,"maximum":2026,"default":2010,"description":"Start year (data from 1960)"},"to":{"type":"integer","minimum":1960,"maximum":2026,"default":2024,"description":"End year (SIPRI data lags ~2 years)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/military/actions/sipri-companies":{"post":{"operationId":"military__sipri-companies","summary":"SIPRI Top Military Spenders","description":"Top military spending countries ranked by defense expenditure from the SIPRI Military Expenditure Database. Data sourced via World Bank.","tags":["military"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"year":2024,"limit":15},"schema":{"type":"object","properties":{"year":{"type":"integer","minimum":1960,"maximum":2026,"default":2024,"description":"Year for military spending data (1960-present, lags ~2 years)"},"limit":{"type":"number","default":15,"description":"Number of top spenders to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/immigration/actions/eurostat-migration":{"post":{"operationId":"immigration__eurostat-migration","summary":"Eurostat Migration Statistics","description":"Query immigration statistics from Eurostat. Returns data on immigration by age and sex for EU member states.","tags":["immigration"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"geo":"EU27_2020","year":"2024"},"schema":{"type":"object","properties":{"geo":{"type":"string","default":"EU27_2020","description":"Geographic area code (e.g. EU27_2020, DE, FR, IT)"},"year":{"type":"string","default":"2024","description":"Reference year (Eurostat migration data lags ~2 years)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/science/actions/openalex":{"post":{"operationId":"science__openalex","summary":"OpenAlex Works Search","description":"Search the OpenAlex catalog of scholarly works — papers, articles, and preprints — by keyword.","tags":["science"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query for scholarly works"},"limit":{"type":"integer","minimum":1,"maximum":200,"default":10,"description":"Number of results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/science/actions/crossref":{"post":{"operationId":"science__crossref","summary":"Crossref Works Search","description":"Search Crossref for scholarly works by keyword. Returns DOIs, titles, authors, and citation counts.","tags":["science"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":500,"description":"Search query text"},"limit":{"type":"integer","minimum":1,"maximum":1000,"default":10,"description":"Number of results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/science/actions/arxiv":{"post":{"operationId":"science__arxiv","summary":"arXiv Preprint Search","description":"Search the arXiv preprint server for scientific papers. Returns titles, authors, abstracts, and arXiv IDs.","tags":["science"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":500,"description":"Search query text"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Number of results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/science/actions/semantic-scholar":{"post":{"operationId":"science__semantic-scholar","summary":"Semantic Scholar Paper Search","description":"Search Semantic Scholar for academic papers. Returns titles, abstracts, citation counts, and links.","tags":["science"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query for papers"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Number of results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/science/actions/pubmed":{"post":{"operationId":"science__pubmed","summary":"PubMed Search","description":"Search PubMed for biomedical literature. Returns PubMed IDs matching the query.","tags":["science"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query for biomedical literature"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Number of results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/science/actions/share-osf":{"post":{"operationId":"science__share-osf","summary":"SHARE / OSF Search","description":"Search the SHARE database (hosted by OSF) for research outputs including papers, datasets, and preprints.","tags":["science"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"query":"climate change","limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","default":"climate change","description":"Search query to filter creative works"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Number of results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/science/actions/idigbio":{"post":{"operationId":"science__idigbio","summary":"iDigBio Specimen Search","description":"Search the iDigBio biodiversity specimen database by scientific name. Returns digitized natural history collection records.","tags":["science"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Scientific name to search for"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Number of records to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/science/actions/inspire-hep":{"post":{"operationId":"science__inspire-hep","summary":"INSPIRE-HEP Literature Search","description":"Search INSPIRE-HEP for high-energy physics literature. Returns papers sorted by most recent.","tags":["science"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query for HEP literature"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Number of results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/science/actions/isro":{"post":{"operationId":"science__isro","summary":"ISRO Spacecrafts","description":"List spacecrafts launched by the Indian Space Research Organisation (ISRO).","tags":["science"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/science/actions/nasa-images":{"post":{"operationId":"science__nasa-images","summary":"NASA Image & Video Library","description":"Search NASA's image, video, and audio library by keyword.","tags":["science"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"mediaType":"image","limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"mediaType":{"type":"string","enum":["image","video","audio"],"default":"image","description":"Type of media to search for"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Number of results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/science/actions/nobel-prize":{"post":{"operationId":"science__nobel-prize","summary":"Nobel Prize Data","description":"Query Nobel Prize data by year and category. Returns laureates and prize details.","tags":["science"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10,"year":1},"schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Number of results to return"},"year":{"type":"integer","description":"Filter by year (e.g., 2023)"},"category":{"type":"string","description":"Filter by category (e.g., phy, che, med, lit, pea, eco)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/science/actions/sunrise-sunset":{"post":{"operationId":"science__sunrise-sunset","summary":"Sunrise & Sunset Times","description":"Get sunrise, sunset, and twilight times for a given latitude/longitude and date.","tags":["science"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"lat":-90,"lng":-180,"date":"today"},"schema":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude"},"lng":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude"},"date":{"type":"string","default":"today","description":"Date in YYYY-MM-DD format, or 'today'"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["lat","lng"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/science/actions/datamuse":{"post":{"operationId":"science__datamuse","summary":"Datamuse Word Search","description":"Find words using the Datamuse API — search by meaning, sound, spelling, or rhyme.","tags":["science"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"type":"ml","limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Word or phrase to query"},"type":{"type":"string","enum":["ml","sl","sp","rel_rhy"],"default":"ml","description":"Search type: ml=meaning like, sl=sounds like, sp=spelled like, rel_rhy=rhymes with"},"limit":{"type":"integer","minimum":1,"maximum":1000,"default":10,"description":"Number of results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/science/actions/nsf-awards":{"post":{"operationId":"science__nsf-awards","summary":"NSF Research Awards","description":"Search National Science Foundation research grants — titles, abstracts, funding amounts, awardees, and program names.","tags":["science"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":25},"schema":{"type":"object","properties":{"keyword":{"type":"string","description":"Search keyword (e.g. 'artificial intelligence', 'climate change')"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":25,"description":"Max results"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["keyword"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/science/actions/osti-research":{"post":{"operationId":"science__osti-research","summary":"DOE OSTI Research Publications","description":"Search U.S. Department of Energy research publications from OSTI.gov — journal articles, technical reports, conference papers, and dissertations.","tags":["science"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":20},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query (e.g. 'solar energy', 'nuclear fusion')"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Max results"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/environment/actions/openaq":{"post":{"operationId":"environment__openaq","summary":"OpenAQ Air Quality Locations","description":"Search for air quality monitoring locations from the OpenAQ platform, optionally filtered by coordinates and radius.","tags":["environment"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"lat":1,"lng":1,"limit":10,"radius":25000},"schema":{"type":"object","properties":{"lat":{"type":"number","description":"Latitude for location-based search"},"lng":{"type":"number","description":"Longitude for location-based search"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Number of results to return"},"radius":{"type":"integer","default":25000,"description":"Search radius in meters"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/environment/actions/waqi":{"post":{"operationId":"environment__waqi","summary":"World Air Quality Index","description":"Get real-time Air Quality Index (AQI) data for a city from the WAQI project.","tags":["environment"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"city":"beijing"},"schema":{"type":"object","properties":{"city":{"type":"string","default":"beijing","description":"City name or station identifier"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/environment/actions/epa-aqs":{"post":{"operationId":"environment__epa-aqs","summary":"EPA AQS State List","description":"List all US states available in the EPA Air Quality System (AQS).","tags":["environment"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/environment/actions/epa-echo":{"post":{"operationId":"environment__epa-echo","summary":"EPA ECHO Facilities","description":"Search EPA ECHO for environmental compliance and enforcement facilities by state and city.","tags":["environment"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"state":"NY","limit":10},"schema":{"type":"object","properties":{"state":{"type":"string","enum":["AL","AK","AZ","AR","CA","CO","CT","DE","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY","DC","AS","GU","MP","PR","VI"],"description":"U.S. state/territory code (e.g. CA, TX, NY, FL, IL)","default":"NY"},"city":{"type":"string","description":"City name filter"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Number of results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/environment/actions/noaa-coops":{"post":{"operationId":"environment__noaa-coops","summary":"NOAA CO-OPS Tides & Currents","description":"Get latest tidal, water level, temperature, and wind data from a NOAA CO-OPS station.","tags":["environment"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"station":"8454000","product":"water_level"},"schema":{"type":"object","properties":{"station":{"type":"string","default":"8454000","description":"NOAA station ID (e.g., 8454000 for Providence, RI)"},"product":{"type":"string","enum":["water_level","air_temperature","wind","predictions"],"default":"water_level","description":"Data product to retrieve"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/environment/actions/openmeteo-aq":{"post":{"operationId":"environment__openmeteo-aq","summary":"Open-Meteo Air Quality","description":"Get current air quality data (PM10, PM2.5, CO, NO2, O3) for a given location from Open-Meteo.","tags":["environment"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"latitude":-90,"longitude":-180},"schema":{"type":"object","properties":{"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude"},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["latitude","longitude"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/environment/actions/climate-trace":{"post":{"operationId":"environment__climate-trace","summary":"Climate TRACE Emissions","description":"Get country-level greenhouse gas emissions data from Climate TRACE.","tags":["environment"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"since":2022,"to":2024},"schema":{"type":"object","properties":{"country":{"allOf":[{"type":"string"},{"type":"string","minLength":3,"maxLength":3,"pattern":"^[A-Z]{3}$"}],"description":"ISO 3166-1 alpha-3 country code (e.g. USA, GBR, CHN, DEU, JPN)"},"since":{"type":"integer","default":2022,"description":"Start year for emissions data"},"to":{"type":"integer","default":2024,"description":"End year for emissions data (Climate TRACE data lags ~1 year)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/environment/actions/climate-trace-assets":{"post":{"operationId":"environment__climate-trace-assets","summary":"Climate TRACE Asset-Level Emissions","description":"Get asset-level (facility/power plant) greenhouse gas emissions data from Climate TRACE.","tags":["environment"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"sector":"electricity-generation","year":2025,"limit":100},"schema":{"type":"object","properties":{"country":{"allOf":[{"type":"string","default":"USA"},{"type":"string","minLength":3,"maxLength":3,"pattern":"^[A-Z]{3}$"}],"description":"ISO 3166-1 alpha-3 country code (e.g. USA, GBR, CHN, DEU, JPN)"},"sector":{"type":"string","enum":["electricity-generation","cement","steel","aluminum","petrochemicals","pulp-and-paper","oil-and-gas-production","oil-and-gas-refining","coal-mining","other-mining","aviation","shipping","road-transportation","railways","buildings","agriculture","waste","forest-land"],"default":"electricity-generation","description":"Sector to get assets for"},"year":{"type":"integer","default":2025,"description":"Year for emissions data (Climate TRACE data lags ~1 year)"},"limit":{"type":"integer","minimum":1,"maximum":500,"default":100,"description":"Maximum number of results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/environment/actions/climate-trace-sectors":{"post":{"operationId":"environment__climate-trace-sectors","summary":"Climate TRACE Sector-Level Emissions","description":"Get sector-level greenhouse gas emissions data from Climate TRACE, broken down by industry sectors.","tags":["environment"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"country":"USA","since":2022,"to":2024,"sector":"mineral-extraction"},"schema":{"type":"object","properties":{"country":{"type":"string","default":"USA","description":"3-letter ISO country code (e.g. USA, CHN, GBR)"},"since":{"type":"integer","default":2022,"description":"Start year for emissions data"},"to":{"type":"integer","default":2024,"description":"End year for emissions data (Climate TRACE data lags ~1 year)"},"sector":{"type":"string","enum":["mineral-extraction","waste","transportation","buildings","manufacturing","fossil-fuel-operations","agriculture","power","fluorinated-gases","forestry-and-land-use"],"description":"Sector to filter. Omit for all sectors."},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/environment/actions/copernicus":{"post":{"operationId":"environment__copernicus","summary":"Copernicus Climate Data Store Collections","description":"List available dataset collections from the Copernicus Climate Data Store (CDS). Returns collection metadata including temporal and spatial extent.","tags":["environment"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":100,"default":10,"description":"Maximum results to return (1–100)"},"query":{"type":"string","description":"Optional search term to filter collections by title or description"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/environment/actions/opensensemap":{"post":{"operationId":"environment__opensensemap","summary":"openSenseMap Sensor Boxes","description":"Search for environmental sensor stations (senseBoxes) from the openSenseMap platform, optionally filtered by location.","tags":["environment"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10,"lat":1,"lng":1,"radius":1},"schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Number of boxes to return"},"lat":{"type":"number","description":"Latitude for nearby search"},"lng":{"type":"number","description":"Longitude for nearby search"},"radius":{"type":"number","description":"Search radius in meters for nearby search"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/environment/actions/carbon-intensity":{"post":{"operationId":"environment__carbon-intensity","summary":"UK Carbon Intensity","description":"Get the current carbon intensity of UK electricity generation from the National Grid ESO.","tags":["environment"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/environment/actions/epa-envirofacts":{"post":{"operationId":"environment__epa-envirofacts","summary":"EPA Envirofacts","description":"Search EPA's Envirofacts multi-system database covering TRI facilities, RCRA hazardous waste, drinking water systems, Superfund sites, and air facilities.","tags":["environment"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"table":"tri_facility","state":"AL","limit":10},"schema":{"type":"object","properties":{"table":{"type":"string","default":"tri_facility","description":"Table name: tri_facility, rcra_facility, sdwis_water_system, cerclis_npl, or air_facility"},"zipCode":{"type":"string","description":"Filter by ZIP code"},"state":{"type":"string","enum":["AL","AK","AZ","AR","CA","CO","CT","DE","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY","DC","AS","GU","MP","PR","VI"],"description":"U.S. state/territory code (e.g. CA, TX, NY, FL, IL)"},"limit":{"type":"number","default":10,"description":"Maximum number of rows to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/environment/actions/epa-ghg":{"post":{"operationId":"environment__epa-ghg","summary":"EPA Greenhouse Gas Reporting","description":"Query EPA's Greenhouse Gas Reporting Program data for facility-level direct emissions.","tags":["environment"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"limit":{"type":"number","default":10,"description":"Maximum number of rows to return"},"state":{"type":"string","description":"Filter by two-letter state abbreviation"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/environment/actions/uk-floods":{"post":{"operationId":"environment__uk-floods","summary":"UK Flood Warnings & River Levels","description":"Real-time flood warnings and river/sea level monitoring from the UK Environment Agency. Current flood alerts, warnings, and water level readings from thousands of monitoring stations across England.","tags":["environment"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"type":"warnings","limit":20},"schema":{"type":"object","properties":{"type":{"type":"string","enum":["warnings","stations","levels"],"default":"warnings","description":"Data type: warnings (active flood alerts), stations (monitoring stations), levels (current water levels)"},"county":{"type":"string","description":"Filter by county (for stations/warnings)"},"stationId":{"type":"string","description":"Station reference ID (for levels, e.g. E70839)"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Max results"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/environment/actions/canada-weather":{"post":{"operationId":"environment__canada-weather","summary":"Environment Canada Weather Alerts","description":"Active weather alerts and warnings from Environment and Climate Change Canada via the MSC GeoMet API. Covers all provinces and territories with real-time severe weather warnings, watches, advisories, and special statements.","tags":["environment"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"province":"AB","limit":10},"schema":{"type":"object","properties":{"province":{"type":"string","enum":["AB","BC","MB","NB","NL","NS","NT","NU","ON","PE","QC","SK","YT"],"description":"Province/territory code (e.g. ON, BC, AB, QC)"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Max alerts to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/environment/actions/epa-attains":{"post":{"operationId":"environment__epa-attains","summary":"EPA Water Quality Assessments","description":"Water quality assessment data from EPA ATTAINS — impaired waters, pollutant sources, and cleanup status by state. Tracks which waterways meet Clean Water Act standards.","tags":["environment"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"state":"TX","limit":10},"schema":{"type":"object","properties":{"state":{"type":"string","enum":["AL","AK","AZ","AR","CA","CO","CT","DE","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY","DC","AS","GU","MP","PR","VI"],"description":"U.S. state/territory code (e.g. CA, TX, NY, FL, IL)","default":"TX"},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Max results"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/environment/actions/noaa-cdo":{"post":{"operationId":"environment__noaa-cdo","summary":"NOAA Climate Data Online","description":"Historical weather and climate observations from NOAA CDO — daily temperature, precipitation, snowfall, and wind for any US location. The largest archive of US weather data.","tags":["environment"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"datasetId":"GHCND","limit":100},"schema":{"type":"object","properties":{"datasetId":{"type":"string","enum":["GHCND","GSOM","GSOY"],"default":"GHCND","description":"Dataset: GHCND (daily), GSOM (monthly summary), GSOY (yearly summary)"},"locationId":{"type":"string","pattern":"^(FIPS|CITY|ZIP|COUNTY):[A-Z0-9]+$","description":"NOAA CDO location ID (e.g. FIPS:06 for California, ZIP:10001)"},"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Start date"},"endDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"End date"},"dataTypes":{"type":"array","items":{"type":"string"},"description":"Specific data types (e.g. ['TMAX', 'TMIN', 'PRCP'])"},"limit":{"type":"integer","minimum":1,"maximum":1000,"default":100,"description":"Max records"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["locationId","startDate","endDate"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/health/actions/disease-outbreaks":{"post":{"operationId":"health__disease-outbreaks","summary":"Disease.sh COVID-19 Stats","description":"Get global or country-level COVID-19 statistics from the disease.sh API.","tags":["health"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string","description":"Country name or ISO code; omit for global stats"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/health/actions/fda-recalls":{"post":{"operationId":"health__fda-recalls","summary":"FDA Drug Recalls","description":"Search FDA drug enforcement/recall reports. Returns recall events including classification, status, and product description.","tags":["health"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Number of results to return"},"query":{"type":"string","description":"Search query to filter recalls"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/health/actions/fda-adverse-events":{"post":{"operationId":"health__fda-adverse-events","summary":"FDA Drug Adverse Events","description":"Search FDA drug adverse event reports (FAERS). Returns reported side effects, patient reactions, and drug info.","tags":["health"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Number of results to return"},"query":{"type":"string","description":"Search query to filter events"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/health/actions/fda-devices":{"post":{"operationId":"health__fda-devices","summary":"FDA Device Recalls","description":"Get recent FDA medical device recall reports.","tags":["health"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Number of results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/health/actions/cdc-data":{"post":{"operationId":"health__cdc-data","summary":"CDC Data","description":"COVID-19 case surveillance data from the CDC.","tags":["health"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":20},"schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":1000,"default":20,"description":"Number of rows to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/health/actions/who-gho":{"post":{"operationId":"health__who-gho","summary":"WHO Global Health Observatory","description":"Query the WHO Global Health Observatory (GHO) OData API. List all indicators or fetch data for a specific indicator code.","tags":["health"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"indicator":"Indicator"},"schema":{"type":"object","properties":{"indicator":{"type":"string","default":"Indicator","description":"GHO indicator code (e.g., 'WHOSIS_000001'). Use 'Indicator' to list all available indicators."},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/health/actions/nih-clinical-trials":{"post":{"operationId":"health__nih-clinical-trials","summary":"ClinicalTrials.gov Studies","description":"Search ClinicalTrials.gov for clinical studies by keyword. Returns study titles, status, phases, and conditions.","tags":["health"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search term for clinical studies"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Number of results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/health/actions/usda-food":{"post":{"operationId":"health__usda-food","summary":"USDA FoodData Central","description":"Search the USDA FoodData Central database for nutrition information on foods.","tags":["health"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Food search query (e.g., 'cheddar cheese')"},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Number of results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/health/actions/nppes-npi":{"post":{"operationId":"health__nppes-npi","summary":"NPPES NPI Registry","description":"Search the CMS NPPES NPI Registry for healthcare providers by NPI number, first name, or last name.","tags":["health"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"npi":{"type":"string","description":"NPI number to look up directly"},"firstName":{"type":"string","description":"Provider first name"},"lastName":{"type":"string","description":"Provider last name"},"limit":{"type":"integer","minimum":1,"maximum":200,"default":10,"description":"Number of results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/health/actions/nhs-scotland":{"post":{"operationId":"health__nhs-scotland","summary":"NHS Scotland Open Data","description":"Search the NHS Scotland open data portal for health datasets.","tags":["health"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query for datasets"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Number of results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/health/actions/healthcare-gov":{"post":{"operationId":"health__healthcare-gov","summary":"HealthCare.gov Metadata","description":"List available datasets from the HealthCare.gov open data portal.","tags":["health"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/health/actions/disease-sh-vaccine":{"post":{"operationId":"health__disease-sh-vaccine","summary":"Disease.sh Vaccine Coverage","description":"Get global COVID-19 vaccine coverage data over a number of recent days.","tags":["health"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"days":30},"schema":{"type":"object","properties":{"days":{"type":"integer","minimum":1,"maximum":365,"default":30,"description":"Number of recent days of vaccine coverage data"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/health/actions/nih-reporter":{"post":{"operationId":"health__nih-reporter","summary":"NIH RePORTER Projects","description":"Search the NIH Research Portfolio Online Reporting Tools (RePORTER) for funded research projects by keyword. Returns project numbers, titles, abstracts, organizations, and award amounts.","tags":["health"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10,"fiscal_year":1},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search text for project titles and terms"},"limit":{"type":"integer","minimum":1,"maximum":500,"default":10,"description":"Number of results to return"},"fiscal_year":{"type":"integer","description":"Filter by fiscal year (e.g. 2024)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/health/actions/cdc-wonder":{"post":{"operationId":"health__cdc-wonder","summary":"CDC Leading Causes of Death","description":"Query CDC open data for leading causes of death in the United States by year, cause, and state. Uses the NCHS Leading Causes of Death dataset.","tags":["health"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10,"year":1},"schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":1000,"default":10,"description":"Number of records to return"},"year":{"type":"integer","description":"Filter by year (e.g. 2017)"},"cause":{"type":"string","description":"Filter by cause name (e.g. 'Heart disease')"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/health/actions/nhs-england":{"post":{"operationId":"health__nhs-england","summary":"NHS England Statistics","description":"UK health statistics from NHS England. Hospital performance, waiting times, A&E attendance, GP practice data, prescription data, and workforce numbers.","tags":["health"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"query":"NHS","limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","default":"NHS","description":"Search query for health datasets"},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Max results"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/health/actions/health-canada":{"post":{"operationId":"health__health-canada","summary":"Health Canada Drug Product Database","description":"Look up drugs in Health Canada's Drug Product Database (DPD) by Drug Identification Number (DIN). Returns drug details including brand name, active ingredients, company, dosage form, and approval status.","tags":["health"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"din":"00000019"},"schema":{"type":"object","properties":{"din":{"type":"string","default":"00000019","description":"Drug Identification Number (DIN) — the 8-digit code on Canadian drug packaging"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/health/actions/pubchem-compound":{"post":{"operationId":"health__pubchem-compound","summary":"PubChem Chemical Compound","description":"Look up chemical compound data from NCBI PubChem — molecular formula, weight, IUPAC name, InChI, SMILES, and physical properties. Search by common name or CID.","tags":["health"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Chemical compound name (e.g. 'aspirin', 'caffeine', 'glucose')"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["name"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/health/actions/rxnorm-drugs":{"post":{"operationId":"health__rxnorm-drugs","summary":"RxNorm Drug Lookup","description":"Look up drug information from NLM RxNorm — brand names, generic names, dosage forms, and RxCUI identifiers. The standard for drug naming and normalization in US healthcare.","tags":["health"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Drug name to look up (e.g. 'aspirin', 'metformin', 'lisinopril')"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["name"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/health/actions/cms-provider-data":{"post":{"operationId":"health__cms-provider-data","summary":"CMS Provider Data","description":"Medicare provider data from CMS — hospital quality ratings, nursing home inspections, physician comparisons, and ACO performance. Search the CMS data catalog.","tags":["health"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"dataset":"aco","limit":20,"state":"AL"},"schema":{"type":"object","properties":{"dataset":{"type":"string","enum":["aco","hospital_ratings","nursing_homes"],"default":"aco","description":"Dataset: aco (ACO performance), hospital_ratings, nursing_homes"},"limit":{"type":"integer","minimum":1,"maximum":500,"default":20,"description":"Max results"},"state":{"type":"string","enum":["AL","AK","AZ","AR","CA","CO","CT","DE","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY","DC","AS","GU","MP","PR","VI"],"description":"U.S. state/territory code (e.g. CA, TX, NY, FL, IL)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/space/actions/nasa-asteroids":{"post":{"operationId":"space__nasa-asteroids","summary":"NASA Near-Earth Asteroids","description":"Get near-Earth asteroid (NEO) data from NASA's NeoWs API for a given date range.","tags":["space"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"startDate":{"type":"string","description":"Start date in YYYY-MM-DD format"},"endDate":{"type":"string","description":"End date in YYYY-MM-DD format (max 7 days from start)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["startDate","endDate"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/space/actions/nasa-apod":{"post":{"operationId":"space__nasa-apod","summary":"NASA Astronomy Picture of the Day","description":"Get NASA's Astronomy Picture of the Day (APOD), optionally for a specific date.","tags":["space"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string","description":"Date in YYYY-MM-DD format; omit for today"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/space/actions/nasa-exoplanets":{"post":{"operationId":"space__nasa-exoplanets","summary":"NASA Exoplanet Archive","description":"Query the NASA Exoplanet Archive for confirmed exoplanet data including name, host star, discovery year, mass, and radius.","tags":["space"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":1000,"default":10,"description":"Number of exoplanets to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/space/actions/solar-weather":{"post":{"operationId":"space__solar-weather","summary":"NOAA Solar Weather (Kp Index)","description":"Get the latest planetary K-index (Kp) data from NOAA SWPC, indicating geomagnetic storm activity.","tags":["space"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/space/actions/launch-schedule":{"post":{"operationId":"space__launch-schedule","summary":"Space Launch Schedule","description":"Get upcoming rocket launch schedule from The Space Devs Launch Library 2 API.","tags":["space"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Number of upcoming launches to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/space/actions/space-track":{"post":{"operationId":"space__space-track","summary":"Space-Track Satellite Data","description":"Query Space-Track.org for satellite orbital data (TLE/GP). Search by NORAD ID or object name.","tags":["space"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"noradId":"25544","limit":10},"schema":{"type":"object","properties":{"noradId":{"type":"string","default":"25544","description":"NORAD Catalog ID (default: 25544 for ISS)"},"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":100,"default":10,"description":"Maximum results to return (1–100)"},"searchName":{"type":"string","description":"Search by object name instead of NORAD ID"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/space/actions/iss-tracker":{"post":{"operationId":"space__iss-tracker","summary":"ISS Real-Time Location","description":"Get the current real-time position of the International Space Station (ISS) including latitude, longitude, altitude, and velocity. Data updates every ~5 seconds from wheretheiss.at.","tags":["space"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timestamps":{"type":"array","items":{"type":"integer"},"description":"Optional array of Unix timestamps to get historical ISS positions"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/space/actions/nasa-techport":{"post":{"operationId":"space__nasa-techport","summary":"NASA Technology Portfolio","description":"Search NASA's TechPort database of technology development projects, or list projects updated since a given date.","tags":["space"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"updatedSince":"2026-01-17"},"schema":{"type":"object","properties":{"updatedSince":{"type":"string","default":"2026-01-17","description":"List projects updated since this date (YYYY-MM-DD, defaults to 90 days ago)"},"searchQuery":{"type":"string","description":"Optional keyword search; if provided, uses the search endpoint instead"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/space/actions/nasa-epic":{"post":{"operationId":"space__nasa-epic","summary":"NASA EPIC Earth Images","description":"Retrieve images from NASA's EPIC (Earth Polychromatic Imaging Camera) aboard the DSCOVR satellite for a given date.","tags":["space"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"date":"2026-04-14"},"schema":{"type":"object","properties":{"date":{"type":"string","default":"2026-04-14","description":"Date in YYYY-MM-DD format (defaults to 3 days ago; EPIC imagery has ~2 day lag)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/space/actions/nasa-power":{"post":{"operationId":"space__nasa-power","summary":"NASA POWER Climate Data","description":"Global daily weather and solar energy data from NASA POWER (Prediction Of Worldwide Energy Resources). Temperature, precipitation, humidity, wind, and solar irradiance for any location on Earth.","tags":["space"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"latitude":-90,"longitude":-180,"parameters":["T2M","PRECTOTCORR","RH2M","WS2M"]},"schema":{"type":"object","properties":{"latitude":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude (-90 to 90)"},"longitude":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude (-180 to 180)"},"startDate":{"type":"string","description":"Start date (YYYYMMDD)"},"endDate":{"type":"string","description":"End date (YYYYMMDD)"},"parameters":{"type":"array","items":{"type":"string"},"default":["T2M","PRECTOTCORR","RH2M","WS2M"],"description":"Climate parameters: T2M (temp °C), PRECTOTCORR (precip mm/day), RH2M (humidity %), WS2M (wind m/s), ALLSKY_SFC_SW_DWN (solar irradiance kW-hr/m²/day)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["latitude","longitude","startDate","endDate"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/space/actions/nasa-eonet":{"post":{"operationId":"space__nasa-eonet","summary":"NASA EONET Natural Events","description":"Track natural events worldwide from NASA's Earth Observatory — wildfires, severe storms, volcanoes, icebergs, droughts, and floods. Returns event locations, categories, and sources.","tags":["space"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"category":"wildfires","status":"open","limit":20,"days":1},"schema":{"type":"object","properties":{"category":{"type":"string","enum":["wildfires","severeStorms","volcanoes","seaLakeIce","drought","floods","landslides","dustHaze"],"description":"Filter by event category"},"status":{"type":"string","enum":["open","closed"],"default":"open","description":"Event status: open (ongoing) or closed"},"limit":{"type":"integer","minimum":1,"maximum":500,"default":20,"description":"Max events to return"},"days":{"type":"integer","minimum":1,"maximum":365,"description":"Only events from the last N days"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/space/actions/nasa-close-approaches":{"post":{"operationId":"space__nasa-close-approaches","summary":"NASA Asteroid Close Approaches","description":"Asteroid and comet close approach data from NASA's Center for Near Earth Object Studies (CNEOS). Returns object designation, approach date, distance, velocity, and size estimate.","tags":["space"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"distMax":"0.05","limit":20},"schema":{"type":"object","properties":{"dateMin":{"type":"string","description":"Start date (YYYY-MM-DD). Defaults to today."},"dateMax":{"type":"string","description":"End date (YYYY-MM-DD). Defaults to +60 days."},"distMax":{"type":"string","default":"0.05","description":"Max distance in AU (1 AU ≈ 150M km). Default 0.05 AU."},"limit":{"type":"integer","minimum":1,"maximum":500,"default":20,"description":"Max results"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/energy/actions/eia-data":{"post":{"operationId":"energy__eia-data","summary":"EIA Energy Data","description":"Get energy data from the U.S. Energy Information Administration. Petroleum prices, electricity generation, natural gas, coal, and renewable energy statistics.","tags":["energy"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"route":"petroleum/pri/spt","frequency":"weekly","limit":10},"schema":{"type":"object","properties":{"route":{"type":"string","default":"petroleum/pri/spt","description":"EIA API data route (e.g. petroleum/pri/spt, electricity/retail-sales, natural-gas/pri/sum)"},"frequency":{"type":"string","default":"weekly","description":"Data frequency (e.g. weekly, monthly, annual)"},"limit":{"type":"number","default":10,"description":"Number of records to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/energy/actions/nrel-alt-fuel":{"post":{"operationId":"energy__nrel-alt-fuel","summary":"NREL Alternative Fuel Stations","description":"Find alternative fuel stations (EV charging, LPG, CNG, E85, biodiesel, hydrogen) across the U.S. from the National Renewable Energy Laboratory.","tags":["energy"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"state":"CA","limit":10},"schema":{"type":"object","properties":{"state":{"type":"string","enum":["AL","AK","AZ","AR","CA","CO","CT","DE","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY","DC","AS","GU","MP","PR","VI"],"description":"U.S. state/territory code (e.g. CA, TX, NY, FL, IL)","default":"CA"},"limit":{"type":"number","default":10,"description":"Maximum number of stations to return"},"fuelType":{"type":"string","description":"Fuel type filter: ELEC, LPG, CNG, E85, BD, HY"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/energy/actions/nrel-solar":{"post":{"operationId":"energy__nrel-solar","summary":"NREL Solar Resource","description":"Get solar resource data (GHI, DNI, tilt) for a location from the National Renewable Energy Laboratory. Useful for solar panel feasibility analysis.","tags":["energy"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"lat":-90,"lon":-180},"schema":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude of the location"},"lon":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude of the location"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["lat","lon"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/energy/actions/nrel-utility-rates":{"post":{"operationId":"energy__nrel-utility-rates","summary":"NREL Utility Rates","description":"Get utility rate data for a location from NREL. Returns residential, commercial, and industrial electricity rates by utility company.","tags":["energy"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"lat":-90,"lon":-180},"schema":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude of the location"},"lon":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude of the location"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["lat","lon"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/energy/actions/nrel-pvwatts":{"post":{"operationId":"energy__nrel-pvwatts","summary":"NREL PVWatts Solar Estimate","description":"Estimate solar photovoltaic energy production for a location using NREL PVWatts. Returns monthly and annual energy output based on system parameters.","tags":["energy"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"lat":-90,"lon":-180,"capacity":4,"azimuth":180,"tilt":40},"schema":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude of the location"},"lon":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude of the location"},"capacity":{"type":"number","default":4,"description":"System capacity in kW (default: 4)"},"azimuth":{"type":"number","default":180,"description":"Azimuth angle in degrees (default: 180 = south)"},"tilt":{"type":"number","default":40,"description":"Tilt angle in degrees (default: 40)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["lat","lon"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/energy/actions/nrel-transport-laws":{"post":{"operationId":"energy__nrel-transport-laws","summary":"NREL Transportation Laws & Incentives","description":"Search transportation laws and incentives from the National Renewable Energy Laboratory. Filter by state and type to find relevant legislation and incentive programs.","tags":["energy"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10,"state":"AL"},"schema":{"type":"object","properties":{"limit":{"type":"number","default":10,"description":"Maximum number of results to return"},"state":{"type":"string","enum":["AL","AK","AZ","AR","CA","CO","CT","DE","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY","DC","AS","GU","MP","PR","VI"],"description":"U.S. state/territory code (e.g. CA, TX, NY, FL, IL)"},"type":{"type":"string","description":"Type filter: 'Laws' or 'Incentives'"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/energy/actions/nrel-solar-dataset-query":{"post":{"operationId":"energy__nrel-solar-dataset-query","summary":"NREL Solar Dataset Query","description":"Find available solar datasets for a given location from the National Renewable Energy Laboratory. Returns information about available data years, resolution, and dataset types.","tags":["energy"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"lat":-90,"lon":-180},"schema":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude of the location"},"lon":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude of the location"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["lat","lon"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/energy/actions/nrel-census-rate":{"post":{"operationId":"energy__nrel-census-rate","summary":"NREL Utility Rates by Census Region","description":"Look up utility rates by census region for a given location from the National Renewable Energy Laboratory.","tags":["energy"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"lat":-90,"lon":-180},"schema":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude of the location"},"lon":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude of the location"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["lat","lon"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/energy/actions/eurostat-energy":{"post":{"operationId":"energy__eurostat-energy","summary":"Eurostat Energy Balance","description":"Energy supply, transformation, and consumption data from Eurostat. Covers all EU/EEA countries with annual data on primary energy production, imports, final consumption, and energy dependency.","tags":["energy"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"geo":"EU27_2020","nrg_bal":"PPRD","siec":"TOTAL"},"schema":{"type":"object","properties":{"geo":{"type":"string","default":"EU27_2020","description":"Eurostat geo code (e.g. EU27_2020, DE, FR, IT)"},"nrg_bal":{"type":"string","enum":["PPRD","IMP","EXP","GAI","FC_E","FC_TRA_E"],"default":"PPRD","description":"Energy balance: PPRD (primary production), IMP (imports), EXP (exports), GAI (gross available energy), FC_E (final consumption energy), FC_TRA_E (transport)"},"siec":{"type":"string","enum":["TOTAL","C0000X0350-0370","O4000XBIO","G3000","N9000","RA000","W6100_6220"],"default":"TOTAL","description":"Energy product: TOTAL, coal, oil, natural gas, nuclear, renewables, waste"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/energy/actions/nrel-building-components":{"post":{"operationId":"energy__nrel-building-components","summary":"NREL Building Component Library","description":"Search the Building Component Library from NREL. Find building components, materials, and assemblies for energy modeling.","tags":["energy"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"query":"insulation","limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","default":"insulation","description":"Search keyword for building components or measures"},"limit":{"type":"number","minimum":1,"maximum":100,"default":10,"description":"Maximum number of results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/maritime/actions/imo":{"post":{"operationId":"maritime__imo","summary":"IMO GISIS Ship Data","description":"Vessel metadata and registration data from Digitraffic maritime AIS. Look up vessels by MMSI or name.","tags":["maritime"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"mmsi":1,"limit":10},"schema":{"type":"object","properties":{"mmsi":{"type":"number","description":"MMSI number of a specific vessel"},"shipName":{"type":"string","description":"Ship name to search for (partial match)"},"limit":{"type":"number","default":10,"description":"Maximum number of vessels to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/transport/actions/bts-stats":{"post":{"operationId":"transport__bts-stats","summary":"BTS Transportation Statistics","description":"Get U.S. transportation statistics from the Bureau of Transportation Statistics. Includes airline on-time performance, traffic data, and transport metrics.","tags":["transport"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":20},"schema":{"type":"object","properties":{"limit":{"type":"number","default":20,"description":"Number of records to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/transport/actions/bc-ferries":{"post":{"operationId":"transport__bc-ferries","summary":"BC Ferries Schedule","description":"Get current BC Ferries schedule and capacity data for British Columbia ferry routes.","tags":["transport"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/transport/actions/irail":{"post":{"operationId":"transport__irail","summary":"iRail Belgian Railways","description":"Get Belgian railway (NMBS/SNCB) station list or connections between stations using the iRail API.","tags":["transport"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string","description":"Departure station name (e.g. Brussels-South)"},"to":{"type":"string","description":"Arrival station name (e.g. Antwerp-Central)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/transport/actions/swiss-transport":{"post":{"operationId":"transport__swiss-transport","summary":"Swiss Public Transport","description":"Search Swiss public transport stations or get connections between locations using the Swiss Transport API (SBB, BLS, PostBus, etc.).","tags":["transport"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Station search query (e.g. Zurich, Bern)"},"from":{"type":"string","description":"Departure station for connections"},"to":{"type":"string","description":"Arrival station for connections"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/transport/actions/myttc":{"post":{"operationId":"transport__myttc","summary":"Toronto TTC Routes & Predictions","description":"Get Toronto Transit Commission (TTC) route list or real-time arrival predictions for a stop.","tags":["transport"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"stopId":{"type":"string","description":"TTC stop ID for arrival predictions (omit to list all routes)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/transport/actions/fipe":{"post":{"operationId":"transport__fipe","summary":"FIPE Vehicle Pricing (Brazil)","description":"Get Brazilian vehicle pricing data from FIPE (Fundacao Instituto de Pesquisas Economicas). List brands or get model details for cars, motorcycles, and trucks.","tags":["transport"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"type":"cars","brandId":1},"schema":{"type":"object","properties":{"type":{"type":"string","enum":["cars","motorcycles","trucks"],"default":"cars","description":"Vehicle type"},"brandId":{"type":"number","description":"Brand ID to get models (omit to list all brands)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/transport/actions/nhtsa-recalls":{"post":{"operationId":"transport__nhtsa-recalls","summary":"NHTSA Vehicle Recalls","description":"Search U.S. vehicle safety recalls from the National Highway Traffic Safety Administration (NHTSA) by make, model, and year.","tags":["transport"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"make":"toyota","model":"camry","year":2025},"schema":{"type":"object","properties":{"make":{"type":"string","default":"toyota","description":"Vehicle make (e.g. toyota, ford, honda)"},"model":{"type":"string","default":"camry","description":"Vehicle model (e.g. camry, f-150, civic)"},"year":{"type":"number","default":2025,"description":"Model year"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/transport/actions/nhtsa-complaints":{"post":{"operationId":"transport__nhtsa-complaints","summary":"NHTSA Vehicle Complaints","description":"Search vehicle safety complaints filed with the National Highway Traffic Safety Administration (NHTSA) by make, model, and year.","tags":["transport"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"make":"TOYOTA","model":"CAMRY","year":2025},"schema":{"type":"object","properties":{"make":{"type":"string","default":"TOYOTA","description":"Vehicle make (e.g. TOYOTA, FORD, HONDA)"},"model":{"type":"string","default":"CAMRY","description":"Vehicle model (e.g. CAMRY, F-150, CIVIC)"},"year":{"type":"number","default":2025,"description":"Model year"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/transport/actions/nhtsa-safety-ratings":{"post":{"operationId":"transport__nhtsa-safety-ratings","summary":"NHTSA Safety Ratings (NCAP)","description":"Get NHTSA NCAP safety ratings for vehicles including overall, frontal crash, side crash, and rollover ratings.","tags":["transport"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"make":"Toyota","model":"Camry","year":2026},"schema":{"type":"object","properties":{"make":{"type":"string","default":"Toyota","description":"Vehicle make (e.g. Toyota, Ford, Honda)"},"model":{"type":"string","default":"Camry","description":"Vehicle model (e.g. Camry, F-150, Civic)"},"year":{"type":"number","default":2026,"description":"Model year"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/transport/actions/eurostat-transport":{"post":{"operationId":"transport__eurostat-transport","summary":"Eurostat Transport Statistics","description":"EU transport statistics from Eurostat. Passenger and freight transport data by mode (road, rail, air, sea) for all EU/EEA countries. Includes modal split, volume, and safety indicators.","tags":["transport"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"geo":"EU27_2020","dataset":"tran_hv_frmod"},"schema":{"type":"object","properties":{"geo":{"type":"string","default":"EU27_2020","description":"Eurostat geo code (e.g. EU27_2020, DE, FR, IT)"},"dataset":{"type":"string","enum":["tran_hv_frmod","tran_hv_psmod","tran_sf_railvi","avia_paoc"],"default":"tran_hv_frmod","description":"Dataset: tran_hv_frmod (freight modal split), tran_hv_psmod (passenger modal split), tran_sf_railvi (rail safety), avia_paoc (air passengers)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/transport/actions/uk-transport":{"post":{"operationId":"transport__uk-transport","summary":"UK Transport Statistics","description":"UK transport statistics from the Department for Transport. Road traffic, vehicle registrations, bus usage, rail passenger numbers, and road safety data.","tags":["transport"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"query":"transport statistics","limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","default":"transport statistics","description":"Search query for transport datasets"},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Max results"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/geo/actions/nominatim":{"post":{"operationId":"geo__nominatim","summary":"Nominatim Geocoding","description":"Search for locations using OpenStreetMap Nominatim geocoding service.","tags":["geo"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":5},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Location search query"},"limit":{"type":"integer","default":5,"description":"Max results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/geo/actions/usgs-elevation":{"post":{"operationId":"geo__usgs-elevation","summary":"USGS Elevation","description":"Get elevation data for a geographic point from the USGS National Map.","tags":["geo"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"lat":-90,"lon":-180},"schema":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude"},"lon":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["lat","lon"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/geo/actions/nps-parks":{"post":{"operationId":"geo__nps-parks","summary":"NPS Parks","description":"Search US National Parks using the National Park Service API.","tags":["geo"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query for parks"},"limit":{"type":"integer","default":10,"description":"Max results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/geo/actions/osm-overpass":{"post":{"operationId":"geo__osm-overpass","summary":"OSM Overpass","description":"Query OpenStreetMap Overpass API to find nearby points of interest by tag.","tags":["geo"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"lat":40.7128,"lon":-74.006,"radius":1000,"tag":"amenity=restaurant","limit":10},"schema":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90,"default":40.7128,"description":"Latitude"},"lon":{"type":"number","minimum":-180,"maximum":180,"default":-74.006,"description":"Longitude"},"radius":{"type":"number","default":1000,"description":"Search radius in meters"},"tag":{"type":"string","default":"amenity=restaurant","description":"OSM tag to search for"},"limit":{"type":"integer","default":10,"description":"Max results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/geo/actions/ipinfo":{"post":{"operationId":"geo__ipinfo","summary":"IPinfo Geolocation","description":"Get geolocation data for an IP address using IPinfo.","tags":["geo"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"ip":"8.8.8.8"},"schema":{"type":"object","properties":{"ip":{"type":"string","default":"8.8.8.8","description":"IP address to look up"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/geo/actions/technik-news-ip":{"post":{"operationId":"geo__technik-news-ip","summary":"TechnikNews IP Geolocation","description":"Get IP geolocation data from TechnikNews API.","tags":["geo"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"ip":"8.8.8.8"},"schema":{"type":"object","properties":{"ip":{"type":"string","default":"8.8.8.8","description":"IP address to look up"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/geo/actions/ziptastic":{"post":{"operationId":"geo__ziptastic","summary":"Ziptastic","description":"Get city, state, and country for a US zipcode.","tags":["geo"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"zipcode":{"type":"string","description":"US zipcode"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["zipcode"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/geo/actions/pinball-map":{"post":{"operationId":"geo__pinball-map","summary":"Pinball Map","description":"Find pinball machine locations near coordinates, or list all regions.","tags":["geo"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"lat":1,"lon":1,"distance":1},"schema":{"type":"object","properties":{"lat":{"type":"number","description":"Latitude"},"lon":{"type":"number","description":"Longitude"},"distance":{"type":"number","description":"Max distance in miles"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/geo/actions/data-gouv-fr":{"post":{"operationId":"geo__data-gouv-fr","summary":"French Address API","description":"Search for French addresses using the data.gouv.fr address API.","tags":["geo"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":5},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Address search query"},"limit":{"type":"integer","default":5,"description":"Max results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/geo/actions/geocode-xyz":{"post":{"operationId":"geo__geocode-xyz","summary":"Geocode.xyz","description":"Geocode a location query to get coordinates using geocode.xyz.","tags":["geo"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Location to geocode"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/geo/actions/geojs":{"post":{"operationId":"geo__geojs","summary":"GeoJS","description":"Get geolocation data for an IP address using GeoJS.","tags":["geo"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ip":{"type":"string","description":"IP address (omit for your own IP)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/geo/actions/country-is":{"post":{"operationId":"geo__country-is","summary":"Country.is","description":"Get the country for an IP address using country.is.","tags":["geo"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ip":{"type":"string","description":"IP address (omit for your own IP)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/geo/actions/postal-pincode":{"post":{"operationId":"geo__postal-pincode","summary":"India Postal Pincode","description":"Look up Indian postal pincode details.","tags":["geo"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"pincode":{"type":"string","description":"Indian postal pincode"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["pincode"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/geo/actions/census-geocoder":{"post":{"operationId":"geo__census-geocoder","summary":"Census Geocoder","description":"Convert US addresses to latitude/longitude coordinates using the Census Bureau geocoder. Returns matched address, coordinates, census tract, and block.","tags":["geo"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string","description":"Full address (e.g. '1600 Pennsylvania Ave, Washington, DC 20500')"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["address"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/agriculture/actions/usda-fooddata":{"post":{"operationId":"agriculture__usda-fooddata","summary":"USDA FoodData Central","description":"Search the USDA FoodData Central database for food and nutrient information.","tags":["agriculture"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":500,"description":"Search query text"},"limit":{"type":"integer","default":10,"description":"Max results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/agriculture/actions/usda-ers":{"post":{"operationId":"agriculture__usda-ers","summary":"USDA Economic Research Service","description":"Query the USDA ARMS (Agricultural Resource Management Survey) API for farm business economics data by year, report, and state.","tags":["agriculture"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"year":2024,"report":"farm_business_income"},"schema":{"type":"object","properties":{"year":{"type":"integer","default":2024,"description":"Survey year (USDA ERS data lags ~2 years)"},"report":{"type":"string","default":"farm_business_income","description":"ARMS report name (e.g. farm_business_income, crop_production_practices)"},"state":{"type":"string","description":"State abbreviation filter (e.g. IA, IL)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/agriculture/actions/usda-nass":{"post":{"operationId":"agriculture__usda-nass","summary":"USDA NASS Quick Stats","description":"Query the USDA National Agricultural Statistics Service (NASS) Quick Stats API for crop and livestock statistics by commodity, year, and state.","tags":["agriculture"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"year":2025,"aggLevel":"NATIONAL","agg_level_desc":"NATIONAL","limit":20},"schema":{"type":"object","properties":{"commodity":{"type":"string","description":"Commodity description (e.g. CORN, SOYBEANS, WHEAT)"},"statisticCategory":{"type":"string","description":"Statistic category (e.g. PRODUCTION, AREA HARVESTED, YIELD, PRICE RECEIVED)"},"state":{"type":"string","description":"State alpha code (e.g. IA, IL, TX). Omit for national totals."},"commodity_desc":{"type":"string","description":"Commodity description using USDA field name (e.g. CORN, SOYBEANS, WHEAT)"},"statisticcat_desc":{"type":"string","description":"Statistic category using USDA field name (e.g. PRODUCTION, AREA HARVESTED)"},"state_alpha":{"type":"string","description":"State alpha code using USDA field name (e.g. IA, IL, TX)"},"year":{"type":"integer","default":2025,"description":"Statistics year (USDA NASS data lags ~1 year)"},"aggLevel":{"type":"string","enum":["NATIONAL","STATE","COUNTY","REGION"],"default":"NATIONAL","description":"Aggregation level: NATIONAL, STATE, COUNTY, or REGION"},"agg_level_desc":{"type":"string","enum":["NATIONAL","STATE","COUNTY","REGION"],"description":"Aggregation level using USDA field name"},"limit":{"type":"integer","minimum":1,"maximum":500,"default":20,"description":"Maximum rows to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/media/actions/gnews":{"post":{"operationId":"media__gnews","summary":"GNews Headlines","description":"Get top news headlines by category and language from GNews.","tags":["media"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"category":"general","lang":"en","limit":10},"schema":{"type":"object","properties":{"category":{"type":"string","default":"general","description":"News category (general, world, nation, business, technology, entertainment, sports, science, health)"},"lang":{"type":"string","default":"en","description":"Language code"},"limit":{"type":"integer","default":10,"description":"Max results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/media/actions/hacker-news":{"post":{"operationId":"media__hacker-news","summary":"Hacker News Top Stories","description":"Get the top stories from Hacker News with titles, URLs, and scores.","tags":["media"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"limit":{"type":"integer","default":10,"description":"Number of top stories to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/trade/actions/eurostat-trade":{"post":{"operationId":"trade__eurostat-trade","summary":"Eurostat International Trade","description":"EU international trade in goods data from Eurostat. Monthly and annual imports and exports by partner country. Covers intra-EU and extra-EU trade flows in millions of euros.","tags":["trade"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"geo":"EU27_2020","partner":"EXT_EU27_2020","indic_et":"MIO_EUR_IMP"},"schema":{"type":"object","properties":{"geo":{"type":"string","default":"EU27_2020","description":"Reporting country/area (e.g. EU27_2020, DE, FR, IT)"},"partner":{"type":"string","default":"EXT_EU27_2020","description":"Partner country/area (e.g. EXT_EU27_2020, US, CN, GB)"},"indic_et":{"type":"string","enum":["MIO_EUR_IMP","MIO_EUR_EXP","MIO_EUR_BAL"],"default":"MIO_EUR_IMP","description":"Indicator: MIO_EUR_IMP (imports M EUR), MIO_EUR_EXP (exports M EUR), MIO_EUR_BAL (trade balance)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/trade/actions/usitc":{"post":{"operationId":"trade__usitc","summary":"USITC Harmonized Tariff Search","description":"Search the U.S. International Trade Commission Harmonized Tariff Schedule (HTS) for tariff codes, descriptions, and duty rates by keyword.","tags":["trade"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"query":"steel"},"schema":{"type":"object","properties":{"query":{"type":"string","default":"steel","description":"Search keyword for HTS tariff items"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/telecom/actions/fcc-ecfs":{"post":{"operationId":"telecom__fcc-ecfs","summary":"FCC Electronic Comment Filing System","description":"Search FCC ECFS for public filings and comments on telecommunications proceedings.","tags":["telecom"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"limit":{"type":"integer","exclusiveMinimum":true,"minimum":0,"maximum":1000,"default":10,"description":"Maximum results to return (1–1000)"},"proceedings":{"type":"string","description":"FCC proceeding number (e.g. 22-442)"},"query":{"type":"string","description":"Search term for filings"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/meta/actions/datagov-catalog":{"post":{"operationId":"meta__datagov-catalog","summary":"Data.gov Catalog","description":"Search the US Data.gov open data catalog for datasets.","tags":["meta"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"limit":{"type":"integer","default":10,"description":"Max results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/meta/actions/data-europa":{"post":{"operationId":"meta__data-europa","summary":"EU Open Data Portal","description":"Search the European Union open data portal for datasets.","tags":["meta"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"limit":{"type":"integer","default":10,"description":"Max results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/govuk":{"post":{"operationId":"international__govuk","summary":"GOV.UK Search","description":"Search the UK government website GOV.UK for content.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"limit":{"type":"integer","default":10,"description":"Max results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/cnb-rates":{"post":{"operationId":"international__cnb-rates","summary":"CNB Exchange Rates","description":"Get daily exchange rates from the Czech National Bank.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string","description":"Date in YYYY-MM-DD format (optional)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/citybikes":{"post":{"operationId":"international__citybikes","summary":"CityBikes Networks","description":"Get bike-sharing networks worldwide from the CityBikes API.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":20},"schema":{"type":"object","properties":{"limit":{"type":"integer","default":20,"description":"Max results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/cdnjs":{"post":{"operationId":"international__cdnjs","summary":"cdnjs Library Search","description":"Search JavaScript libraries on cdnjs CDN.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Library name to search for"},"limit":{"type":"integer","default":10,"description":"Max results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/shields-io":{"post":{"operationId":"international__shields-io","summary":"Shields.io Badge","description":"Generate a Shields.io badge in JSON format.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"label":"build","message":"passing","color":"green"},"schema":{"type":"object","properties":{"label":{"type":"string","default":"build","description":"Badge label"},"message":{"type":"string","default":"passing","description":"Badge message"},"color":{"type":"string","default":"green","description":"Badge color"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/internet-archive":{"post":{"operationId":"international__internet-archive","summary":"Internet Archive Search","description":"Search the Internet Archive for books, media, and web archives.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"limit":{"type":"integer","default":10,"description":"Max results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/hipolabs":{"post":{"operationId":"international__hipolabs","summary":"Hipolabs Universities","description":"Search universities worldwide by country and/or name.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string","description":"Country name"},"name":{"type":"string","description":"University name"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/hebcal":{"post":{"operationId":"international__hebcal","summary":"Hebcal Jewish Calendar","description":"Get Jewish calendar events and holidays from Hebcal.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"year":2026,"month":1},"schema":{"type":"object","properties":{"year":{"type":"integer","minimum":1900,"maximum":2027,"default":2026,"description":"Year"},"month":{"type":"integer","description":"Month (1-12)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/cbr-russia":{"post":{"operationId":"international__cbr-russia","summary":"CBR Russia Exchange Rates","description":"Get daily exchange rates from the Central Bank of Russia.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/nbp-poland":{"post":{"operationId":"international__nbp-poland","summary":"NBP Poland Exchange Rates","description":"Get exchange rates from the National Bank of Poland.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"table":"a"},"schema":{"type":"object","properties":{"table":{"type":"string","enum":["a","b","c"],"default":"a","description":"Exchange rate table (a, b, or c)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/binlist":{"post":{"operationId":"international__binlist","summary":"BIN Lookup","description":"Look up card BIN/IIN information (bank, type, brand, country).","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"bin":{"type":"string","description":"Bank Identification Number (first 6-8 digits of card)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["bin"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/hn-firebase":{"post":{"operationId":"international__hn-firebase","summary":"HN Firebase Top Stories","description":"Get top Hacker News story IDs via the Firebase API.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":10},"schema":{"type":"object","properties":{"limit":{"type":"integer","default":10,"description":"Number of story IDs to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/4chan":{"post":{"operationId":"international__4chan","summary":"4chan Boards & Catalog","description":"Get 4chan board list or catalog for a specific board.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"board":{"type":"string","description":"Board name (e.g. 'g', 'pol'). Omit for board list."},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/mailgw":{"post":{"operationId":"international__mailgw","summary":"Mail.gw Domains","description":"Get available temporary email domains from Mail.gw.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/picsum":{"post":{"operationId":"international__picsum","summary":"Lorem Picsum","description":"List placeholder images from Lorem Picsum.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"page":1,"limit":10},"schema":{"type":"object","properties":{"page":{"type":"integer","default":1,"description":"Page number"},"limit":{"type":"integer","default":10,"description":"Items per page"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/fruityvice":{"post":{"operationId":"international__fruityvice","summary":"Fruityvice","description":"Get nutritional data about fruits from Fruityvice.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Fruit name (omit for all fruits)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/coffee-api":{"post":{"operationId":"international__coffee-api","summary":"Coffee API","description":"Get coffee drink recipes and information.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"type":"hot"},"schema":{"type":"object","properties":{"type":{"type":"string","enum":["hot","iced"],"default":"hot","description":"Coffee type"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/openligadb":{"post":{"operationId":"international__openligadb","summary":"OpenLigaDB","description":"Get football/soccer match data from OpenLigaDB (German leagues focus).","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"league":"bl1","season":2023},"schema":{"type":"object","properties":{"league":{"type":"string","default":"bl1","description":"League shortcut (e.g. bl1 for Bundesliga)"},"season":{"type":"integer","minimum":1900,"maximum":2027,"default":2023,"description":"Season year"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/squiggle":{"post":{"operationId":"international__squiggle","summary":"Squiggle AFL","description":"Get AFL (Australian Football League) data from Squiggle.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"query":"teams"},"schema":{"type":"object","properties":{"query":{"type":"string","enum":["teams","games","tips"],"default":"teams","description":"Data type to query"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/rainviewer":{"post":{"operationId":"international__rainviewer","summary":"RainViewer Weather Maps","description":"Get available weather radar map timestamps from RainViewer.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/7timer":{"post":{"operationId":"international__7timer","summary":"7Timer Weather Forecast","description":"Get weather forecasts from 7Timer for a given location.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"lat":40.71,"lon":-74.01,"product":"civil"},"schema":{"type":"object","properties":{"lat":{"type":"number","default":40.71,"description":"Latitude"},"lon":{"type":"number","default":-74.01,"description":"Longitude"},"product":{"type":"string","enum":["astro","civil","civillight"],"default":"civil","description":"Forecast product type"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/agify":{"post":{"operationId":"international__agify","summary":"Agify","description":"Predict the age of a person based on their name.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Name to predict age for"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["name"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/genderize":{"post":{"operationId":"international__genderize","summary":"Genderize","description":"Predict the gender of a person based on their name.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Name to predict gender for"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["name"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/nationalize":{"post":{"operationId":"international__nationalize","summary":"Nationalize","description":"Predict the nationality of a person based on their name.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Name to predict nationality for"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":["name"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/apis-guru":{"post":{"operationId":"international__apis-guru","summary":"APIs.guru Directory","description":"Get a summary of all public APIs tracked by APIs.guru.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/digitalocean-status":{"post":{"operationId":"international__digitalocean-status","summary":"DigitalOcean Status","description":"Get the current status of DigitalOcean services.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/oddsmagnet":{"post":{"operationId":"international__oddsmagnet","summary":"Sports Events & Odds","description":"Upcoming sports events from TheSportsDB. Filter by date and sport. Returns event details including teams, league, venue, and schedule.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string","description":"Date in YYYY-MM-DD format (defaults to today)"},"sport":{"type":"string","description":"Sport name to filter (e.g. Soccer, Basketball)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/radio-browser-intl":{"post":{"operationId":"international__radio-browser-intl","summary":"Radio Browser","description":"Search internet radio stations worldwide by country.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"limit":20},"schema":{"type":"object","properties":{"country":{"type":"string","description":"Country name to filter by"},"limit":{"type":"integer","default":20,"description":"Max results to return"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/wits-trade":{"post":{"operationId":"international__wits-trade","summary":"World Bank Trade Data","description":"Query World Bank trade indicators (exports, imports, trade balance) by country and year. Uses World Bank Development Indicators API.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"country":"USA","year":2024,"indicator":"NE.EXP.GNFS.CD"},"schema":{"type":"object","properties":{"country":{"type":"string","default":"USA","description":"ISO country code (e.g. USA, CHN, DEU)"},"year":{"type":"integer","default":2024,"description":"Data year (World Bank WITS data lags ~2 years)"},"indicator":{"type":"string","default":"NE.EXP.GNFS.CD","description":"World Bank indicator ID (NE.EXP.GNFS.CD = exports, NE.IMP.GNFS.CD = imports, NE.TRD.GNFS.ZS = trade % of GDP)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}},"/agents/international/actions/open-exchange":{"post":{"operationId":"international__open-exchange","summary":"Open Exchange Rates","description":"Latest currency exchange rates via Frankfurter API. Get rates for any base currency with optional symbol filtering.","tags":["international"],"security":[{"apiKey":[]},{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"example":{"base":"USD"},"schema":{"type":"object","properties":{"base":{"type":"string","default":"USD","description":"Base currency code (e.g. USD, EUR, GBP)"},"symbols":{"type":"string","description":"Comma-separated target currencies (e.g. EUR,GBP,JPY)"},"_fields":{"type":"array","items":{"type":"string"},"description":"Filter response to only these fields"},"_format":{"type":"string","enum":["full","compact"],"description":"Response format (compact strips nulls)"},"_limit":{"type":"integer","minimum":1,"description":"Limit array results per page"},"_page":{"type":"integer","minimum":1,"description":"Page number for paginating array results (works with _limit)"},"_normalize":{"type":"boolean","description":"Normalize field names to canonical forms (e.g. zipCode → zip_code, lat → latitude)"},"_units":{"type":"string","enum":["metric","imperial"],"description":"Convert known unit fields to the specified system (e.g. miles → km, lbs → kg)"},"_summary":{"type":"boolean","description":"Include aggregate stats (count, min, max, avg) for numeric fields"},"_mock":{"type":"boolean","description":"Return cached sample data instead of hitting upstream"},"credentials":{"type":"object","description":"BYOK credentials (optional)"}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"text":{"type":"string","nullable":true},"meta":{"type":"object","properties":{"agent":{"type":"string"},"action":{"type":"string"},"authMethod":{"type":"string"},"creditsCharged":{"type":"integer"},"cacheStatus":{"type":"string","enum":["hit","miss","stale","mock"]},"cachedFree":{"type":"boolean","description":"True when served from cache — no quota charged"},"durationMs":{"type":"integer"}}},"quality":{"type":"object","properties":{"freshness_seconds":{"type":"number"},"source_uptime_7d":{"type":"number","nullable":true},"data_completeness":{"type":"number"},"confidence":{"type":"string","enum":["high","medium","low"]},"certainty_score":{"type":"number"}}},"citation":{"type":"object","nullable":true,"properties":{"source_name":{"type":"string"},"source_url":{"type":"string"},"retrieved_at":{"type":"string"},"data_hash":{"type":"string"},"license":{"type":"string"},"update_frequency":{"type":"string","enum":["real-time","hourly","daily","weekly","monthly","quarterly","annual"]},"original_format":{"type":"string","enum":["JSON","CSV","XML","PDF","HTML","GeoJSON","SPARQL","Binary"],"description":"Original format of the upstream data"},"citation_text":{"type":"string","description":"Pre-formatted full citation for embedding in text"},"citation_footnote":{"type":"string","description":"Short footnote reference, e.g. 'U.S. Census Bureau, Apr 2026'"}}}}}}}},"400":{"description":"Invalid input"},"401":{"description":"Authentication required"},"404":{"description":"Agent or action not found"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Upstream error"}}}}},"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key (starts with kz_)"},"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}}}