{"tools":[{"description":"Search the news index. Returns ranked articles with image, topics, entities, locations, and versioned industry/business/risk language signals. Supports keyword, semantic, or hybrid ranking, exact metadata filters, numeric signal ranges, pagination, and facets.","inputSchema":{"properties":{"amount_object":{"description":"Filter to an exact object described by a numeric amount.","type":"string"},"author":{"description":"Filter to an exact article author.","type":"string"},"city":{"description":"Filter to an exact mentioned city.","type":"string"},"country":{"description":"Filter by a mentioned country's canonical two-character identifier.","type":"string"},"facet_limit":{"maximum":100,"minimum":1,"type":"integer"},"facets":{"items":{"enum":["source","source_type","publisher_country","language","topic","organization","person","country","author","location","location_id","city","region","name","mentioned_date","quote_verb","amount_object"],"type":"string"},"maxItems":8,"type":"array"},"from":{"description":"Date/time, e.g. 2026-07-09 or 20260709120000 (YYYYMMDDHHMMSS).","type":"string"},"language":{"description":"Filter to a source language (ISO-639-3, e.g. eng, fra, ara, zho).","type":"string"},"limit":{"maximum":100,"minimum":1,"type":"integer"},"location":{"description":"Filter to an exact mentioned location.","type":"string"},"location_id":{"description":"Filter to an exact canonical location identifier.","type":"string"},"mentioned_date":{"description":"Filter to an exact date mentioned in article text.","type":"string"},"mode":{"description":"Ranking mode (default hybrid).","enum":["keyword","semantic","hybrid"],"type":"string"},"name":{"description":"Filter to an exact proper name.","type":"string"},"offset":{"description":"Zero-based result offset.","maximum":100000,"minimum":0,"type":"integer"},"organization":{"description":"Filter to an exact organization entity.","type":"string"},"person":{"description":"Filter to an exact person entity.","type":"string"},"publisher_country":{"description":"Filter by the publisher's canonical two-character country identifier.","type":"string"},"q":{"description":"Query text.","type":"string"},"quote_verb":{"description":"Filter to an exact verb introducing a quotation.","type":"string"},"region":{"description":"Filter to an exact mentioned region.","type":"string"},"signal":{"description":"Select a normalized business signal for inclusive range filtering.","enum":["economy","healthcare","agriculture","labor","environment","energy","transportation","real_estate","finance","defense","science_technology","trade","public_sector","financial_uncertainty","financial_negative","financial_positive","legal_litigation","financial_stability_stress","anxiety","conflict","supply_disruption","cyber_incident","climate","health_security","governance_risk"],"type":"string"},"signal_max":{"minimum":0,"type":"number"},"signal_min":{"minimum":0,"type":"number"},"signals":{"description":"Derived signal ranges combined with AND semantics.","items":{"additionalProperties":false,"properties":{"max":{"minimum":0,"type":"number"},"min":{"minimum":0,"type":"number"},"name":{"enum":["economy","healthcare","agriculture","labor","environment","energy","transportation","real_estate","finance","defense","science_technology","trade","public_sector","financial_uncertainty","financial_negative","financial_positive","legal_litigation","financial_stability_stress","anxiety","conflict","supply_disruption","cyber_incident","climate","health_security","governance_risk"],"type":"string"}},"required":["name"],"type":"object"},"maxItems":8,"type":"array"},"source":{"description":"Filter to a source domain, e.g. bbc.co.uk.","type":"string"},"source_type":{"enum":["web","citation","academic_archive","defense_archive","journal_archive","non_textual","other"],"type":"string"},"to":{"description":"Date/time, e.g. 2026-07-09 or 20260709120000 (YYYYMMDDHHMMSS).","type":"string"},"topic":{"description":"Filter to an exact canonical topic identifier returned by the API.","type":"string"}},"required":["q"],"type":"object"},"name":"search_news"},{"description":"Search and collapse results into deduplicated stories (one real event across many outlets). Returns story_id, article count, outlet count, and a representative headline.","inputSchema":{"properties":{"amount_object":{"type":"string"},"author":{"type":"string"},"city":{"type":"string"},"country":{"description":"Mentioned-country canonical two-character identifier.","type":"string"},"from":{"description":"Date/time, e.g. 2026-07-09 or 20260709120000 (YYYYMMDDHHMMSS).","type":"string"},"language":{"description":"ISO-639-3 source language, e.g. eng, fra.","type":"string"},"limit":{"maximum":100,"minimum":1,"type":"integer"},"location":{"type":"string"},"location_id":{"type":"string"},"mentioned_date":{"type":"string"},"name":{"type":"string"},"offset":{"maximum":100000,"minimum":0,"type":"integer"},"organization":{"description":"Exact organization entity.","type":"string"},"person":{"description":"Exact person entity.","type":"string"},"publisher_country":{"type":"string"},"q":{"type":"string"},"quote_verb":{"type":"string"},"region":{"type":"string"},"signal":{"description":"Normalized business signal name.","type":"string"},"signal_max":{"minimum":0,"type":"number"},"signal_min":{"minimum":0,"type":"number"},"signals":{"description":"Derived signal ranges combined with AND semantics.","items":{"additionalProperties":false,"properties":{"max":{"minimum":0,"type":"number"},"min":{"minimum":0,"type":"number"},"name":{"enum":["economy","healthcare","agriculture","labor","environment","energy","transportation","real_estate","finance","defense","science_technology","trade","public_sector","financial_uncertainty","financial_negative","financial_positive","legal_litigation","financial_stability_stress","anxiety","conflict","supply_disruption","cyber_incident","climate","health_security","governance_risk"],"type":"string"}},"required":["name"],"type":"object"},"maxItems":8,"type":"array"},"source_type":{"type":"string"},"to":{"description":"Date/time, e.g. 2026-07-09 or 20260709120000 (YYYYMMDDHHMMSS).","type":"string"},"topic":{"description":"Exact canonical topic identifier.","type":"string"}},"required":["q"],"type":"object"},"name":"list_stories"},{"description":"Most-recent articles, optionally filtered by indexed article metadata and time range.","inputSchema":{"properties":{"amount_object":{"type":"string"},"author":{"type":"string"},"city":{"type":"string"},"country":{"description":"Mentioned-country canonical two-character identifier.","type":"string"},"facet_limit":{"maximum":100,"minimum":1,"type":"integer"},"facets":{"items":{"enum":["source","source_type","publisher_country","language","topic","organization","person","country","author","location","location_id","city","region","name","mentioned_date","quote_verb","amount_object"],"type":"string"},"maxItems":8,"type":"array"},"from":{"description":"Date/time, e.g. 2026-07-09 or 20260709120000 (YYYYMMDDHHMMSS).","type":"string"},"language":{"description":"ISO-639-3 source language, e.g. eng, fra.","type":"string"},"limit":{"maximum":100,"minimum":1,"type":"integer"},"location":{"type":"string"},"location_id":{"type":"string"},"mentioned_date":{"type":"string"},"name":{"type":"string"},"offset":{"maximum":100000,"minimum":0,"type":"integer"},"organization":{"description":"Exact organization entity.","type":"string"},"person":{"description":"Exact person entity.","type":"string"},"publisher_country":{"type":"string"},"quote_verb":{"type":"string"},"region":{"type":"string"},"signal":{"description":"Normalized business signal name.","type":"string"},"signal_max":{"minimum":0,"type":"number"},"signal_min":{"minimum":0,"type":"number"},"signals":{"description":"Derived signal ranges combined with AND semantics.","items":{"additionalProperties":false,"properties":{"max":{"minimum":0,"type":"number"},"min":{"minimum":0,"type":"number"},"name":{"enum":["economy","healthcare","agriculture","labor","environment","energy","transportation","real_estate","finance","defense","science_technology","trade","public_sector","financial_uncertainty","financial_negative","financial_positive","legal_litigation","financial_stability_stress","anxiety","conflict","supply_disruption","cyber_incident","climate","health_security","governance_risk"],"type":"string"}},"required":["name"],"type":"object"},"maxItems":8,"type":"array"},"source":{"type":"string"},"source_type":{"type":"string"},"to":{"description":"Date/time, e.g. 2026-07-09 or 20260709120000 (YYYYMMDDHHMMSS).","type":"string"},"topic":{"description":"Exact canonical topic identifier.","type":"string"}},"type":"object"},"name":"top_headlines"},{"description":"Fetch a single article's rich metadata by id, including names, structured locations and dates, quotations, amounts, related media, links, and alternate URLs.","inputSchema":{"properties":{"id":{"type":"string"}},"required":["id"],"type":"object"},"name":"get_article"},{"description":"Find articles semantically similar to a given article id (More-Like-This). Returns distinct related stories (deduplicated across outlets), excluding the seed article.","inputSchema":{"properties":{"id":{"description":"Seed article id to find related stories for.","type":"string"},"limit":{"maximum":100,"minimum":1,"type":"integer"}},"required":["id"],"type":"object"},"name":"find_related"},{"description":"Report this session's account: plan, per-minute rate limit, monthly quota and how much of it is used, whether the key stops at its quota or bills overage, how far back the plan may query (history_days; null = the full archive), calls made this session, and whether metered billing is active.\n\nFREE: this tool is not billed against your quota in any way you would notice, and it is how to plan a time range instead of discovering the archive boundary by getting fewer results than you expected.","inputSchema":{"properties":{},"type":"object"},"name":"account_status"}]}