# typesearch

> News search for AI agents: recent news on any topic from outlets worldwide, by country and language.

- name: ai.typesearch/news
- version: 1.0.0
- connection class: R1 (autonomous)
- trust: 83/100 flags: no-repository
- quality: 92/100 (strong)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/ai.typesearch%2Fnews
- tools: https://api.protogrid.dev/v1/servers/ai.typesearch%2Fnews/tools

**An agent can connect on its own if it already holds `typesearch_api_key`.** Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "news": {
      "type": "http",
      "url": "https://api.typesearch.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${typesearch_api_key}"
      }
    }
  }
}
```

Placeholders to fill: `${typesearch_api_key}`.

## Trust

- hygiene: 80
- liveness: 100
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-100% +updated-25d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 92/100 (strong)

### protocol: 88 (weight 25)

- pass `protocol.modern`: supports 2026-07-28 (server/discover)
- pass `protocol.stateless`: answers without a session
- pass `protocol.transport`: streamable HTTP
- warn `protocol.list_ttl`: tools/list declares ttlMs 0, so clients re-fetch it on every use

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 93 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 4 of 4 tools declare readOnlyHint or destructiveHint
- warn `tools.directory_hints`: 1 of 4 tools declare all four hints; missing: search_news (destructiveHint, idempotentHint); get_contents (destructiveHint, idempotentHint); find_similar (destructiveHint, idempotentHint)
- pass `tools.token_cost`: about 2,151 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: 4 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 4, about 2,151 tokens to load them all
- tool set hash: 2fd0127bf4e60c5ecbe8f94427425f04
- tools last changed: 2026-09-27T00:33:28.052Z
- badge: [![protogrid quality](https://protogrid.dev/badge/ai.typesearch/news.svg)](https://protogrid.dev/servers/ai.typesearch/news)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-09-27 `create_chart` added
  - Turn a question into a chart card, without thinking about chart types: the standings of the latest race, poll or election results by candidate, wins in a season, coverage over time, share of voice between names, tone, the outlets that cover a topic most, what an outlet published, a timeline of a story, the figures the articles publish (a price, a rate), or data from a custom index. It works out what the user expects (`understood`, with other readings to pass as `interpretation`), verifies every value against its source, picks the chart, the key figures and a title that states the finding, and returns an image URL (show it to the user) and an embed URL. If the exact data is not published it shows the closest thing and says so (`rung`, warnings). It costs its search (the mode it needs, per query) plus US$0.50 per 1,000 charts; the same request within 10 minutes is free.
- 2026-09-26 `search_news` changed (inputSchema)
- 2026-09-26 `check_coverage` removed
  - Check whether a news domain is in the typesearch index (pass domain), or get the index coverage: how many sources and articles, by country and by language. Free.
- 2026-09-26 `search_news` changed (description, inputSchema)
  - before: Search recent news on any topic across a curated index of news outlets worldwide, judged by a relevance model. Returns the matching articles: title, link, source, date, country and language, standfirst, and short excerpts in the modes that read. Use it for current events and for what outlets reported about a company, person, place or topic. Defaults: mode "fast" (US$1.40 per 1,000 searches) and the last 7 days.
  - after: Search recent news on any topic across a curated index of news outlets worldwide, judged by a relevance model. Returns the matching articles: title, link, source, date, country and language, standfirst, and short excerpts in the modes that read. Use it for current events and for what outlets reported about a company, person, place or topic. Defaults: mode "fast" (US$1.40 per 1,000 searches) and the last 7 days; mode "ultra" judges headlines only, for US$1.00.

Full history: https://api.protogrid.dev/v1/servers/ai.typesearch%2Fnews/changes

## Remotes

- https://api.typesearch.ai/mcp (streamable-http, auth api_key ${typesearch_api_key}, reachable true, uptime30d 1)

## Packages

_none_

## Tools (4)

- `create_chart`: Turn a question into a chart card, without thinking about chart types: the standings of the latest race, poll or election results by candidate, wins in a season, coverage over time, share of voice between names, tone, the outlets that cover a topic most, what an outlet published, a timeline of a story, the figures the articles publish (a price, a rate), or data from a custom index. It works out what the user expects (`understood`, with other readings to pass as `interpretation`), verifies every value against its source, picks the chart, the key figures and a title that states the finding, and returns an image URL (show it to the user) and an embed URL. If the exact data is not published it shows the closest thing and says so (`rung`, warnings). It costs its search (the mode it needs, per query) plus US$0.50 per 1,000 charts; the same request within 10 minutes is free.
- `find_similar`: Find other news articles about the same story as a given article URL, across the index (the last 7 days by default). Useful to see how other outlets covered a story. US$2.20 per 1,000 calls.
- `get_contents`: Get the title, standfirst, date, source and a short verbatim excerpt (up to 25 words) of up to 10 news article URLs. With a query, the excerpt is the one about it and relevance says how much the article covers it. Never returns the full text. US$0.20 per 1,000 pages read (US$0.40 with a query); pages that fail are free.
- `search_news`: Search recent news on any topic across a curated index of news outlets worldwide, judged by a relevance model. Returns the matching articles: title, link, source, date, country and language, standfirst, and short excerpts in the modes that read. Use it for current events and for what outlets reported about a company, person, place or topic. Defaults: mode "fast" (US$1.40 per 1,000 searches) and the last 7 days; mode "ultra" judges headlines only, for US$1.00.
