MODEL CONTEXT PROTOCOL · RETRIEVAL API
Give your agent the archive.
Every transcript, searchable over MCP — citations and timestamps included.
MCP endpoint (Streamable HTTP)
# Add the MCP server (Claude Code example)
claude mcp add --transport http thehosksaid https://thehosksaid.com/mcp
# Or call the REST Ask API directly
curl -s https://thehosksaid.com/api/ask \
-H 'content-type: application/json' \
-d '{"query":"Where does Charles stand on Voltaire timing?"}'
MCP tools
7 READ-ONLYAll tools are read-only and return JSON. search_archive returns the same shape as POST /api/ask — an answer with citations[] and sources[].
search_archive(query, filters?, with_citations?)
Synthesized, citation-backed answer to a natural-language question. The flagship retrieval tool.
search_segments(query, limit?, video_id?, date_from?, date_to?)
Raw semantic search over every transcript segment, ranked by relevance.
get_video(video_id)
Full metadata, chapters and topics for a single indexed video.
get_transcript(video_id, format?)
The complete transcript of a video as segments, plain text, or WebVTT.
get_segment(segment_id)
A single timestamped segment with its neighbours and a deep link to the moment.
list_videos(type?, topic?, sort?, cursor?, limit?)
Paginated catalogue of all indexed videos.
list_topics()
Every clustered topic with citation, video and segment counts.
REST endpoints
NON-MCP FALLBACKPOST/api/ask
Synthesized, citation-backed answer.
→GET/api/search?q=Raw semantic search over segments.
→GET/api/videosPaginated catalogue (type, topic, sort, cursor).
→GET/api/videos/{id}One video: chapters, topics, counts.
→GET/api/topicsClustered topics with counts.
→GET/api/openapi.jsonThe full REST spec.
→Access & limits
Anonymous no key
- ◆Read-only access to every tool & endpoint.
- ◆60 req/min per IP (burst 120).
- ◆On throttle: 429 + Retry-After.
API key bearer
- ◆Send Authorization: Bearer <key>.
- ◆600 req/min.
- ◆Contact the maintainer for a key.