NewsMCP

Search already-synthesized news events — pre-built story digests — or fetch one by id. Each story comes with a generated headline, one-liner, abstract, key actors, and industry/event-type labels. Use it for a quick digest of what happened, for deal/incident-type or industry filtering, and for corroboration ranking. Nothing is required: a bare call returns the most-corroborated stories of the last 24 hours. Limits — keyless: 7-day `from_` lookback, 20 calls/hour, 20 stories per call, over-limit narrowed with a notice. With a key: per-plan ceilings (free tier today 14 days, 50 calls/hour, 50 stories), over-limit rejected rather than narrowed. Call `check_limits` for the live numbers; it is free and never spends the budget it reports on. Filters combine with AND; `event_type`, `content_type`, and `sector` each accept several comma-separated values combined with OR.

{
  "type": "object",
  "properties": {
    "q": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional search terms, matched case-insensitively against the story's headline, one-liner, abstract, and named actors (no article body text, no stemming). Space-separated words are ANDed, so ALWAYS quote a multi-word phrase: `layoffs OR \"workforce reduction\"` works, `layoffs OR workforce reduction` is read as a mix of AND/OR and rejected. Supports AND/OR/NOT (aliases &&, ||, !), ( ) grouping, and `*` wildcards. NEAR() and MULTIPLE() are NOT supported here — they are silently read as ordinary words instead of erroring, so never use them. Omit q entirely for a filter-only digest (\"banking news today\" needs no q at all)."
    },
    "subject": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "A single company, person, place, or organisation to centre the search on — plain name, no quoting. Quoted for you, which is the difference between a phrase and a bag of words: `Bank of America` unquoted ANDs three common terms and surfaces \"Medtronic Revenue Grows\" first, while the quoted phrase surfaces Bank of America. Combines with `q` (subject AND query), so `subject=\"Tesla\", q=\"recall OR lawsuit\"` reads as expected. Setting it also widens the default window from 24 hours to 30 days (clamped to the plan), because a company can go a fortnight without news — that is the single most common reason a name search comes back empty. Pass an explicit `from_` to override."
    },
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional NewsMCP API key for this call; forwarded upstream as x-api-key. Keyless: 7-day `from_` lookback, 20 calls/hour (shared per network address), 20 stories per call — over-limit requests are narrowed with a notice, not rejected. With a key the ceilings come from the plan (free tier today: 14 days, 50 calls/hour, 50 stories) and over-limit requests are rejected with a validation error instead of narrowed. Those per-plan numbers change without a release — call `check_limits` for the live values and the hourly budget left; it costs nothing. A keyed caller may have only one request in flight at a time, so never call in parallel."
    },
    "event_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Superseded by the `get_story` tool, which does this with two arguments instead of nineteen and can return every source link. Kept for compatibility. Fetch ONE story directly by the `event_id` of an earlier result (e.g. `evt_...`) — use it for \"pull that story up again\". When set, every other filter is ignored. Stories are occasionally folded into a more complete story as coverage develops: that returns 404 naming the replacement id, so fetch that id instead. An id that never existed returns a plain not-found."
    },
    "event_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "What KIND of event the story is, independent of industry. Exact `family.leaf` value; a bare family (`deals`) is invalid and unknown values are rejected naming them. Comma-separated for OR (`deals.merger_acquisition,funding.venture_funding_round` = \"M&A or funding news\"). The taxonomy is 59 leaves across 21 families, plus the standalone value `unclassifiable` for a labeled-but-uncategorizable story. Families: corporate_finance, markets, deals, governance, society_environment, sports, justice_crime, security, macro_policy, research_science, religion_society, politics, legal_regulatory, culture_media, product, accidents_disasters, operations, funding, local_civic, geopolitics, corporate_comms. The complete set of accepted values: corporate_finance.earnings_report, corporate_finance.analyst_rating, corporate_finance.dividends, markets.stock_move, markets.commodity_price, markets.currency_move, deals.merger_acquisition, deals.ipo_filing, deals.asset_sale, governance.board_change, governance.shareholder_vote, governance.executive_departure, society_environment.climate_event, society_environment.public_health, society_environment.environmental_incident, sports.match_result, sports.transfer_signing, sports.championship, justice_crime.arrest_charge, justice_crime.trial_verdict, justice_crime.investigation, security.cyberattack, security.data_breach, security.physical_security_incident, macro_policy.central_bank_decision, macro_policy.trade_policy, macro_policy.fiscal_policy, research_science.scientific_discovery, research_science.clinical_trial_result, research_science.publication, religion_society.religious_event, religion_society.social_movement, politics.election, politics.policy_announcement, politics.diplomacy, legal_regulatory.regulatory_action, legal_regulatory.lawsuit_filed, legal_regulatory.compliance_ruling, culture_media.celebrity_news, culture_media.entertainment_release, culture_media.award, product.product_launch, product.product_recall, product.feature_update, accidents_disasters.natural_disaster, accidents_disasters.industrial_accident, accidents_disasters.transport_accident, operations.plant_closure, operations.layoffs, operations.supply_chain_disruption, funding.venture_funding_round, funding.grant_award, local_civic.local_government_action, local_civic.infrastructure_project, geopolitics.armed_conflict, geopolitics.sanctions, geopolitics.diplomacy_summit, corporate_comms.press_release, corporate_comms.leadership_statement, unclassifiable."
    },
    "content_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "The FORM the reporting takes, independent of what it is about. Comma-separated for OR. One of: news_report, press_release, service_info, human_interest, explainer, commentary, analysis, opinion, interview, obituary. There is no NOT on this field, so for \"analysis, not straight news\" name the forms wanted (`analysis`) rather than the ones to exclude."
    },
    "sector": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Industry the story belongs to. Comma-separated for OR (`software_it_services,semiconductors` = \"tech and chips\"). One of: government_public_sector, media_entertainment, financial_services, healthcare_pharma, energy_utilities, retail_consumer, real_estate, agriculture_food, telecommunications, automotive, manufacturing_industrial, transport_logistics, aerospace_defense, mining_metals, construction_infrastructure, education, hospitality_travel, sports_recreation, nonprofit_ngo, legal_services, insurance, software_it_services, ecommerce, banking, defense_security, chemicals, fashion_apparel, gaming_esports, biotechnology, semiconductors, other_sector."
    },
    "min_newsrooms": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Minimum outlets that reported INDEPENDENTLY, mirrors excluded — the strongest is-this-real signal. Reach for this over min_sources whenever the user wants to exclude a story that one outlet ran and everyone else reprinted. `3` ≈ \"well-corroborated only\"."
    },
    "from_": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Inclusive lower bound on when the story BEGAN (its first_seen) — NOT the publish date of any one article, so a story still running today but started last week falls outside the default window. ISO 8601 (`2026-07-01T00:00:00`) or a relative phrase (`now-6h`, `2 days ago`, `yesterday`); all dates are UTC. Default: 24 hours ago, much narrower than a general news search — widening this is the FIRST thing to try when a query that should match something returns nothing — but the lookback is capped: 7 days keyless (narrowed with a notice), and per-plan with a key (14 days on the free tier today, rejected rather than narrowed). `check_limits` reports the caller's live ceiling."
    },
    "sort": {
      "anyOf": [
        {
          "enum": [
            "newsrooms",
            "trending",
            "relevance",
            "last_seen",
            "first_seen",
            "size",
            "source_count",
            "confidence"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "What \"best\" means for this call. **Omit it** unless the user asked for a specific ordering: the API then picks `relevance` when `q` or `subject` is set and `newsrooms` when neither is, which is almost always right. Forcing `newsrooms` on a keyword search ranks by story size rather than match, so `subject=\"Bank of America\"` returns \"India Now Asia's Least Preferred Stock Market\" ahead of \"Bank of America Warns of European Stock Decline\" — big stories that merely mention the words. `newsrooms`: most independently-corroborated first. `trending`: corroboration weighted by freshness on an 8-hour half-life — the one for \"what is blowing up right now\". `relevance`: best semantic match to q first, and REQUIRES q. `last_seen`: most recently active. `first_seen`: most recently started. `size`: most articles. `source_count`: most publisher domains, mirrors included. `confidence`: highest label confidence, unlabeled last regardless of order."
    },
    "limit": {
      "default": 20,
      "description": "Stories per page, 1–50, default 20, but capped for the caller: keyless 20 (softly, with a notice), and per-plan with a key (50 on the free tier today, over it is a validation error naming the maximum). `check_limits` reports the live cap. Raise it when the user asks for breadth — one call with a a flat ceiling rather than a page size: there is no paging past it, since the hourly call budget is the scarce resource (keyless 20/hour, 50/hour on the free tier).",
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "verbosity": {
      "default": "standard",
      "description": "Controls ONLY the source-link list; headline, summary, actors, and labels are always present. `compact`: no links. `standard` (default): up to 3. `full`: every link, uncapped — use it for \"show me every source\", but it makes a large `limit` very long.",
      "enum": [
        "compact",
        "standard",
        "full"
      ],
      "type": "string"
    },
    "response_format": {
      "default": "markdown",
      "description": "Output shape in content[0].text. Default `markdown` (readable digest). `text` = plain lines. `json` = full API payload. Match what the user asks for.",
      "enum": [
        "text",
        "markdown",
        "json"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "events": {
      "type": "array",
      "description": "Present for a search call (event_id unset).",
      "items": {
        "type": "object",
        "properties": {
          "event_id": {
            "type": "string",
            "description": "Stable id, e.g. evt_..."
          },
          "headline": {
            "type": [
              "string",
              "null"
            ]
          },
          "one_liner": {
            "type": [
              "string",
              "null"
            ]
          },
          "abstract": {
            "type": [
              "string",
              "null"
            ]
          },
          "event_type": {
            "type": [
              "string",
              "null"
            ],
            "description": "family.leaf taxonomy value, e.g. deals.merger_acquisition."
          },
          "content_type": {
            "type": [
              "string",
              "null"
            ]
          },
          "sector": {
            "type": [
              "string",
              "null"
            ]
          },
          "size": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Article count."
          },
          "source_count": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Publisher domains, mirrors included."
          },
          "newsrooms": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Independent newsrooms — the corroboration signal."
          },
          "reports": {
            "type": [
              "integer",
              "null"
            ]
          },
          "language_count": {
            "type": [
              "integer",
              "null"
            ]
          },
          "first_seen": {
            "type": [
              "string",
              "null"
            ],
            "description": "ISO 8601 UTC."
          },
          "last_seen": {
            "type": [
              "string",
              "null"
            ],
            "description": "ISO 8601 UTC."
          },
          "entities": {
            "type": "array",
            "description": "Key actors named in the story.",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                }
              },
              "additionalProperties": true
            }
          },
          "sources": {
            "type": "array",
            "description": "Source article URLs — a sample or the full list per verbosity.",
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": true
      }
    },
    "total": {
      "type": "integer",
      "description": "Total matching stories; present for a search call."
    },
    "keyless_notices": {
      "type": "array",
      "description": "Present when a keyless caller's request was narrowed.",
      "items": {
        "type": "string"
      }
    }
  },
  "description": "A page of synthesized news events for a search call, or — when `event_id` is set — a single event's own fields at the top level instead of under `events`.",
  "allOf": [
    {
      "type": "object",
      "properties": {
        "event_id": {
          "type": "string",
          "description": "Stable id, e.g. evt_..."
        },
        "headline": {
          "type": [
            "string",
            "null"
          ]
        },
        "one_liner": {
          "type": [
            "string",
            "null"
          ]
        },
        "abstract": {
          "type": [
            "string",
            "null"
          ]
        },
        "event_type": {
          "type": [
            "string",
            "null"
          ],
          "description": "family.leaf taxonomy value, e.g. deals.merger_acquisition."
        },
        "content_type": {
          "type": [
            "string",
            "null"
          ]
        },
        "sector": {
          "type": [
            "string",
            "null"
          ]
        },
        "size": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Article count."
        },
        "source_count": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Publisher domains, mirrors included."
        },
        "newsrooms": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Independent newsrooms — the corroboration signal."
        },
        "reports": {
          "type": [
            "integer",
            "null"
          ]
        },
        "language_count": {
          "type": [
            "integer",
            "null"
          ]
        },
        "first_seen": {
          "type": [
            "string",
            "null"
          ],
          "description": "ISO 8601 UTC."
        },
        "last_seen": {
          "type": [
            "string",
            "null"
          ],
          "description": "ISO 8601 UTC."
        },
        "entities": {
          "type": "array",
          "description": "Key actors named in the story.",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              }
            },
            "additionalProperties": true
          }
        },
        "sources": {
          "type": "array",
          "description": "Source article URLs — a sample or the full list per verbosity.",
          "items": {
            "type": "string"
          }
        }
      },
      "additionalProperties": true
    }
  ],
  "additionalProperties": true
}

