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=falsefetch에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
~2,975토큰 (도구 정의)
~6.4 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 2.32%)
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`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개