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 個工具