Clarity Today
Clarity Today's briefing, latest stories by desk, search and full source-linked stories.
我该使用它吗
质量与安全性
A
发现（1）
- LOWTool 'fetch' suggests web access but openWorldHint=false在 fetch 中
基于对工具定义和协议合规性的自动分析。
上下文开销
~2,975token 数（工具定义）
~6.4 KB典型响应大小
对注意力有显著影响（占 128k 上下文窗口的 2.32%）
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"clarity-today": {
"url": "https://theclarity.today/mcp"
}
}
}远程端点
https://theclarity.today/mcpstreamable-http它能做什么
工具清单
工具（5）
🟢 只读🟡 写入🔴 删除⚪ 未知
🟢search(query)
Find Clarity Today stories about a subject. Returns up to 12 matching stories, newest first, each with its URL and how many independent publishers back it. Pass a result’s id to fetch to read the whole story.
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "1–4 distinctive keywords: a company, product, person, vulnerability or technology. Matches story headlines and summaries."
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}输出模式
{
"type": "object",
"properties": {
"results": {
"maxItems": 12,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The story id (its slug). Pass it to fetch for the full story."
},
"title": {
"type": "string"
},
"url": {
"type": "string",
"description": "The story page. Link it whenever you use the story."
},
"desk": {
"type": "string",
"enum": [
"security",
"build",
"invest",
"product",
"leadership",
"science"
]
},
"desk_name": {
"type": "string"
},
"summary": {
"type": "string"
},
"published_at": {
"type": "string",
"description": "ISO 8601."
},
"updated_at": {
"description": "ISO 8601, when known.",
"type": "string"
},
"publishers": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Independent publishers whose reporting the story is built from."
},
"corroboration": {
"type": "string",
"enum": [
"single-source",
"corroborated"
],
"description": "single-source below two independent publishers: present it as a report, not a confirmed fact."
}
},
"required": [
"id",
"title",
"url",
"desk",
"desk_name",
"summary",
"published_at",
"publishers",
"corroboration"
],
"additionalProperties": false
}
}
},
"required": [
"results"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢fetch(id)
Read one Clarity Today story in full, as Markdown: what happened, why it matters, what to watch, the claim ledger tying each claim to its source, and every publisher the story draws on.
输入模式
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 2048,
"description": "A story id from search, the briefing or the latest stories, or a https://theclarity.today/story/<slug> URL."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}输出模式
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"text": {
"type": "string",
"description": "The story as Markdown, ending with the URL to cite."
},
"url": {
"type": "string"
},
"metadata": {
"type": "object",
"properties": {
"desk": {
"type": "string",
"enum": [
"security",
"build",
"invest",
"product",
"leadership",
"science"
]
},
"desk_name": {
"type": "string"
},
"published_at": {
"type": "string"
},
"updated_at": {
"type": "string"
},
"publishers": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"corroboration": {
"type": "string",
"enum": [
"single-source",
"corroborated"
]
},
"claim_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"source_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"correction": {
"type": "boolean",
"description": "True when the story carries a published correction (it is in the text)."
}
},
"required": [
"desk",
"desk_name",
"published_at",
"updated_at",
"publishers",
"corroboration",
"claim_count",
"source_count",
"correction"
],
"additionalProperties": false
}
},
"required": [
"id",
"title",
"text",
"url",
"metadata"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_story(id)
Show one Clarity Today story as its evidence card: what changed and why it matters, the story’s own figure, each claim with the verifier’s verdict and its source, and the publishers behind it. Use it when the reader wants to see a story or check it; use fetch to read a story’s text for an answer.
输入模式
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 2048,
"description": "A story id from search, the briefing or the latest stories, or a https://theclarity.today/story/<slug> URL."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}输出模式
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The story id (its slug). Pass it to fetch for the full story."
},
"title": {
"type": "string"
},
"url": {
"type": "string",
"description": "The story page. Link it whenever you use the story."
},
"desk": {
"type": "string",
"enum": [
"security",
"build",
"invest",
"product",
"leadership",
"science"
]
},
"desk_name": {
"type": "string"
},
"summary": {
"type": "string"
},
"published_at": {
"type": "string",
"description": "ISO 8601."
},
"updated_at": {
"type": "string",
"description": "ISO 8601."
},
"publishers": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Independent publishers whose reporting the story is built from."
},
"corroboration": {
"type": "string",
"enum": [
"single-source",
"corroborated"
],
"description": "single-source below two independent publishers: present it as a report, not a confirmed fact."
},
"confirmation": {
"type": "string",
"description": "What the story’s record is worth, in the story page’s own words (“Widely confirmed”, “Not yet confirmed elsewhere”). Lead with it; publishers is the proof."
},
"confirmation_kind": {
"type": "string",
"enum": [
"disputed",
"wide",
"confirmed",
"reported",
"single",
"unrecorded"
]
},
"correction": {
"anyOf": [
{
"type": "object",
"properties": {
"note": {
"type": "string"
},
"corrected_at": {
"type": "string"
}
},
"required": [
"note",
"corrected_at"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"what_happened": {
"type": "array",
"items": {
"type": "string"
}
},
"why_it_matters": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string"
},
"line": {
"type": "string"
}
},
"required": [
"kind",
"line"
],
"additionalProperties": false
}
},
"watch_next": {
"type": "array",
"items": {
"type": "string"
},
"description": "Open questions the story says to watch."
},
"claim_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Claims in the story’s full ledger."
},
"claims": {
"type": "array",
"items": {
"type": "object",
"properties": {
"number": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991,
"description": "The claim’s number on the story page (its ledger row)."
},
"ref": {
"description": "The citation ref the visual’s data points name.",
"type": [
"string",
"null"
]
},
"text": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"reported",
"derived"
],
"description": "derived: worked out from reported claims."
},
"state": {
"anyOf": [
{
"type": "string",
"enum": [
"supported",
"contested",
"insufficient"
]
},
{
"type": "null"
}
],
"description": "The verifier’s verdict; null while the story has not been checked."
},
"source": {
"type": [
"string",
"null"
]
},
"source_url": {
"type": [
"string",
"null"
]
}
},
"required": [
"number",
"ref",
"text",
"kind",
"state",
"source",
"source_url"
],
"additionalProperties": false
},
"description": "The ledger in the story page’s order, up to 60 claims."
},
"visual": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
],
"description": "The story’s stored evidence visual (the publication’s story-visual catalog), exactly as published; null when it has none."
},
"source_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"publisher": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"publisher",
"title",
"url"
],
"additionalProperties": false
},
"description": "Up to 30 of the publishers the story draws on."
}
},
"required": [
"id",
"title",
"url",
"desk",
"desk_name",
"summary",
"published_at",
"updated_at",
"publishers",
"corroboration",
"confirmation",
"confirmation_kind",
"correction",
"what_happened",
"why_it_matters",
"watch_next",
"claim_count",
"claims",
"visual",
"source_count",
"sources"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_todays_briefing
Today’s Briefing: the handful of stories Clarity’s desks ranked most important right now, each with its key verified points.
输入模式
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}输出模式
{
"type": "object",
"properties": {
"built_at": {
"type": "string",
"description": "When the briefing was assembled, ISO 8601."
},
"stories": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The story id (its slug). Pass it to fetch for the full story."
},
"title": {
"type": "string"
},
"url": {
"type": "string",
"description": "The story page. Link it whenever you use the story."
},
"desk": {
"type": "string",
"enum": [
"security",
"build",
"invest",
"product",
"leadership",
"science"
]
},
"desk_name": {
"type": "string"
},
"summary": {
"type": "string"
},
"published_at": {
"type": "string",
"description": "ISO 8601."
},
"updated_at": {
"description": "ISO 8601, when known.",
"type": "string"
},
"publishers": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Independent publishers whose reporting the story is built from."
},
"corroboration": {
"type": "string",
"enum": [
"single-source",
"corroborated"
],
"description": "single-source below two independent publishers: present it as a report, not a confirmed fact."
},
"key_points": {
"type": "array",
"items": {
"type": "string"
},
"description": "The story’s leading “What happened” points, in the desk’s order."
},
"claim_count": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Sourced claims in the story’s claim ledger."
},
"reading_minutes": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"id",
"title",
"url",
"desk",
"desk_name",
"summary",
"published_at",
"publishers",
"corroboration",
"key_points",
"claim_count",
"reading_minutes"
],
"additionalProperties": false
}
},
"url": {
"type": "string"
}
},
"required": [
"built_at",
"stories",
"url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢list_latest_stories(desk, limit)
The newest Clarity Today stories, newest first: across every desk, or from one desk.
输入模式
{
"type": "object",
"properties": {
"desk": {
"description": "One desk; omit for every desk. security — Security desk (security): Reads the advisories so you don't have to. build — Build desk (engineering): What changed in the platforms and tools you ship on. invest — Invest desk (markets): Where the money moved and what the move implies. product — Product desk (product): Enterprise software as users experience it. leadership — Leadership desk (leadership): The operating decisions executives make under real constraint, and what each one costs. science — Science desk (science): The paper, not the press release.",
"type": "string",
"enum": [
"security",
"build",
"invest",
"product",
"leadership",
"science"
]
},
"limit": {
"description": "How many stories, 1–25. Default 10.",
"type": "integer",
"minimum": 1,
"maximum": 25
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}输出模式
{
"type": "object",
"properties": {
"desk": {
"anyOf": [
{
"type": "string",
"enum": [
"security",
"build",
"invest",
"product",
"leadership",
"science"
]
},
{
"type": "null"
}
]
},
"stories": {
"maxItems": 25,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The story id (its slug). Pass it to fetch for the full story."
},
"title": {
"type": "string"
},
"url": {
"type": "string",
"description": "The story page. Link it whenever you use the story."
},
"desk": {
"type": "string",
"enum": [
"security",
"build",
"invest",
"product",
"leadership",
"science"
]
},
"desk_name": {
"type": "string"
},
"summary": {
"type": "string"
},
"published_at": {
"type": "string",
"description": "ISO 8601."
},
"updated_at": {
"description": "ISO 8601, when known.",
"type": "string"
},
"publishers": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Independent publishers whose reporting the story is built from."
},
"corroboration": {
"type": "string",
"enum": [
"single-source",
"corroborated"
],
"description": "single-source below two independent publishers: present it as a report, not a confirmed fact."
}
},
"required": [
"id",
"title",
"url",
"desk",
"desk_name",
"summary",
"published_at",
"publishers",
"corroboration"
],
"additionalProperties": false
}
},
"url": {
"type": "string",
"description": "The page listing these stories."
}
},
"required": [
"desk",
"stories",
"url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}社区
证据
最近观测
已验证未记录版本5 个工具