Clarity Today
Clarity Today's briefing, latest stories by desk, search and full source-linked stories.
Should I use this
Quality & Safety
A
Findings (1)
- LOWTool 'fetch' suggests web access but openWorldHint=falsein fetch
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~2,975Tokens (tool definitions)
~6.4 KBTypical response size
Significant attention impact (2.32% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"clarity-today": {
"url": "https://theclarity.today/mcp"
}
}
}Remote endpoints
https://theclarity.today/mcpstreamable-httpWhat it can do
Tool inventory
Tools (5)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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.
Input Schema
{
"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"
}Output 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.
Input Schema
{
"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"
}Output 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.
Input Schema
{
"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"
}Output 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.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output 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.
Input Schema
{
"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"
}Output 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
}Community
Evidence
Recent observations
verifiedversion not recorded5 tools