Expand one story: full summary, classification, actors, and source links. Use this after any search, when the user wants more than the digest line for a particular story. It is the only tool that can return a story's complete source list.

{
  "type": "object",
  "properties": {
    "event_id": {
      "description": "The `event_id` of a story from an earlier result (e.g. `evt_...`). A story folded into a more complete one answers 404 naming its replacement id — fetch that instead.",
      "type": "string"
    },
    "include_sources": {
      "default": false,
      "description": "False (default) returns a sample of source links; True returns every one. A large story can carry several hundred, so leave this off unless the user asked for the full list. This is the only place the complete list is available — the search endpoints cap it.",
      "type": "boolean"
    },
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional NewsMCP API key for this call; forwarded upstream as x-api-key. Only one request may be in flight at a time, so never call in parallel."
    },
    "response_format": {
      "default": "markdown",
      "description": "markdown (default), text, or json. Pass the format the user asked for rather than reformatting afterwards.",
      "enum": [
        "text",
        "markdown",
        "json"
      ],
      "type": "string"
    }
  },
  "required": [
    "event_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "event_id": {
      "type": "string",
      "description": "Stable id, e.g. evt_..."
    },
    "headline": {
      "type": [
        "string",
        "null"
      ]
    },
    "one_liner": {
      "type": [
        "string",
        "null"
      ]
    },
    "abstract": {
      "type": [
        "string",
        "null"
      ]
    },
    "event_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "family.leaf taxonomy value, e.g. deals.merger_acquisition."
    },
    "content_type": {
      "type": [
        "string",
        "null"
      ]
    },
    "sector": {
      "type": [
        "string",
        "null"
      ]
    },
    "size": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Article count."
    },
    "source_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Publisher domains, mirrors included."
    },
    "newsrooms": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Independent newsrooms — the corroboration signal."
    },
    "reports": {
      "type": [
        "integer",
        "null"
      ]
    },
    "language_count": {
      "type": [
        "integer",
        "null"
      ]
    },
    "first_seen": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO 8601 UTC."
    },
    "last_seen": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO 8601 UTC."
    },
    "entities": {
      "type": "array",
      "description": "Key actors named in the story.",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "sources": {
      "type": "array",
      "description": "Source article URLs — a sample or the full list per verbosity.",
      "items": {
        "type": "string"
      }
    }
  },
  "additionalProperties": true,
  "description": "One synthesized news event, expanded."
}

