How to Read the Future
Read released episodes, transcripts, citations, clips, reading trails, and flashcards.
¿Debería usar esto?
Calidad y seguridad
A
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~8,251Tokens (definiciones de herramientas)
~15.7 KBTamaño de respuesta típico
Impacto significativo en la atención (6.45% del contexto de 128k)
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": {
"podcast": {
"url": "https://howtoreadthefuture.com/mcp"
}
}
}Puntos de conexión remotos
https://howtoreadthefuture.com/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (6)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢get_episode(slug)
Get one episode and its chapter metadata by slug.
Esquema de entrada
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"maxLength": 160
}
},
"required": [
"slug"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"const": "htrtf.mcp-tool-result.v1"
},
"operation": {
"type": "string",
"const": "get_episode"
},
"data": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"slug": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"maxLength": 160
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"subtitle": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"guest": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"description": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"canonical_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"publication_date": {
"type": "string",
"format": "date-time"
},
"duration_seconds": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 86400
},
"topics": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"maxItems": 40
},
"chapters": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9]+(?:[-.][a-z0-9]+)*$",
"maxLength": 160
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"summary": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"start_ms": {
"type": "integer",
"minimum": 0
},
"end_ms": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"required": [
"id",
"title",
"summary",
"start_ms",
"end_ms"
],
"additionalProperties": false
},
"maxItems": 100
}
},
"required": [
"id",
"slug",
"title",
"subtitle",
"guest",
"description",
"canonical_url",
"publication_date",
"duration_seconds",
"topics",
"chapters"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"const": "htrtf.canonical-metadata.v1"
},
"release_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,159}$"
},
"manifest_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"snapshot_sha256": {
"$ref": "#/properties/meta/properties/manifest_sha256"
},
"release_sha256": {
"$ref": "#/properties/meta/properties/manifest_sha256"
},
"content_version": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"transcript_version": {
"$ref": "#/properties/meta/properties/content_version"
},
"artifact_manifest_sha256": {
"$ref": "#/properties/meta/properties/manifest_sha256"
},
"artifact_sha256": {
"$ref": "#/properties/meta/properties/manifest_sha256"
},
"correction_state": {
"type": "string",
"enum": [
"current",
"corrected",
"withdrawn"
]
},
"canonical_url": {
"$ref": "#/properties/data/properties/canonical_url"
},
"surface_version": {
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"const": "htrtf.surface-version.v1"
},
"surface": {
"type": "string",
"const": "mcp"
},
"release_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,159}$"
},
"content_version": {
"$ref": "#/properties/meta/properties/content_version"
},
"transcript_version": {
"$ref": "#/properties/meta/properties/content_version"
},
"artifact_manifest_hash": {
"$ref": "#/properties/meta/properties/manifest_sha256"
},
"correction_status": {
"type": "string",
"enum": [
"current",
"corrected",
"withdrawn"
]
}
},
"required": [
"schema_version",
"surface",
"release_id",
"content_version",
"transcript_version",
"artifact_manifest_hash",
"correction_status"
],
"additionalProperties": false
},
"rights": {
"type": "object",
"properties": {
"search": {
"type": "string",
"const": "allowed"
},
"retrieval": {
"type": "string",
"const": "allowed"
},
"quotation": {
"type": "string",
"const": "allowed_with_attribution"
},
"attribution": {
"type": "string",
"const": "required"
},
"model_training": {
"type": "string",
"const": "reserved"
},
"policy_url": {
"$ref": "#/properties/data/properties/canonical_url"
}
},
"required": [
"search",
"retrieval",
"quotation",
"attribution",
"model_training",
"policy_url"
],
"additionalProperties": false
}
},
"required": [
"schema_version",
"release_id",
"manifest_sha256",
"canonical_url",
"rights"
],
"additionalProperties": false
}
},
"required": [
"schema_version",
"operation",
"data",
"meta"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_transcript_segment(episode, start_ms, end_ms)
Get transcript turns overlapping an optional window of at most five minutes, with exact timestamps. Defaults to 00:00–03:00 so the first call stays within the response limit.
Esquema de entrada
{
"type": "object",
"properties": {
"episode": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"maxLength": 160
},
"start_ms": {
"type": "integer",
"minimum": 0
},
"end_ms": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"required": [
"episode"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"const": "htrtf.mcp-tool-result.v1"
},
"operation": {
"type": "string",
"const": "get_transcript_segment"
},
"data": {
"type": "object",
"properties": {
"episode_slug": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"maxLength": 160
},
"start_ms": {
"type": "integer",
"minimum": 0
},
"end_ms": {
"type": "integer",
"exclusiveMinimum": 0
},
"turns": {
"type": "array",
"items": {
"type": "object",
"properties": {
"turn_id": {
"type": "string",
"pattern": "^turn-[0-9]{4}$"
},
"speaker": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"start_ms": {
"type": "integer",
"minimum": 0
},
"end_ms": {
"type": "integer",
"exclusiveMinimum": 0
},
"text": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"citation": {
"type": "object",
"properties": {
"canonical_url": {
"type": "string",
"format": "uri"
},
"episode_slug": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
},
"episode_title": {
"type": "string",
"minLength": 1
},
"speaker": {
"type": "string",
"minLength": 1
},
"start_ms": {
"type": "integer",
"minimum": 0
},
"end_ms": {
"type": "integer",
"exclusiveMinimum": 0
},
"turn_id": {
"type": "string",
"pattern": "^turn-[0-9]{4}$"
},
"transcript_version": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"content_version": {
"type": "string",
"pattern": "^[a-z0-9]+(?:[-.][a-z0-9]+)*$"
},
"citation_text": {
"type": "string",
"minLength": 1
}
},
"required": [
"canonical_url",
"episode_slug",
"episode_title",
"speaker",
"start_ms",
"end_ms",
"turn_id",
"transcript_version",
"content_version",
"citation_text"
],
"additionalProperties": false
}
},
"required": [
"turn_id",
"speaker",
"start_ms",
"end_ms",
"text",
"citation"
],
"additionalProperties": false
},
"maxItems": 250
}
},
"required": [
"episode_slug",
"start_ms",
"end_ms",
"turns"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"const": "htrtf.canonical-metadata.v1"
},
"release_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,159}$"
},
"manifest_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"snapshot_sha256": {
"$ref": "#/properties/meta/properties/manifest_sha256"
},
"release_sha256": {
"$ref": "#/properties/meta/properties/manifest_sha256"
},
"content_version": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"transcript_version": {
"$ref": "#/properties/meta/properties/content_version"
},
"artifact_manifest_sha256": {
"$ref": "#/properties/meta/properties/manifest_sha256"
},
"artifact_sha256": {
"$ref": "#/properties/meta/properties/manifest_sha256"
},
"correction_state": {
"type": "string",
"enum": [
"current",
"corrected",
"withdrawn"
]
},
"canonical_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"surface_version": {
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"const": "htrtf.surface-version.v1"
},
"surface": {
"type": "string",
"const": "mcp"
},
"release_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,159}$"
},
"content_version": {
"$ref": "#/properties/meta/properties/content_version"
},
"transcript_version": {
"$ref": "#/properties/meta/properties/content_version"
},
"artifact_manifest_hash": {
"$ref": "#/properties/meta/properties/manifest_sha256"
},
"correction_status": {
"type": "string",
"enum": [
"current",
"corrected",
"withdrawn"
]
}
},
"required": [
"schema_version",
"surface",
"release_id",
"content_version",
"transcript_version",
"artifact_manifest_hash",
"correction_status"
],
"additionalProperties": false
},
"rights": {
"type": "object",
"properties": {
"search": {
"type": "string",
"const": "allowed"
},
"retrieval": {
"type": "string",
"const": "allowed"
},
"quotation": {
"type": "string",
"const": "allowed_with_attribution"
},
"attribution": {
"type": "string",
"const": "required"
},
"model_training": {
"type": "string",
"const": "reserved"
},
"policy_url": {
"$ref": "#/properties/meta/properties/canonical_url"
}
},
"required": [
"search",
"retrieval",
"quotation",
"attribution",
"model_training",
"policy_url"
],
"additionalProperties": false
}
},
"required": [
"schema_version",
"release_id",
"manifest_sha256",
"canonical_url",
"rights"
],
"additionalProperties": false
}
},
"required": [
"schema_version",
"operation",
"data",
"meta"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_episode_clips(slug, cursor, limit)
List clips for an episode, including citations, media details, and publication state.
Esquema de entrada
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"maxLength": 160
},
"cursor": {
"type": "string",
"minLength": 1,
"maxLength": 1024
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 1,
"default": 1
}
},
"required": [
"slug"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"const": "htrtf.mcp-tool-result.v1"
},
"operation": {
"type": "string",
"const": "list_episode_clips"
},
"data": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"const": "htrtf.public-clip.v1"
},
"id": {
"type": "string",
"pattern": "^[a-z0-9]+(?:[-.][a-z0-9]+)*$",
"maxLength": 160
},
"canonical_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"episode": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"slug": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"maxLength": 160
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"canonical_url": {
"$ref": "#/properties/data/properties/items/items/properties/canonical_url"
}
},
"required": [
"id",
"slug",
"title",
"canonical_url"
],
"additionalProperties": false
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"hook": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"transcript": {
"type": "object",
"properties": {
"start_ms": {
"type": "integer",
"minimum": 0
},
"end_ms": {
"type": "integer",
"exclusiveMinimum": 0
},
"turn_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^turn-[0-9]{4}$"
},
"minItems": 1,
"maxItems": 200
},
"citations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"canonical_url": {
"type": "string",
"format": "uri"
},
"episode_slug": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
},
"episode_title": {
"type": "string",
"minLength": 1
},
"speaker": {
"type": "string",
"minLength": 1
},
"start_ms": {
"type": "integer",
"minimum": 0
},
"end_ms": {
"type": "integer",
"exclusiveMinimum": 0
},
"turn_id": {
"type": "string",
"pattern": "^turn-[0-9]{4}$"
},
"transcript_version": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"content_version": {
"type": "string",
"pattern": "^[a-z0-9]+(?:[-.][a-z0-9]+)*$"
},
"citation_text": {
"type": "string",
"minLength": 1
}
},
"required": [
"canonical_url",
"episode_slug",
"episode_title",
"speaker",
"start_ms",
"end_ms",
"turn_id",
"transcript_version",
"content_version",
"citation_text"
],
"additionalProperties": false
},
"minItems": 1,
"maxItems": 200
}
},
"required": [
"start_ms",
"end_ms",
"turn_ids",
"citations"
],
"additionalProperties": false
},
"companion_references": {
"type": "array",
"items": {
"type": "object",
"properties": {
"target_type": {
"type": "string",
"enum": [
"chapter",
"key_idea",
"reference",
"notable_segment",
"card"
]
},
"target_id": {
"$ref": "#/properties/data/properties/items/items/properties/id"
},
"canonical_url": {
"$ref": "#/properties/data/properties/items/items/properties/canonical_url"
}
},
"required": [
"target_type",
"target_id",
"canonical_url"
],
"additionalProperties": false
},
"maxItems": 40
},
"media": {
"type": "object",
"properties": {
"url": {
"$ref": "#/properties/data/properties/items/items/properties/canonical_url"
},
"key": {
"type": "string",
"minLength": 1,
"maxLength": 1024
},
"mime": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"bytes": {
"type": "integer",
"exclusiveMinimum": 0
},
"sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"required": [
"url",
"key",
"mime",
"bytes",
"sha256"
],
"additionalProperties": false
},
"publications": {
"type": "array",
"items": {
"type": "object",
"properties": {
"platform": {
"type": "string",
"enum": [
"x",
"youtube"
]
},
"status": {
"type": "string",
"enum": [
"not_posted",
"published",
"failed"
]
},
"url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"published_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"$ref": "#/properties/data/properties/items/items/properties/publications/items/properties/published_at"
}
},
"required": [
"platform",
"status",
"updated_at"
],
"additionalProperties": false
},
"maxItems": 2
},
"release_evidence": {
"type": "object",
"properties": {
"release_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,159}$"
},
"release_sha256": {
"$ref": "#/properties/data/properties/items/items/properties/media/properties/sha256"
},
"content_version": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"transcript_version": {
"$ref": "#/properties/data/properties/items/items/properties/release_evidence/properties/content_version"
},
"artifact_manifest_sha256": {
"$ref": "#/properties/data/properties/items/items/properties/media/properties/sha256"
},
"correction_status": {
"type": "string",
"enum": [
"current",
"corrected"
]
}
},
"required": [
"release_id",
"release_sha256",
"content_version",
"transcript_version",
"artifact_manifest_sha256",
"correction_status"
],
"additionalProperties": false
}
},
"required": [
"schema_version",
"id",
"canonical_url",
"episode",
"title",
"hook",
"transcript",
"companion_references",
"media",
"publications",
"release_evidence"
],
"additionalProperties": false
},
"maxItems": 50
},
"total": {
"type": "integer",
"minimum": 0
},
"next_cursor": {
"type": "string",
"minLength": 1,
"maxLength": 1024
}
},
"required": [
"items",
"total"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"const": "htrtf.canonical-metadata.v1"
},
"release_id": {
"$ref": "#/properties/data/properties/items/items/properties/release_evidence/properties/release_id"
},
"manifest_sha256": {
"$ref": "#/properties/data/properties/items/items/properties/media/properties/sha256"
},
"snapshot_sha256": {
"$ref": "#/properties/data/properties/items/items/properties/media/properties/sha256"
},
"release_sha256": {
"$ref": "#/properties/data/properties/items/items/properties/media/properties/sha256"
},
"content_version": {
"$ref": "#/properties/data/properties/items/items/properties/release_evidence/properties/content_version"
},
"transcript_version": {
"$ref": "#/properties/data/properties/items/items/properties/release_evidence/properties/content_version"
},
"artifact_manifest_sha256": {
"$ref": "#/properties/data/properties/items/items/properties/media/properties/sha256"
},
"artifact_sha256": {
"$ref": "#/properties/data/properties/items/items/properties/media/properties/sha256"
},
"correction_state": {
"type": "string",
"enum": [
"current",
"corrected",
"withdrawn"
]
},
"canonical_url": {
"$ref": "#/properties/data/properties/items/items/properties/canonical_url"
},
"surface_version": {
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"const": "htrtf.surface-version.v1"
},
"surface": {
"type": "string",
"const": "mcp"
},
"release_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,159}$"
},
"content_version": {
"$ref": "#/properties/data/properties/items/items/properties/release_evidence/properties/content_version"
},
"transcript_version": {
"$ref": "#/properties/data/properties/items/items/properties/release_evidence/properties/content_version"
},
"artifact_manifest_hash": {
"$ref": "#/properties/data/properties/items/items/properties/media/properties/sha256"
},
"correction_status": {
"type": "string",
"enum": [
"current",
"corrected",
"withdrawn"
]
}
},
"required": [
"schema_version",
"surface",
"release_id",
"content_version",
"transcript_version",
"artifact_manifest_hash",
"correction_status"
],
"additionalProperties": false
},
"rights": {
"type": "object",
"properties": {
"search": {
"type": "string",
"const": "allowed"
},
"retrieval": {
"type": "string",
"const": "allowed"
},
"quotation": {
"type": "string",
"const": "allowed_with_attribution"
},
"attribution": {
"type": "string",
"const": "required"
},
"model_training": {
"type": "string",
"const": "reserved"
},
"policy_url": {
"$ref": "#/properties/data/properties/items/items/properties/canonical_url"
}
},
"required": [
"search",
"retrieval",
"quotation",
"attribution",
"model_training",
"policy_url"
],
"additionalProperties": false
}
},
"required": [
"schema_version",
"release_id",
"manifest_sha256",
"canonical_url",
"rights"
],
"additionalProperties": false
}
},
"required": [
"schema_version",
"operation",
"data",
"meta"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_clip(id)
Get one clip by ID with its URL, transcript, media, and publication details.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9]+(?:[-.][a-z0-9]+)*$",
"maxLength": 160
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"const": "htrtf.mcp-tool-result.v1"
},
"operation": {
"type": "string",
"const": "get_clip"
},
"data": {
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"const": "htrtf.public-clip.v1"
},
"id": {
"type": "string",
"pattern": "^[a-z0-9]+(?:[-.][a-z0-9]+)*$",
"maxLength": 160
},
"canonical_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"episode": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"slug": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"maxLength": 160
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"canonical_url": {
"$ref": "#/properties/data/properties/canonical_url"
}
},
"required": [
"id",
"slug",
"title",
"canonical_url"
],
"additionalProperties": false
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"hook": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"transcript": {
"type": "object",
"properties": {
"start_ms": {
"type": "integer",
"minimum": 0
},
"end_ms": {
"type": "integer",
"exclusiveMinimum": 0
},
"turn_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^turn-[0-9]{4}$"
},
"minItems": 1,
"maxItems": 200
},
"citations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"canonical_url": {
"type": "string",
"format": "uri"
},
"episode_slug": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
},
"episode_title": {
"type": "string",
"minLength": 1
},
"speaker": {
"type": "string",
"minLength": 1
},
"start_ms": {
"type": "integer",
"minimum": 0
},
"end_ms": {
"type": "integer",
"exclusiveMinimum": 0
},
"turn_id": {
"type": "string",
"pattern": "^turn-[0-9]{4}$"
},
"transcript_version": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"content_version": {
"type": "string",
"pattern": "^[a-z0-9]+(?:[-.][a-z0-9]+)*$"
},
"citation_text": {
"type": "string",
"minLength": 1
}
},
"required": [
"canonical_url",
"episode_slug",
"episode_title",
"speaker",
"start_ms",
"end_ms",
"turn_id",
"transcript_version",
"content_version",
"citation_text"
],
"additionalProperties": false
},
"minItems": 1,
"maxItems": 200
}
},
"required": [
"start_ms",
"end_ms",
"turn_ids",
"citations"
],
"additionalProperties": false
},
"companion_references": {
"type": "array",
"items": {
"type": "object",
"properties": {
"target_type": {
"type": "string",
"enum": [
"chapter",
"key_idea",
"reference",
"notable_segment",
"card"
]
},
"target_id": {
"$ref": "#/properties/data/properties/id"
},
"canonical_url": {
"$ref": "#/properties/data/properties/canonical_url"
}
},
"required": [
"target_type",
"target_id",
"canonical_url"
],
"additionalProperties": false
},
"maxItems": 40
},
"media": {
"type": "object",
"properties": {
"url": {
"$ref": "#/properties/data/properties/canonical_url"
},
"key": {
"type": "string",
"minLength": 1,
"maxLength": 1024
},
"mime": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"bytes": {
"type": "integer",
"exclusiveMinimum": 0
},
"sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"required": [
"url",
"key",
"mime",
"bytes",
"sha256"
],
"additionalProperties": false
},
"publications": {
"type": "array",
"items": {
"type": "object",
"properties": {
"platform": {
"type": "string",
"enum": [
"x",
"youtube"
]
},
"status": {
"type": "string",
"enum": [
"not_posted",
"published",
"failed"
]
},
"url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"published_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"$ref": "#/properties/data/properties/publications/items/properties/published_at"
}
},
"required": [
"platform",
"status",
"updated_at"
],
"additionalProperties": false
},
"maxItems": 2
},
"release_evidence": {
"type": "object",
"properties": {
"release_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,159}$"
},
"release_sha256": {
"$ref": "#/properties/data/properties/media/properties/sha256"
},
"content_version": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"transcript_version": {
"$ref": "#/properties/data/properties/release_evidence/properties/content_version"
},
"artifact_manifest_sha256": {
"$ref": "#/properties/data/properties/media/properties/sha256"
},
"correction_status": {
"type": "string",
"enum": [
"current",
"corrected"
]
}
},
"required": [
"release_id",
"release_sha256",
"content_version",
"transcript_version",
"artifact_manifest_sha256",
"correction_status"
],
"additionalProperties": false
}
},
"required": [
"schema_version",
"id",
"canonical_url",
"episode",
"title",
"hook",
"transcript",
"companion_references",
"media",
"publications",
"release_evidence"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"const": "htrtf.canonical-metadata.v1"
},
"release_id": {
"$ref": "#/properties/data/properties/release_evidence/properties/release_id"
},
"manifest_sha256": {
"$ref": "#/properties/data/properties/media/properties/sha256"
},
"snapshot_sha256": {
"$ref": "#/properties/data/properties/media/properties/sha256"
},
"release_sha256": {
"$ref": "#/properties/data/properties/media/properties/sha256"
},
"content_version": {
"$ref": "#/properties/data/properties/release_evidence/properties/content_version"
},
"transcript_version": {
"$ref": "#/properties/data/properties/release_evidence/properties/content_version"
},
"artifact_manifest_sha256": {
"$ref": "#/properties/data/properties/media/properties/sha256"
},
"artifact_sha256": {
"$ref": "#/properties/data/properties/media/properties/sha256"
},
"correction_state": {
"type": "string",
"enum": [
"current",
"corrected",
"withdrawn"
]
},
"canonical_url": {
"$ref": "#/properties/data/properties/canonical_url"
},
"surface_version": {
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"const": "htrtf.surface-version.v1"
},
"surface": {
"type": "string",
"const": "mcp"
},
"release_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,159}$"
},
"content_version": {
"$ref": "#/properties/data/properties/release_evidence/properties/content_version"
},
"transcript_version": {
"$ref": "#/properties/data/properties/release_evidence/properties/content_version"
},
"artifact_manifest_hash": {
"$ref": "#/properties/data/properties/media/properties/sha256"
},
"correction_status": {
"type": "string",
"enum": [
"current",
"corrected",
"withdrawn"
]
}
},
"required": [
"schema_version",
"surface",
"release_id",
"content_version",
"transcript_version",
"artifact_manifest_hash",
"correction_status"
],
"additionalProperties": false
},
"rights": {
"type": "object",
"properties": {
"search": {
"type": "string",
"const": "allowed"
},
"retrieval": {
"type": "string",
"const": "allowed"
},
"quotation": {
"type": "string",
"const": "allowed_with_attribution"
},
"attribution": {
"type": "string",
"const": "required"
},
"model_training": {
"type": "string",
"const": "reserved"
},
"policy_url": {
"$ref": "#/properties/data/properties/canonical_url"
}
},
"required": [
"search",
"retrieval",
"quotation",
"attribution",
"model_training",
"policy_url"
],
"additionalProperties": false
}
},
"required": [
"schema_version",
"release_id",
"manifest_sha256",
"canonical_url",
"rights"
],
"additionalProperties": false
}
},
"required": [
"schema_version",
"operation",
"data",
"meta"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_reading_trail(slug, cursor, limit)
Get an episode reading trail with citations and cursor pagination.
Esquema de entrada
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"maxLength": 160
},
"cursor": {
"type": "string",
"minLength": 1,
"maxLength": 1024
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"default": 15
}
},
"required": [
"slug"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"const": "htrtf.mcp-tool-result.v1"
},
"operation": {
"type": "string",
"const": "get_reading_trail"
},
"data": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9]+(?:[-.][a-z0-9]+)*$",
"maxLength": 160
},
"type": {
"type": "string",
"enum": [
"person",
"organization",
"work",
"project",
"concept"
]
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"relevance": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"external_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"properties": {
"canonical_url": {
"type": "string",
"format": "uri"
},
"episode_slug": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
},
"episode_title": {
"type": "string",
"minLength": 1
},
"speaker": {
"type": "string",
"minLength": 1
},
"start_ms": {
"type": "integer",
"minimum": 0
},
"end_ms": {
"type": "integer",
"exclusiveMinimum": 0
},
"turn_id": {
"type": "string",
"pattern": "^turn-[0-9]{4}$"
},
"transcript_version": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"content_version": {
"type": "string",
"pattern": "^[a-z0-9]+(?:[-.][a-z0-9]+)*$"
},
"citation_text": {
"type": "string",
"minLength": 1
}
},
"required": [
"canonical_url",
"episode_slug",
"episode_title",
"speaker",
"start_ms",
"end_ms",
"turn_id",
"transcript_version",
"content_version",
"citation_text"
],
"additionalProperties": false
},
"minItems": 1,
"maxItems": 20
}
},
"required": [
"id",
"type",
"name",
"relevance",
"evidence"
],
"additionalProperties": false
},
"maxItems": 50
},
"total": {
"type": "integer",
"minimum": 0
},
"next_cursor": {
"type": "string",
"minLength": 1,
"maxLength": 1024
}
},
"required": [
"items",
"total"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"const": "htrtf.canonical-metadata.v1"
},
"release_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,159}$"
},
"manifest_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"snapshot_sha256": {
"$ref": "#/properties/meta/properties/manifest_sha256"
},
"release_sha256": {
"$ref": "#/properties/meta/properties/manifest_sha256"
},
"content_version": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"transcript_version": {
"$ref": "#/properties/meta/properties/content_version"
},
"artifact_manifest_sha256": {
"$ref": "#/properties/meta/properties/manifest_sha256"
},
"artifact_sha256": {
"$ref": "#/properties/meta/properties/manifest_sha256"
},
"correction_state": {
"type": "string",
"enum": [
"current",
"corrected",
"withdrawn"
]
},
"canonical_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"surface_version": {
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"const": "htrtf.surface-version.v1"
},
"surface": {
"type": "string",
"const": "mcp"
},
"release_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,159}$"
},
"content_version": {
"$ref": "#/properties/meta/properties/content_version"
},
"transcript_version": {
"$ref": "#/properties/meta/properties/content_version"
},
"artifact_manifest_hash": {
"$ref": "#/properties/meta/properties/manifest_sha256"
},
"correction_status": {
"type": "string",
"enum": [
"current",
"corrected",
"withdrawn"
]
}
},
"required": [
"schema_version",
"surface",
"release_id",
"content_version",
"transcript_version",
"artifact_manifest_hash",
"correction_status"
],
"additionalProperties": false
},
"rights": {
"type": "object",
"properties": {
"search": {
"type": "string",
"const": "allowed"
},
"retrieval": {
"type": "string",
"const": "allowed"
},
"quotation": {
"type": "string",
"const": "allowed_with_attribution"
},
"attribution": {
"type": "string",
"const": "required"
},
"model_training": {
"type": "string",
"const": "reserved"
},
"policy_url": {
"$ref": "#/properties/meta/properties/canonical_url"
}
},
"required": [
"search",
"retrieval",
"quotation",
"attribution",
"model_training",
"policy_url"
],
"additionalProperties": false
}
},
"required": [
"schema_version",
"release_id",
"manifest_sha256",
"canonical_url",
"rights"
],
"additionalProperties": false
}
},
"required": [
"schema_version",
"operation",
"data",
"meta"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_flashcards(slug, cursor, limit)
Get reviewed, evidence-linked episode flashcards with bounded cursor pagination. No scoring or engagement coercion.
Esquema de entrada
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"maxLength": 160
},
"cursor": {
"type": "string",
"minLength": 1,
"maxLength": 1024
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"default": 10
}
},
"required": [
"slug"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"const": "htrtf.mcp-tool-result.v1"
},
"operation": {
"type": "string",
"const": "get_flashcards"
},
"data": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[a-z0-9]+(?:[-.][a-z0-9]+)*$",
"maxLength": 160
},
"status": {
"type": "string",
"const": "approved"
},
"type": {
"type": "string",
"enum": [
"principle",
"compare_contrast",
"mechanism",
"argument",
"source_recall"
]
},
"question": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"answer": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"explanation": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"difficulty": {
"type": "string",
"enum": [
"introductory",
"intermediate",
"advanced"
]
},
"tags": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"maxItems": 20
},
"chapter_id": {
"$ref": "#/properties/data/properties/items/items/properties/id"
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"properties": {
"canonical_url": {
"type": "string",
"format": "uri"
},
"episode_slug": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
},
"episode_title": {
"type": "string",
"minLength": 1
},
"speaker": {
"type": "string",
"minLength": 1
},
"start_ms": {
"type": "integer",
"minimum": 0
},
"end_ms": {
"type": "integer",
"exclusiveMinimum": 0
},
"turn_id": {
"type": "string",
"pattern": "^turn-[0-9]{4}$"
},
"transcript_version": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"content_version": {
"type": "string",
"pattern": "^[a-z0-9]+(?:[-.][a-z0-9]+)*$"
},
"citation_text": {
"type": "string",
"minLength": 1
}
},
"required": [
"canonical_url",
"episode_slug",
"episode_title",
"speaker",
"start_ms",
"end_ms",
"turn_id",
"transcript_version",
"content_version",
"citation_text"
],
"additionalProperties": false
},
"minItems": 1,
"maxItems": 20
}
},
"required": [
"id",
"status",
"type",
"question",
"answer",
"explanation",
"difficulty",
"tags",
"chapter_id",
"evidence"
],
"additionalProperties": false
},
"maxItems": 50
},
"total": {
"type": "integer",
"minimum": 0
},
"next_cursor": {
"type": "string",
"minLength": 1,
"maxLength": 1024
}
},
"required": [
"items",
"total"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"const": "htrtf.canonical-metadata.v1"
},
"release_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,159}$"
},
"manifest_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"snapshot_sha256": {
"$ref": "#/properties/meta/properties/manifest_sha256"
},
"release_sha256": {
"$ref": "#/properties/meta/properties/manifest_sha256"
},
"content_version": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$"
},
"transcript_version": {
"$ref": "#/properties/meta/properties/content_version"
},
"artifact_manifest_sha256": {
"$ref": "#/properties/meta/properties/manifest_sha256"
},
"artifact_sha256": {
"$ref": "#/properties/meta/properties/manifest_sha256"
},
"correction_state": {
"type": "string",
"enum": [
"current",
"corrected",
"withdrawn"
]
},
"canonical_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"surface_version": {
"type": "object",
"properties": {
"schema_version": {
"type": "string",
"const": "htrtf.surface-version.v1"
},
"surface": {
"type": "string",
"const": "mcp"
},
"release_id": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,159}$"
},
"content_version": {
"$ref": "#/properties/meta/properties/content_version"
},
"transcript_version": {
"$ref": "#/properties/meta/properties/content_version"
},
"artifact_manifest_hash": {
"$ref": "#/properties/meta/properties/manifest_sha256"
},
"correction_status": {
"type": "string",
"enum": [
"current",
"corrected",
"withdrawn"
]
}
},
"required": [
"schema_version",
"surface",
"release_id",
"content_version",
"transcript_version",
"artifact_manifest_hash",
"correction_status"
],
"additionalProperties": false
},
"rights": {
"type": "object",
"properties": {
"search": {
"type": "string",
"const": "allowed"
},
"retrieval": {
"type": "string",
"const": "allowed"
},
"quotation": {
"type": "string",
"const": "allowed_with_attribution"
},
"attribution": {
"type": "string",
"const": "required"
},
"model_training": {
"type": "string",
"const": "reserved"
},
"policy_url": {
"$ref": "#/properties/meta/properties/canonical_url"
}
},
"required": [
"search",
"retrieval",
"quotation",
"attribution",
"model_training",
"policy_url"
],
"additionalProperties": false
}
},
"required": [
"schema_version",
"release_id",
"manifest_sha256",
"canonical_url",
"rights"
],
"additionalProperties": false
}
},
"required": [
"schema_version",
"operation",
"data",
"meta"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada6 herramientas
verificadoversión no registrada6 herramientas