Clarity Today
Clarity Today's briefing, latest stories by desk, search and full source-linked stories.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (1)
- LOWen fetch
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"clarity-today": {
"url": "https://theclarity.today/mcp"
}
}
}Puntos de conexión remotos
https://theclarity.today/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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.
Esquema de entrada
{
"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"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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"
}Esquema de salida
{
"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.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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"
}Esquema de salida
{
"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
}Comunidad
Evidencia