Server definition
- Hash
- sha256:fdead881ab27777bdc1a6f4ad4ff94515fb14924ece43ab7f0924b0a884546d9
- What it is
- What a remote MCP server returned when asked what it offers: 4 tools
The blob, as servednamed by its sha256
{
"instructions": "typesearch is news search for AI agents: a curated index of news outlets worldwide, judged by a calibrated relevance model. Results carry title, link, source, date, country and language, and short excerpts, never full articles: cite the link.\n- search_news: news on a topic. mode \"ultra\" is the cheapest (US$1.00 per 1,000 searches) and judges headlines only; \"fast\" (the default, US$1.40) also judges standfirsts, just as quick; \"normal\" (US$2.20) reads the best matches; \"deep\" (US$5.60) reads more and also searches the topic in other words. Narrow it with days, published_after/before, include/exclude_domains, countries (ISO 3166-1 alpha-2) and languages (ISO 639-1). With index (idx_…), it searches the user's own custom index (their list of URLs) instead of the news index, at the same prices.\n- get_contents: title, standfirst, date and a short excerpt of up to 10 article URLs (US$0.20 per 1,000 pages; with query, the excerpt about it: US$0.40).\n- find_similar: other coverage of the story in an article URL (US$2.20 per 1,000).\n- create_chart: a chart card from a question in plain words (race standings, poll or election results, wins in a season, coverage over time, share of voice, tone, top outlets, a timeline, the figures articles publish, or custom index data). It picks the chart, the key figures and a title that states the finding, and returns an image URL and an embeddable URL. Show the image to the user. It costs its search (the mode, per query) plus US$0.50 per 1,000 charts.\nEvery call is billed to the API key at these list prices, like the REST API; cached results and failed calls are free.",
"tools": [
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"compare": {
"description": "What to compare, 2 to 5, if the query does not say it with \"vs\": [\"Milei\", \"Bullrich\"].",
"items": {
"maxLength": 80,
"type": "string"
},
"maxItems": 5,
"minItems": 2,
"type": "array"
},
"countries": {
"description": "Only sources from these countries: ISO 3166-1 alpha-2 codes, such as [\"AR\"] or [\"US\", \"GB\"].",
"items": {
"maxLength": 20,
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"days": {
"description": "Only the last N days, 1 to 365. By default it depends on the chart: 30 for coverage, 7 for figures.",
"maximum": 365,
"minimum": 1,
"type": "integer"
},
"index": {
"description": "Optional: chart your own custom index (idx_…) instead of the news: prices, ratings, availability, brands.",
"pattern": "^idx_[a-z0-9]{6,40}$",
"type": "string"
},
"interpretation": {
"description": "Optional: one of the `alternatives` of a previous call, to chart that reading of the query instead.",
"maxLength": 160,
"type": "string"
},
"languages": {
"description": "Only sources that publish in these languages: ISO 639-1 codes, such as [\"es\"] or [\"en\", \"pt\"].",
"items": {
"maxLength": 35,
"type": "string"
},
"maxItems": 20,
"minItems": 1,
"type": "array"
},
"query": {
"description": "What to chart, in plain words and any language: \"blue dollar this week\", \"Milei vs Bullrich coverage\", \"tone of the IMF coverage\", \"which outlets cover lithium\", or \"prices\" with index.",
"maxLength": 200,
"minLength": 2,
"type": "string"
},
"theme": {
"default": "light",
"description": "light (default), dark, editorial (warm paper) or electric (deep blue).",
"enum": [
"light",
"dark",
"editorial",
"electric"
],
"type": "string"
},
"type": {
"default": "auto",
"description": "auto (default) picks the chart that tells the data best. Or force one: line, area, bar, bar_horizontal, stacked_bar, pie, donut, scatter, funnel, timeline, kpi, table.",
"enum": [
"auto",
"line",
"area",
"bar",
"bar_horizontal",
"stacked_bar",
"pie",
"donut",
"scatter",
"funnel",
"timeline",
"kpi",
"table"
],
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "create_chart",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"alternatives": {
"description": "Other readings of the query: pass one as `interpretation` to chart it instead.",
"items": {
"type": "string"
},
"type": "array"
},
"cached": {
"const": true,
"type": "boolean"
},
"cost_usd": {
"type": "number"
},
"data": {
"description": "The values drawn (up to 40 per series).",
"items": {
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"points": {
"items": {
"additionalProperties": false,
"properties": {
"x": {
"type": [
"string",
"number"
]
},
"y": {
"type": "number"
}
},
"required": [
"x",
"y"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"name",
"points"
],
"type": "object"
},
"type": "array"
},
"embed_url": {
"description": "An iframe for a web page or app.",
"type": "string"
},
"events": {
"items": {
"additionalProperties": false,
"properties": {
"date": {
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"date",
"label"
],
"type": "object"
},
"type": "array"
},
"id": {
"type": "string"
},
"image_url": {
"description": "PNG: show it to the user.",
"type": "string"
},
"improving": {
"const": true,
"description": "Still looking for the exact data: the image and embed update themselves if it arrives.",
"type": "boolean"
},
"key_figures": {
"items": {
"additionalProperties": false,
"properties": {
"change": {
"type": "number"
},
"change_is_percent": {
"type": "boolean"
},
"label": {
"type": "string"
},
"value": {
"type": "number"
}
},
"required": [
"label",
"value"
],
"type": "object"
},
"type": "array"
},
"request_id": {
"type": "string"
},
"rung": {
"description": "exact (the data asked for), partial (a verified part), related, coverage or stories (the closest thing found).",
"type": "string"
},
"sources": {
"items": {
"additionalProperties": false,
"properties": {
"source": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"type": "array"
},
"subtitle": {
"type": "string"
},
"table": {
"description": "The rows of a table chart (up to 10), keyed by column label.",
"items": {
"additionalProperties": {
"type": [
"string",
"number",
"null"
]
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"type": "array"
},
"title": {
"description": "It states the finding.",
"type": "string"
},
"type": {
"type": "string"
},
"understood": {
"description": "What we understood the user expects to see.",
"type": "string"
},
"warnings": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"cost_usd",
"request_id"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"days": {
"description": "Only the last N days, 1 to 365. Defaults to 7.",
"maximum": 365,
"minimum": 1,
"type": "integer"
},
"max_results": {
"default": 10,
"description": "How many results, 1 to 25. Defaults to 10.",
"maximum": 25,
"minimum": 1,
"type": "integer"
},
"url": {
"description": "The article URL whose story to find elsewhere.",
"maxLength": 2000,
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "find_similar",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"cached": {
"const": true,
"type": "boolean"
},
"cost_usd": {
"type": "number"
},
"incomplete": {
"const": true,
"description": "The time or token budget ran out: there may be more.",
"type": "boolean"
},
"mode": {
"enum": [
"ultra",
"fast",
"normal",
"deep"
],
"type": "string"
},
"near_misses": {
"description": "Only when nothing matched: the closest articles, which may not be about it.",
"items": {
"additionalProperties": false,
"properties": {
"country": {
"type": "string"
},
"found_in": {
"description": "Only when it was not found in the index: where it came from.",
"enum": [
"homepage",
"section",
"site_search",
"discovery"
],
"type": "string"
},
"highlights": {
"description": "Short verbatim excerpts from reading the article.",
"items": {
"type": "string"
},
"type": "array"
},
"language": {
"type": "string"
},
"published_at": {
"description": "ISO 8601, UTC, to the minute.",
"type": "string"
},
"score": {
"description": "Probability that the article is about the query.",
"type": "number"
},
"snippet": {
"description": "The standfirst, as the outlet published it (shortened).",
"type": "string"
},
"source": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"title",
"url",
"score"
],
"type": "object"
},
"type": "array"
},
"reference": {
"additionalProperties": false,
"properties": {
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"title",
"url"
],
"type": "object"
},
"request_id": {
"type": "string"
},
"results": {
"items": {
"additionalProperties": false,
"properties": {
"country": {
"type": "string"
},
"found_in": {
"description": "Only when it was not found in the index: where it came from.",
"enum": [
"homepage",
"section",
"site_search",
"discovery"
],
"type": "string"
},
"highlights": {
"description": "Short verbatim excerpts from reading the article.",
"items": {
"type": "string"
},
"type": "array"
},
"language": {
"type": "string"
},
"published_at": {
"description": "ISO 8601, UTC, to the minute.",
"type": "string"
},
"score": {
"description": "Probability that the article is about the query.",
"type": "number"
},
"snippet": {
"description": "The standfirst, as the outlet published it (shortened).",
"type": "string"
},
"source": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"title",
"url",
"score"
],
"type": "object"
},
"type": "array"
},
"warnings": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"mode",
"results",
"cost_usd",
"request_id"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"query": {
"description": "Optional: the excerpt is then the one about this query, with a relevance score.",
"maxLength": 200,
"minLength": 2,
"type": "string"
},
"urls": {
"description": "Up to 10 article URLs, such as https://example.com/news/article.",
"items": {
"maxLength": 2000,
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
}
},
"required": [
"urls"
],
"type": "object"
},
"name": "get_contents",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"cost_usd": {
"type": "number"
},
"request_id": {
"type": "string"
},
"results": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"type": "string"
},
"error": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"excerpt": {
"type": "string"
},
"highlights": {
"items": {
"type": "string"
},
"type": "array"
},
"published_at": {
"type": "string"
},
"relevance": {
"type": "number"
},
"source": {
"type": "string"
},
"status": {
"enum": [
"ok",
"error"
],
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"url",
"status"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"results",
"cost_usd",
"request_id"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"countries": {
"description": "Only sources from these countries: ISO 3166-1 alpha-2 codes, such as [\"AR\"] or [\"US\", \"GB\"].",
"items": {
"maxLength": 20,
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"days": {
"description": "Only the last N days, 1 to 365. Defaults to 7 unless published_after or published_before are given.",
"maximum": 365,
"minimum": 1,
"type": "integer"
},
"exclude_domains": {
"description": "Never these domains or paths.",
"items": {
"maxLength": 200,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"include_domains": {
"description": "Only these domains or paths, such as example.com or example.com/sports.",
"items": {
"maxLength": 200,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"index": {
"description": "Optional: search your own custom index (its id, idx_…) instead of the news index: your own list of URLs, sitemap or feed, created at https://app.typesearch.ai/indexes or with POST /v1/indexes. Same modes and prices; no date filter unless you pass days or dates.",
"pattern": "^idx_[a-z0-9]{6,40}$",
"type": "string"
},
"languages": {
"description": "Only sources that publish in these languages: ISO 639-1 codes, such as [\"es\"] or [\"en\", \"pt\"].",
"items": {
"maxLength": 35,
"type": "string"
},
"maxItems": 20,
"minItems": 1,
"type": "array"
},
"max_results": {
"default": 10,
"description": "How many results, 1 to 25. Defaults to 10.",
"maximum": 25,
"minimum": 1,
"type": "integer"
},
"mode": {
"default": "fast",
"description": "fast (default): headlines and standfirsts · ultra (cheapest): headlines only · normal: also reads the best matches · deep: reads more, finds the topic in other words too.",
"enum": [
"ultra",
"fast",
"normal",
"deep"
],
"type": "string"
},
"published_after": {
"anyOf": [
{
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"type": "string"
},
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"type": "string"
}
],
"description": "Published on or after this date: 2026-09-25, or a date-time with offset."
},
"published_before": {
"anyOf": [
{
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"type": "string"
},
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"type": "string"
}
],
"description": "Published on or before this date; a bare date includes that whole day."
},
"query": {
"description": "What to look for, in any language: a topic, event, person, company or place, such as \"inflation in Argentina\" or \"OpenAI funding\".",
"maxLength": 200,
"minLength": 2,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_news",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"cached": {
"const": true,
"type": "boolean"
},
"cost_usd": {
"type": "number"
},
"incomplete": {
"const": true,
"description": "The time or token budget ran out: there may be more.",
"type": "boolean"
},
"mode": {
"enum": [
"ultra",
"fast",
"normal",
"deep"
],
"type": "string"
},
"near_misses": {
"description": "Only when nothing matched: the closest articles, which may not be about it.",
"items": {
"additionalProperties": false,
"properties": {
"country": {
"type": "string"
},
"found_in": {
"description": "Only when it was not found in the index: where it came from.",
"enum": [
"homepage",
"section",
"site_search",
"discovery"
],
"type": "string"
},
"highlights": {
"description": "Short verbatim excerpts from reading the article.",
"items": {
"type": "string"
},
"type": "array"
},
"language": {
"type": "string"
},
"published_at": {
"description": "ISO 8601, UTC, to the minute.",
"type": "string"
},
"score": {
"description": "Probability that the article is about the query.",
"type": "number"
},
"snippet": {
"description": "The standfirst, as the outlet published it (shortened).",
"type": "string"
},
"source": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"title",
"url",
"score"
],
"type": "object"
},
"type": "array"
},
"query": {
"type": "string"
},
"request_id": {
"type": "string"
},
"results": {
"items": {
"additionalProperties": false,
"properties": {
"country": {
"type": "string"
},
"found_in": {
"description": "Only when it was not found in the index: where it came from.",
"enum": [
"homepage",
"section",
"site_search",
"discovery"
],
"type": "string"
},
"highlights": {
"description": "Short verbatim excerpts from reading the article.",
"items": {
"type": "string"
},
"type": "array"
},
"language": {
"type": "string"
},
"published_at": {
"description": "ISO 8601, UTC, to the minute.",
"type": "string"
},
"score": {
"description": "Probability that the article is about the query.",
"type": "number"
},
"snippet": {
"description": "The standfirst, as the outlet published it (shortened).",
"type": "string"
},
"source": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"title",
"url",
"score"
],
"type": "object"
},
"type": "array"
},
"warnings": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"query",
"mode",
"results",
"cost_usd",
"request_id"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:fdead881ab27777bdc1a6f4ad4ff94515fb14924ece43ab7f0924b0a884546d9 | sha256sum