Judge how widely and how independently a claim has been reported. Answers "is this real?" rather than returning a list. Reports the number of INDEPENDENT newsrooms — outlets that reported it themselves — separately from the number of domains that carried it, which includes syndication. A story on 200 domains from 3 newsrooms is one story reprinted, not 200 confirmations. Because upstream clustering splits a story across languages, this totals the likely variants of the same story and presents that total as an upper bound, listing what was combined so the caller can check it is really one story.

{
  "type": "object",
  "properties": {
    "claim": {
      "description": "The claim or headline to check, phrased in the words a headline would use. Matched literally against headlines and summaries, not by meaning, so \"atomic arsenal\" will not find stories about nuclear weapons.",
      "type": "string"
    },
    "days_back": {
      "default": 14,
      "description": "How far back to look, in days. Defaults to 14. Clamped down to whatever the caller's plan allows, with a note saying so.",
      "minimum": 1,
      "type": "integer"
    },
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional NewsMCP API key for this call; forwarded upstream as x-api-key. Only one request may be in flight at a time, so never call in parallel."
    },
    "response_format": {
      "default": "markdown",
      "description": "markdown (default), text, or json. Pass the format the user asked for rather than reformatting afterwards.",
      "enum": [
        "text",
        "markdown",
        "json"
      ],
      "type": "string"
    }
  },
  "required": [
    "claim"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "matched": {
      "type": "boolean",
      "description": "Whether any story matched the claim text in the window."
    },
    "total_matching_stories": {
      "type": "integer"
    },
    "anchor_newsrooms": {
      "type": "integer",
      "description": "Independent newsrooms for the best-corroborated matching story."
    },
    "combined_newsrooms_upper_bound": {
      "type": "integer",
      "description": "Sum across clustered variants of the same story — an upper bound, not a confirmed count."
    },
    "variants": {
      "type": "array",
      "description": "Anchor story first, then its likely variants.",
      "items": {
        "type": "object",
        "properties": {
          "event_id": {
            "type": "string",
            "description": "Stable id, e.g. evt_..."
          },
          "headline": {
            "type": [
              "string",
              "null"
            ]
          },
          "one_liner": {
            "type": [
              "string",
              "null"
            ]
          },
          "abstract": {
            "type": [
              "string",
              "null"
            ]
          },
          "event_type": {
            "type": [
              "string",
              "null"
            ],
            "description": "family.leaf taxonomy value, e.g. deals.merger_acquisition."
          },
          "content_type": {
            "type": [
              "string",
              "null"
            ]
          },
          "sector": {
            "type": [
              "string",
              "null"
            ]
          },
          "size": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Article count."
          },
          "source_count": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Publisher domains, mirrors included."
          },
          "newsrooms": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Independent newsrooms — the corroboration signal."
          },
          "reports": {
            "type": [
              "integer",
              "null"
            ]
          },
          "language_count": {
            "type": [
              "integer",
              "null"
            ]
          },
          "first_seen": {
            "type": [
              "string",
              "null"
            ],
            "description": "ISO 8601 UTC."
          },
          "last_seen": {
            "type": [
              "string",
              "null"
            ],
            "description": "ISO 8601 UTC."
          },
          "entities": {
            "type": "array",
            "description": "Key actors named in the story.",
            "items": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string"
                }
              },
              "additionalProperties": true
            }
          },
          "sources": {
            "type": "array",
            "description": "Source article URLs — a sample or the full list per verbosity.",
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": true
      }
    },
    "notes": {
      "type": "array",
      "description": "Query-normalization and plan-clamping notes to relay verbatim.",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "matched",
    "total_matching_stories",
    "anchor_newsrooms",
    "combined_newsrooms_upper_bound",
    "variants",
    "notes"
  ],
  "description": "Corroboration verdict for a claim.",
  "additionalProperties": false
}

Report what this caller may do right now — and never spend any of it to find out. Answers the questions the `news` tool descriptions cannot: how many searches are left this hour, how far back this plan reaches, the largest `limit` it allows, how many searches may run at once, and how long to wait if the budget is spent. These ceilings are per-plan and change without a release, so trust this over any number written into a description. Checking is free: the endpoint is exempt from every metering stage, so calling it does not consume an hourly call, a concurrency slot, or a credit. Reach for it before planning a batch of calls, and after any plan-limit or rate-limit error instead of guessing the ceiling that was hit.

{
  "type": "object",
  "properties": {
    "api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional NewsMCP API key. Report the ceilings for this key's plan; omit to report the keyless ceilings."
    },
    "response_format": {
      "default": "text",
      "description": "`text` (default) for a readable summary, `json` for the raw payload.",
      "enum": [
        "text",
        "json"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "result": {
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "x-fastmcp-wrap-result": true
}

Check whether the NewsMCP REST API is reachable and healthy. Does not require an API token. Use when diagnosing connectivity, not for searching news. For allowances and remaining budget use `check_limits` instead. Returns: str: Health status reported by the API.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "result": {
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "x-fastmcp-wrap-result": true
}