GovTube
Search what U.S. officials said on camera, with timestamps and citations. Not a government site.
Should I use this
Quality & Safety
A
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~9,864Tokens (tool definitions)
~15.5 KBTypical response size
Significant attention impact (7.71% 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": {
"govtube": {
"url": "https://api.govtube.us/mcp"
}
}
}Remote endpoints
https://api.govtube.us/mcpstreamable-httpWhat it can do
Tool inventory
Tools (7)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢govtube_search_instances(query, speaker, include_unreviewed, source, date_from, ...)
Find spoken instances of words or a phrase across official videos and White House transcripts. Returns one small page: counts for the whole result, then up to 5 videos (newest first, or most instances first with sort="most_instances"), each with up to 3 passages (quotes; overlapping instances merged), each passage listing its instances with citation id and share_url. `notes` and `more_passages` say what else there is: use `next_cursor` for more videos, govtube_list_video_instances for the rest of one video, and detail="full" for larger pages. White House transcripts have no timing (`timing_granularity` "document", null times, a `position` and a `document_url`).
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "Words to find. Put an exact phrase in double quotes: \"no tax on tips\". Unquoted words must occur within 8 words of each other.",
"title": "Query",
"type": "string"
},
"speaker": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Bioguide ID of a member of Congress, e.g. 'C001053' (Rep. Tom Cole). Matches speakers a person has confirmed. Names matched only from the on-screen caption are left out (the result counts them in unreviewed_excluded) unless include_unreviewed is true. Omit to search everyone.",
"examples": [
"C001053"
],
"title": "Speaker"
},
"include_unreviewed": {
"default": false,
"description": "With speaker: also return moments where that person was named from the on-screen caption and nobody has reviewed the name yet. They are labelled 'matched from on-screen name, not reviewed'; say so when you quote them.",
"title": "Include Unreviewed",
"type": "boolean"
},
"source": {
"anyOf": [
{
"enum": [
"house_floor_clerk",
"senate_floor_and_committees",
"govinfo_dcpd",
"govinfo_crec",
"us_gov_youtube"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Only one source: house_floor_clerk (U.S. House floor), senate_floor_and_committees (U.S. Senate floor and committee hearings), govinfo_dcpd (White House transcripts, no video timing), govinfo_crec (Congressional Record, House and Senate speeches as printed, no video timing) or us_gov_youtube (official U.S. government YouTube channels; see source_caveats). A source can hold nothing yet: govtube_get_coverage lists what each one holds.",
"title": "Source"
},
"date_from": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Earliest event date, YYYY-MM-DD.",
"title": "Date From"
},
"date_to": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Latest event date, YYYY-MM-DD.",
"title": "Date To"
},
"detail": {
"default": "compact",
"description": "compact (default): small pages, passages only. full: the larger pages of the REST API (default 10 videos x 5), with every instance listed one by one as well as in passages.",
"enum": [
"compact",
"full"
],
"title": "Detail",
"type": "string"
},
"max_videos": {
"anyOf": [
{
"maximum": 25,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Videos per page, 1 to 25. Default 5, or 10 with detail=\"full\".",
"title": "Max Videos"
},
"max_instances_per_video": {
"anyOf": [
{
"maximum": 20,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Passages per video, 1 to 20 (with detail=\"full\", also instances). Default 3, or 5 with detail=\"full\".",
"title": "Max Instances Per Video"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "next_cursor from the previous page of the same search (same query and filters).",
"title": "Cursor"
},
"sort": {
"default": "newest",
"description": "newest (default): event date, newest first; on the same day, video sessions before official transcripts. most_instances: most instances first; check order_exact in the response.",
"enum": [
"newest",
"most_instances"
],
"title": "Sort",
"type": "string"
},
"playable_only": {
"default": false,
"description": "true: only results with playable video; transcript-only results (no video) are left out and counted in counts.transcript_only.",
"title": "Playable Only",
"type": "boolean"
}
},
"required": [
"query"
],
"title": "search_instancesArguments"
}Output Schema
{
"type": "object",
"properties": {
"query": {
"type": "string"
},
"normalized_query": {
"type": "string"
},
"sort": {
"enum": [
"newest",
"most_instances"
],
"type": "string"
},
"order_exact": {
"type": "boolean"
},
"detail": {
"enum": [
"compact",
"full"
],
"type": "string"
},
"counts": {
"$ref": "#/$defs/Counts"
},
"videos": {
"items": {
"$ref": "#/$defs/McpVideoResult"
},
"type": "array"
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"unreviewed_excluded": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"limits": {
"additionalProperties": {
"type": "integer"
},
"type": "object"
}
},
"required": [
"query",
"normalized_query",
"sort",
"order_exact",
"detail",
"counts",
"videos",
"next_cursor",
"notes",
"limits"
],
"$defs": {
"CountPart": {
"properties": {
"instances": {
"type": "integer"
},
"videos": {
"type": "integer"
},
"exact": {
"type": "boolean"
}
},
"required": [
"instances",
"videos",
"exact"
],
"type": "object"
},
"Counts": {
"properties": {
"instances": {
"type": "integer"
},
"videos": {
"type": "integer"
},
"exact": {
"type": "boolean"
},
"by_timing": {
"additionalProperties": {
"type": "integer"
},
"type": "object"
},
"playable": {
"$ref": "#/$defs/CountPart"
},
"transcript_only": {
"$ref": "#/$defs/CountPart"
}
},
"required": [
"instances",
"videos",
"exact",
"playable",
"transcript_only"
],
"type": "object"
},
"DocumentPosition": {
"properties": {
"paragraph": {
"minimum": 1,
"type": "integer"
},
"word": {
"minimum": 1,
"type": "integer"
}
},
"required": [
"paragraph",
"word"
],
"type": "object"
},
"Excerpt": {
"properties": {
"text": {
"type": "string"
},
"match": {
"items": {
"$ref": "#/$defs/MatchSpan"
},
"type": "array"
},
"highlight": {
"items": {
"$ref": "#/$defs/MatchSpan"
},
"type": "array"
},
"start_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"end_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"boundary": {
"enum": [
"sentence",
"clause",
"window"
],
"type": "string"
},
"truncated_before": {
"default": false,
"type": "boolean"
},
"truncated_after": {
"default": false,
"type": "boolean"
}
},
"required": [
"text",
"match",
"start_ms",
"end_ms",
"boundary"
],
"type": "object"
},
"MatchSpan": {
"properties": {
"start": {
"type": "integer"
},
"end": {
"type": "integer"
}
},
"required": [
"start",
"end"
],
"type": "object"
},
"McpInstance": {
"properties": {
"id": {
"type": "string"
},
"video_id": {
"type": "string"
},
"start_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"end_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"play_from_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"timing_granularity": {
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"resolution_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"position": {
"anyOf": [
{
"$ref": "#/$defs/DocumentPosition"
},
{
"type": "null"
}
],
"default": null
},
"document_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"document_highlight_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"speaker": {
"$ref": "#/$defs/SpeakerInfo"
},
"excerpt": {
"$ref": "#/$defs/Excerpt"
},
"playable": {
"type": "boolean"
},
"low_confidence": {
"default": false,
"type": "boolean"
},
"caption_check": {
"default": "not_checked",
"enum": [
"agrees",
"differs",
"not_checked"
],
"type": "string"
},
"share_url": {
"type": "string"
}
},
"required": [
"id",
"video_id",
"start_ms",
"end_ms",
"play_from_ms",
"timing_granularity",
"resolution_ms",
"speaker",
"excerpt",
"playable",
"share_url"
],
"type": "object"
},
"McpPassage": {
"properties": {
"excerpt": {
"$ref": "#/$defs/Excerpt"
},
"start_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"end_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"play_from_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"timing_granularity": {
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"resolution_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"position": {
"anyOf": [
{
"$ref": "#/$defs/DocumentPosition"
},
{
"type": "null"
}
],
"default": null
},
"document_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"document_highlight_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"instances": {
"items": {
"$ref": "#/$defs/McpPassageInstance"
},
"type": "array"
}
},
"required": [
"excerpt",
"start_ms",
"end_ms",
"play_from_ms",
"timing_granularity",
"resolution_ms",
"instances"
],
"type": "object"
},
"McpPassageInstance": {
"properties": {
"id": {
"type": "string"
},
"start_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"end_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"play_from_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"timing_granularity": {
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"resolution_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"position": {
"anyOf": [
{
"$ref": "#/$defs/DocumentPosition"
},
{
"type": "null"
}
],
"default": null
},
"speaker": {
"$ref": "#/$defs/SpeakerInfo"
},
"low_confidence": {
"default": false,
"type": "boolean"
},
"caption_check": {
"default": "not_checked",
"enum": [
"agrees",
"differs",
"not_checked"
],
"type": "string"
},
"playable": {
"type": "boolean"
},
"share_url": {
"type": "string"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"id",
"start_ms",
"end_ms",
"play_from_ms",
"timing_granularity",
"resolution_ms",
"speaker",
"playable",
"share_url"
],
"type": "object"
},
"McpVideoResult": {
"properties": {
"video": {
"$ref": "#/$defs/VideoSummary"
},
"rights": {
"type": "string"
},
"instance_count": {
"type": "integer"
},
"passage_count": {
"type": "integer"
},
"more_passages": {
"type": "integer"
},
"passages": {
"items": {
"$ref": "#/$defs/McpPassage"
},
"type": "array"
},
"instances": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/McpInstance"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"video",
"rights",
"instance_count",
"passage_count",
"more_passages",
"passages"
],
"type": "object"
},
"PlaybackAsset": {
"properties": {
"kind": {
"enum": [
"youtube",
"hls",
"mp4"
],
"type": "string"
},
"ref": {
"type": "string"
},
"offset_ms": {
"default": 0,
"type": "integer"
},
"alignment_verified": {
"default": false,
"type": "boolean"
},
"made_for_kids": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"kind",
"ref"
],
"type": "object"
},
"SourceChannel": {
"properties": {
"channel_id": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"channel_id",
"name",
"url"
],
"type": "object"
},
"SpeakerInfo": {
"properties": {
"cluster": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"person_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"display_name": {
"type": "string"
},
"confirmed": {
"default": false,
"type": "boolean"
},
"match_status": {
"default": "unconfirmed",
"enum": [
"unconfirmed",
"matched_unreviewed",
"confirmed"
],
"type": "string"
},
"match_source": {
"items": {
"enum": [
"onscreen",
"congressional_record",
"reviewer"
],
"type": "string"
},
"type": "array"
}
},
"required": [
"cluster",
"display_name"
],
"type": "object"
},
"VideoLink": {
"properties": {
"video_id": {
"type": "string"
},
"video_rev": {
"minimum": 1,
"type": "integer"
},
"start_ms": {
"minimum": 0,
"type": "integer"
},
"end_ms": {
"minimum": 0,
"type": "integer"
},
"coverage": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"tier": {
"enum": [
"high",
"standard",
"bracketed"
],
"type": "string"
},
"method": {
"const": "text_alignment",
"default": "text_alignment",
"type": "string"
}
},
"required": [
"video_id",
"video_rev",
"start_ms",
"end_ms",
"coverage",
"tier"
],
"type": "object"
},
"VideoSummary": {
"properties": {
"video_id": {
"type": "string"
},
"title": {
"type": "string"
},
"event_date": {
"format": "date",
"type": "string"
},
"source_id": {
"type": "string"
},
"source_url": {
"type": "string"
},
"playback": {
"anyOf": [
{
"$ref": "#/$defs/PlaybackAsset"
},
{
"type": "null"
}
],
"default": null
},
"duration_ms": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"timing_granularity": {
"default": "word",
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"fidelity": {
"default": "verbatim",
"enum": [
"verbatim",
"clean",
"edited"
],
"type": "string"
},
"source_certainty": {
"default": "unverified",
"enum": [
"official_record",
"official_channel",
"unverified"
],
"type": "string"
},
"source_caveats": {
"items": {
"type": "string"
},
"type": "array"
},
"source_channel": {
"anyOf": [
{
"$ref": "#/$defs/SourceChannel"
},
{
"type": "null"
}
],
"default": null
},
"record_delivery": {
"anyOf": [
{
"enum": [
"not_spoken",
"may_include_not_spoken"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"video_link": {
"anyOf": [
{
"$ref": "#/$defs/VideoLink"
},
{
"type": "null"
}
],
"default": null
},
"video_delivery": {
"anyOf": [
{
"enum": [
"delivered",
"not_found"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"video_id",
"title",
"event_date",
"source_id",
"source_url"
],
"type": "object"
}
}
}🟢govtube_list_video_instances(video_id, query, offset, limit, speaker, ...)
Page through one video's matches by passage, in time order. A passage is a run of instances whose excerpts overlap, shown as one quote. `offset` and `limit` count passages; `next_offset` is null on the last page. `passage_count` and `instance_count` cover the whole video. With detail="full", `instances` also lists every instance of the page one by one.
Input Schema
{
"type": "object",
"properties": {
"video_id": {
"description": "video_id from a search result.",
"title": "Video Id",
"type": "string"
},
"query": {
"description": "The same query as the search.",
"title": "Query",
"type": "string"
},
"offset": {
"default": 0,
"description": "Passages to skip; use next_offset from the previous page.",
"minimum": 0,
"title": "Offset",
"type": "integer"
},
"limit": {
"anyOf": [
{
"maximum": 100,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Passages per page, 1 to 100. Default 10, or 20 with detail=\"full\".",
"title": "Limit"
},
"speaker": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Bioguide ID of a member of Congress, e.g. 'C001053' (Rep. Tom Cole). Matches speakers a person has confirmed. Names matched only from the on-screen caption are left out (the result counts them in unreviewed_excluded) unless include_unreviewed is true. Omit to search everyone.",
"examples": [
"C001053"
],
"title": "Speaker"
},
"include_unreviewed": {
"default": false,
"description": "With speaker: also return moments where that person was named from the on-screen caption and nobody has reviewed the name yet. They are labelled 'matched from on-screen name, not reviewed'; say so when you quote them.",
"title": "Include Unreviewed",
"type": "boolean"
},
"detail": {
"default": "compact",
"description": "compact (default): small pages, passages only. full: the larger pages of the REST API (default 10 videos x 5), with every instance listed one by one as well as in passages.",
"enum": [
"compact",
"full"
],
"title": "Detail",
"type": "string"
}
},
"required": [
"video_id",
"query"
],
"title": "list_video_instancesArguments"
}Output Schema
{
"type": "object",
"properties": {
"video": {
"$ref": "#/$defs/VideoSummary"
},
"rights": {
"type": "string"
},
"instance_count": {
"type": "integer"
},
"passage_count": {
"type": "integer"
},
"more_passages": {
"type": "integer"
},
"passages": {
"items": {
"$ref": "#/$defs/McpPassage"
},
"type": "array"
},
"instances": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/McpInstance"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null
},
"offset": {
"type": "integer"
},
"next_offset": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"unreviewed_excluded": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"video",
"rights",
"instance_count",
"passage_count",
"more_passages",
"passages",
"offset",
"next_offset",
"notes"
],
"$defs": {
"DocumentPosition": {
"properties": {
"paragraph": {
"minimum": 1,
"type": "integer"
},
"word": {
"minimum": 1,
"type": "integer"
}
},
"required": [
"paragraph",
"word"
],
"type": "object"
},
"Excerpt": {
"properties": {
"text": {
"type": "string"
},
"match": {
"items": {
"$ref": "#/$defs/MatchSpan"
},
"type": "array"
},
"highlight": {
"items": {
"$ref": "#/$defs/MatchSpan"
},
"type": "array"
},
"start_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"end_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"boundary": {
"enum": [
"sentence",
"clause",
"window"
],
"type": "string"
},
"truncated_before": {
"default": false,
"type": "boolean"
},
"truncated_after": {
"default": false,
"type": "boolean"
}
},
"required": [
"text",
"match",
"start_ms",
"end_ms",
"boundary"
],
"type": "object"
},
"MatchSpan": {
"properties": {
"start": {
"type": "integer"
},
"end": {
"type": "integer"
}
},
"required": [
"start",
"end"
],
"type": "object"
},
"McpInstance": {
"properties": {
"id": {
"type": "string"
},
"video_id": {
"type": "string"
},
"start_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"end_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"play_from_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"timing_granularity": {
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"resolution_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"position": {
"anyOf": [
{
"$ref": "#/$defs/DocumentPosition"
},
{
"type": "null"
}
],
"default": null
},
"document_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"document_highlight_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"speaker": {
"$ref": "#/$defs/SpeakerInfo"
},
"excerpt": {
"$ref": "#/$defs/Excerpt"
},
"playable": {
"type": "boolean"
},
"low_confidence": {
"default": false,
"type": "boolean"
},
"caption_check": {
"default": "not_checked",
"enum": [
"agrees",
"differs",
"not_checked"
],
"type": "string"
},
"share_url": {
"type": "string"
}
},
"required": [
"id",
"video_id",
"start_ms",
"end_ms",
"play_from_ms",
"timing_granularity",
"resolution_ms",
"speaker",
"excerpt",
"playable",
"share_url"
],
"type": "object"
},
"McpPassage": {
"properties": {
"excerpt": {
"$ref": "#/$defs/Excerpt"
},
"start_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"end_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"play_from_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"timing_granularity": {
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"resolution_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"position": {
"anyOf": [
{
"$ref": "#/$defs/DocumentPosition"
},
{
"type": "null"
}
],
"default": null
},
"document_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"document_highlight_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"instances": {
"items": {
"$ref": "#/$defs/McpPassageInstance"
},
"type": "array"
}
},
"required": [
"excerpt",
"start_ms",
"end_ms",
"play_from_ms",
"timing_granularity",
"resolution_ms",
"instances"
],
"type": "object"
},
"McpPassageInstance": {
"properties": {
"id": {
"type": "string"
},
"start_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"end_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"play_from_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"timing_granularity": {
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"resolution_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"position": {
"anyOf": [
{
"$ref": "#/$defs/DocumentPosition"
},
{
"type": "null"
}
],
"default": null
},
"speaker": {
"$ref": "#/$defs/SpeakerInfo"
},
"low_confidence": {
"default": false,
"type": "boolean"
},
"caption_check": {
"default": "not_checked",
"enum": [
"agrees",
"differs",
"not_checked"
],
"type": "string"
},
"playable": {
"type": "boolean"
},
"share_url": {
"type": "string"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"id",
"start_ms",
"end_ms",
"play_from_ms",
"timing_granularity",
"resolution_ms",
"speaker",
"playable",
"share_url"
],
"type": "object"
},
"PlaybackAsset": {
"properties": {
"kind": {
"enum": [
"youtube",
"hls",
"mp4"
],
"type": "string"
},
"ref": {
"type": "string"
},
"offset_ms": {
"default": 0,
"type": "integer"
},
"alignment_verified": {
"default": false,
"type": "boolean"
},
"made_for_kids": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"kind",
"ref"
],
"type": "object"
},
"SourceChannel": {
"properties": {
"channel_id": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"channel_id",
"name",
"url"
],
"type": "object"
},
"SpeakerInfo": {
"properties": {
"cluster": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"person_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"display_name": {
"type": "string"
},
"confirmed": {
"default": false,
"type": "boolean"
},
"match_status": {
"default": "unconfirmed",
"enum": [
"unconfirmed",
"matched_unreviewed",
"confirmed"
],
"type": "string"
},
"match_source": {
"items": {
"enum": [
"onscreen",
"congressional_record",
"reviewer"
],
"type": "string"
},
"type": "array"
}
},
"required": [
"cluster",
"display_name"
],
"type": "object"
},
"VideoLink": {
"properties": {
"video_id": {
"type": "string"
},
"video_rev": {
"minimum": 1,
"type": "integer"
},
"start_ms": {
"minimum": 0,
"type": "integer"
},
"end_ms": {
"minimum": 0,
"type": "integer"
},
"coverage": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"tier": {
"enum": [
"high",
"standard",
"bracketed"
],
"type": "string"
},
"method": {
"const": "text_alignment",
"default": "text_alignment",
"type": "string"
}
},
"required": [
"video_id",
"video_rev",
"start_ms",
"end_ms",
"coverage",
"tier"
],
"type": "object"
},
"VideoSummary": {
"properties": {
"video_id": {
"type": "string"
},
"title": {
"type": "string"
},
"event_date": {
"format": "date",
"type": "string"
},
"source_id": {
"type": "string"
},
"source_url": {
"type": "string"
},
"playback": {
"anyOf": [
{
"$ref": "#/$defs/PlaybackAsset"
},
{
"type": "null"
}
],
"default": null
},
"duration_ms": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"timing_granularity": {
"default": "word",
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"fidelity": {
"default": "verbatim",
"enum": [
"verbatim",
"clean",
"edited"
],
"type": "string"
},
"source_certainty": {
"default": "unverified",
"enum": [
"official_record",
"official_channel",
"unverified"
],
"type": "string"
},
"source_caveats": {
"items": {
"type": "string"
},
"type": "array"
},
"source_channel": {
"anyOf": [
{
"$ref": "#/$defs/SourceChannel"
},
{
"type": "null"
}
],
"default": null
},
"record_delivery": {
"anyOf": [
{
"enum": [
"not_spoken",
"may_include_not_spoken"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"video_link": {
"anyOf": [
{
"$ref": "#/$defs/VideoLink"
},
{
"type": "null"
}
],
"default": null
},
"video_delivery": {
"anyOf": [
{
"enum": [
"delivered",
"not_found"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"video_id",
"title",
"event_date",
"source_id",
"source_url"
],
"type": "object"
}
}
}🟢govtube_get_transcript_window(video_id, start_ms, end_ms)
Return speaker turns overlapping [start_ms, end_ms] with their text, for checking context. A turn with cluster null and speaker "No speaker label" holds words no voice was found for. The words are as heard; don't attribute them to a neighbouring speaker. Not available for official transcripts without timing (timing_granularity "document"): read those at the result's document_url, or resolve the citation for the surrounding turns.
Input Schema
{
"type": "object",
"properties": {
"video_id": {
"description": "video_id from a search result.",
"title": "Video Id",
"type": "string"
},
"start_ms": {
"description": "Start, in milliseconds from the start of the video, e.g. an instance's start_ms minus 30000.",
"minimum": 0,
"title": "Start Ms",
"type": "integer"
},
"end_ms": {
"description": "End, in milliseconds; at most 5 minutes after start_ms.",
"minimum": 1,
"title": "End Ms",
"type": "integer"
}
},
"required": [
"video_id",
"start_ms",
"end_ms"
],
"title": "get_transcript_windowArguments"
}Output Schema
{
"type": "object",
"properties": {
"result": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
}
},
"required": [
"result"
]
}🟢govtube_get_video(video_id)
Metadata, speakers, playback asset and the rights and use restrictions of the video's source.
Input Schema
{
"type": "object",
"properties": {
"video_id": {
"description": "video_id from a search result.",
"title": "Video Id",
"type": "string"
}
},
"required": [
"video_id"
],
"title": "get_videoArguments"
}Output Schema
{
"type": "object",
"properties": {
"video": {
"$ref": "#/$defs/VideoMeta"
},
"rights": {
"$ref": "#/$defs/RightsSummary"
}
},
"required": [
"video",
"rights"
],
"$defs": {
"PlaybackAsset": {
"properties": {
"kind": {
"enum": [
"youtube",
"hls",
"mp4"
],
"type": "string"
},
"ref": {
"type": "string"
},
"offset_ms": {
"default": 0,
"type": "integer"
},
"alignment_verified": {
"default": false,
"type": "boolean"
},
"made_for_kids": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"kind",
"ref"
],
"type": "object"
},
"RightsSummary": {
"properties": {
"source_id": {
"type": "string"
},
"source_name": {
"type": "string"
},
"kicker": {
"type": "string"
},
"short_name": {
"type": "string"
},
"rights_short": {
"type": "string"
},
"rights_basis": {
"type": "string"
},
"use_restrictions": {
"items": {
"type": "string"
},
"type": "array"
},
"confidence": {
"type": "string"
},
"policy_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"source_id",
"source_name",
"kicker",
"short_name",
"rights_short",
"rights_basis",
"use_restrictions",
"confidence",
"policy_url"
],
"type": "object"
},
"SourceChannel": {
"properties": {
"channel_id": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"channel_id",
"name",
"url"
],
"type": "object"
},
"SpeakerInfo": {
"properties": {
"cluster": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"person_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"display_name": {
"type": "string"
},
"confirmed": {
"default": false,
"type": "boolean"
},
"match_status": {
"default": "unconfirmed",
"enum": [
"unconfirmed",
"matched_unreviewed",
"confirmed"
],
"type": "string"
},
"match_source": {
"items": {
"enum": [
"onscreen",
"congressional_record",
"reviewer"
],
"type": "string"
},
"type": "array"
}
},
"required": [
"cluster",
"display_name"
],
"type": "object"
},
"TranscriptSource": {
"properties": {
"producer": {
"type": "string"
},
"origin_url": {
"type": "string"
},
"retrieved_at": {
"type": "string"
},
"sha256": {
"type": "string"
},
"registry_id": {
"type": "string"
},
"granularity": {
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"fidelity": {
"enum": [
"verbatim",
"clean",
"edited"
],
"type": "string"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"producer",
"origin_url",
"retrieved_at",
"sha256",
"registry_id",
"granularity",
"fidelity"
],
"type": "object"
},
"VideoLink": {
"properties": {
"video_id": {
"type": "string"
},
"video_rev": {
"minimum": 1,
"type": "integer"
},
"start_ms": {
"minimum": 0,
"type": "integer"
},
"end_ms": {
"minimum": 0,
"type": "integer"
},
"coverage": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"tier": {
"enum": [
"high",
"standard",
"bracketed"
],
"type": "string"
},
"method": {
"const": "text_alignment",
"default": "text_alignment",
"type": "string"
}
},
"required": [
"video_id",
"video_rev",
"start_ms",
"end_ms",
"coverage",
"tier"
],
"type": "object"
},
"VideoMeta": {
"properties": {
"video_id": {
"type": "string"
},
"title": {
"type": "string"
},
"full_title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"full_title_truncated": {
"default": false,
"type": "boolean"
},
"event_date": {
"format": "date",
"type": "string"
},
"source_id": {
"type": "string"
},
"source_url": {
"type": "string"
},
"transcript_rev": {
"default": 1,
"type": "integer"
},
"speakers": {
"additionalProperties": {
"$ref": "#/$defs/SpeakerInfo"
},
"type": "object"
},
"playback": {
"anyOf": [
{
"$ref": "#/$defs/PlaybackAsset"
},
{
"type": "null"
}
],
"default": null
},
"asr_model": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"duration_ms": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"word_cloud": {
"anyOf": [
{
"$ref": "#/$defs/WordCloud"
},
{
"type": "null"
}
],
"default": null
},
"timing_granularity": {
"default": "word",
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"resolution_ms": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"fidelity": {
"default": "verbatim",
"enum": [
"verbatim",
"clean",
"edited"
],
"type": "string"
},
"transcript_source": {
"anyOf": [
{
"$ref": "#/$defs/TranscriptSource"
},
{
"type": "null"
}
],
"default": null
},
"subjects": {
"items": {
"type": "string"
},
"type": "array"
},
"source_certainty": {
"default": "unverified",
"enum": [
"official_record",
"official_channel",
"unverified"
],
"type": "string"
},
"source_caveats": {
"items": {
"type": "string"
},
"type": "array"
},
"source_channel": {
"anyOf": [
{
"$ref": "#/$defs/SourceChannel"
},
{
"type": "null"
}
],
"default": null
},
"record_delivery": {
"anyOf": [
{
"enum": [
"not_spoken",
"may_include_not_spoken"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"part_of_page": {
"default": false,
"type": "boolean"
},
"video_link": {
"anyOf": [
{
"$ref": "#/$defs/VideoLink"
},
{
"type": "null"
}
],
"default": null
},
"video_delivery": {
"anyOf": [
{
"enum": [
"delivered",
"not_found"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"video_id",
"title",
"event_date",
"source_id",
"source_url"
],
"type": "object"
},
"WordCloud": {
"properties": {
"terms": {
"items": {
"$ref": "#/$defs/WordCloudTerm"
},
"type": "array"
},
"top_words": {
"items": {
"$ref": "#/$defs/WordCount"
},
"type": "array"
},
"generated_at": {
"type": "string"
},
"words": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"generated_at",
"words"
],
"type": "object"
},
"WordCloudTerm": {
"properties": {
"text": {
"type": "string"
},
"weight": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"count": {
"minimum": 1,
"type": "integer"
}
},
"required": [
"text",
"weight",
"count"
],
"type": "object"
},
"WordCount": {
"properties": {
"text": {
"type": "string"
},
"count": {
"minimum": 1,
"type": "integer"
}
},
"required": [
"text",
"count"
],
"type": "object"
}
}
}🟢govtube_resolve_citation(citation_id)
Check that a cited instance still says the quoted words after corrections, and return its context. The result has a share_url to link. gd2./gd1. ids cite words in an official transcript: the result has positions instead of times, citation_text to paste, document_highlight_url, and `certifies` saying what is (and is not) certified.
Input Schema
{
"type": "object",
"properties": {
"citation_id": {
"description": "An instance id (gt2.... or gd2...., or an older gt1.... or gd1....).",
"title": "Citation Id",
"type": "string"
}
},
"required": [
"citation_id"
],
"title": "resolve_citationArguments"
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string"
},
"note": {
"type": "string"
},
"video_id": {
"type": "string"
},
"timing_granularity": {
"default": "word",
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"original_start_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"current_start_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"original_position": {
"anyOf": [
{
"$ref": "#/$defs/DocumentPosition"
},
{
"type": "null"
}
],
"default": null
},
"current_position": {
"anyOf": [
{
"$ref": "#/$defs/DocumentPosition"
},
{
"type": "null"
}
],
"default": null
},
"document_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"citation_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"certifies": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"quoted_text": {
"type": "string"
},
"signed": {
"default": false,
"type": "boolean"
},
"canonical_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"transcript_context": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"cited_rev": {
"type": "integer"
},
"current_rev": {
"type": "integer"
},
"corrected_at": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"replacement": {
"anyOf": [
{
"$ref": "#/$defs/CitationReplacement"
},
{
"type": "null"
}
],
"default": null
},
"replacement_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"low_confidence": {
"default": false,
"type": "boolean"
},
"withheld": {
"default": false,
"type": "boolean"
},
"caption_check": {
"default": "not_checked",
"enum": [
"agrees",
"differs",
"not_checked"
],
"type": "string"
},
"words_checked": {
"default": false,
"type": "boolean"
},
"source_certainty": {
"default": "unverified",
"enum": [
"official_record",
"official_channel",
"unverified"
],
"type": "string"
},
"source_caveats": {
"items": {
"type": "string"
},
"type": "array"
},
"share_url": {
"type": "string"
},
"document_highlight_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"status",
"note",
"video_id",
"original_start_ms",
"current_start_ms",
"quoted_text",
"cited_rev",
"current_rev",
"share_url"
],
"$defs": {
"CitationReplacement": {
"properties": {
"video_id": {
"type": "string"
},
"start_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"end_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"play_from_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"position": {
"anyOf": [
{
"$ref": "#/$defs/DocumentPosition"
},
{
"type": "null"
}
],
"default": null
},
"text": {
"type": "string"
}
},
"required": [
"video_id",
"start_ms",
"end_ms",
"play_from_ms",
"text"
],
"type": "object"
},
"DocumentPosition": {
"properties": {
"paragraph": {
"minimum": 1,
"type": "integer"
},
"word": {
"minimum": 1,
"type": "integer"
}
},
"required": [
"paragraph",
"word"
],
"type": "object"
}
}
}🟢govtube_get_coverage
Totals for the whole index, video and official transcripts counted apart: video sessions, hours and words transcribed; official transcripts (text, no timing); each source; date ranges, last update, items awaiting review and known gaps. Cite this with any count. For the list of sessions use govtube_list_sessions.
Input Schema
{
"type": "object",
"properties": {},
"title": "get_coverageArguments"
}Output Schema
{
"type": "object",
"properties": {
"videos": {
"type": "integer"
},
"first_event_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
]
},
"last_event_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
]
},
"last_ingested_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"awaiting_review": {
"type": "integer"
},
"known_gaps": {
"items": {
"type": "string"
},
"type": "array"
},
"total_hours": {
"type": "number"
},
"total_words": {
"type": "integer"
},
"video": {
"$ref": "#/$defs/VideoCoverage"
},
"documents": {
"$ref": "#/$defs/DocumentCoverage"
},
"collections": {
"items": {
"$ref": "#/$defs/CoverageCollection"
},
"type": "array"
},
"by_timing": {
"additionalProperties": {
"type": "integer"
},
"type": "object"
},
"sources": {
"items": {
"$ref": "#/$defs/SourceCoverage"
},
"type": "array"
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"revised": {
"default": 0,
"type": "integer"
},
"corrections": {
"items": {
"$ref": "#/$defs/CorrectionEntry"
},
"type": "array"
}
},
"required": [
"videos",
"first_event_date",
"last_event_date",
"last_ingested_at",
"awaiting_review",
"known_gaps",
"total_hours",
"total_words",
"video",
"documents",
"collections",
"by_timing",
"sources",
"notes"
],
"$defs": {
"CorrectionEntry": {
"properties": {
"id": {
"type": "integer"
},
"at": {
"type": "string"
},
"action": {
"enum": [
"hidden",
"restored"
],
"type": "string"
},
"video_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"event_date": {
"format": "date",
"type": "string"
},
"source_id": {
"type": "string"
},
"source_name": {
"type": "string"
},
"rev": {
"type": "integer"
},
"reason": {
"type": "string"
}
},
"required": [
"id",
"at",
"action",
"video_id",
"title",
"event_date",
"source_id",
"source_name",
"rev",
"reason"
],
"type": "object"
},
"CoverageCollection": {
"properties": {
"key": {
"type": "string"
},
"kind": {
"enum": [
"video",
"document"
],
"type": "string"
},
"source_id": {
"type": "string"
},
"label": {
"type": "string"
},
"unit": {
"type": "string"
},
"units": {
"type": "string"
},
"short_name": {
"type": "string"
},
"rights_short": {
"type": "string"
},
"items": {
"minimum": 0,
"type": "integer"
},
"first_event_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
]
},
"last_event_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
]
},
"hours": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"words": {
"minimum": 0,
"type": "integer"
},
"speaker_labels": {
"minimum": 0,
"type": "integer"
},
"speakers_confirmed": {
"minimum": 0,
"type": "integer"
},
"awaiting_review": {
"minimum": 0,
"type": "integer"
},
"days": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/CoverageDay"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"key",
"kind",
"source_id",
"label",
"unit",
"units",
"short_name",
"rights_short",
"items",
"first_event_date",
"last_event_date",
"hours",
"words",
"speaker_labels",
"speakers_confirmed",
"awaiting_review"
],
"type": "object"
},
"CoverageDay": {
"properties": {
"event_date": {
"format": "date",
"type": "string"
},
"items": {
"minimum": 0,
"type": "integer"
},
"words": {
"minimum": 0,
"type": "integer"
},
"parts": {
"additionalProperties": {
"type": "integer"
},
"type": "object"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"event_date",
"items",
"words"
],
"type": "object"
},
"DocumentCoverage": {
"properties": {
"count": {
"default": 0,
"minimum": 0,
"type": "integer"
},
"words": {
"default": 0,
"minimum": 0,
"type": "integer"
},
"first_event_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"last_event_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"type": "object"
},
"SourceCoverage": {
"properties": {
"source_id": {
"type": "string"
},
"source_name": {
"type": "string"
},
"videos": {
"type": "integer"
},
"first_event_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
]
},
"last_event_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
]
},
"hours": {
"type": "number"
},
"words": {
"type": "integer"
},
"rights": {
"type": "string"
}
},
"required": [
"source_id",
"source_name",
"videos",
"first_event_date",
"last_event_date",
"hours",
"words",
"rights"
],
"type": "object"
},
"VideoCoverage": {
"properties": {
"sessions": {
"default": 0,
"minimum": 0,
"type": "integer"
},
"hours": {
"default": 0,
"type": "number"
},
"words": {
"default": 0,
"minimum": 0,
"type": "integer"
},
"first_event_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"last_event_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"speaker_labels": {
"default": 0,
"minimum": 0,
"type": "integer"
},
"speakers_confirmed": {
"default": 0,
"minimum": 0,
"type": "integer"
},
"awaiting_review": {
"default": 0,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
}
}
}🟢govtube_list_sessions(source, date_from, date_to, limit, cursor, ...)
Every indexed item, one page at a time: video sessions and official transcripts (White House transcripts, Congressional Record speeches, one item per speech). Newest first; on the same day, video sessions before official transcripts. Each has title, date, source, length, words, whether it plays, and how many speakers are confirmed. `total` matches govtube_get_coverage's counts for the same source.
Input Schema
{
"type": "object",
"properties": {
"source": {
"anyOf": [
{
"enum": [
"house_floor_clerk",
"senate_floor_and_committees",
"govinfo_dcpd",
"govinfo_crec",
"us_gov_youtube"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Only one source: house_floor_clerk (U.S. House floor), senate_floor_and_committees (U.S. Senate floor and committee hearings), govinfo_dcpd (White House transcripts, no video timing), govinfo_crec (Congressional Record, House and Senate speeches as printed, no video timing) or us_gov_youtube (official U.S. government YouTube channels; see source_caveats). A source can hold nothing yet: govtube_get_coverage lists what each one holds.",
"title": "Source"
},
"date_from": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Earliest event date, YYYY-MM-DD.",
"title": "Date From"
},
"date_to": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Latest event date, YYYY-MM-DD.",
"title": "Date To"
},
"limit": {
"default": 25,
"description": "Sessions per page, 1 to 100.",
"maximum": 100,
"minimum": 1,
"title": "Limit",
"type": "integer"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "next_cursor from the previous page (same filters).",
"title": "Cursor"
},
"kind": {
"anyOf": [
{
"enum": [
"video",
"document"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Only one kind: \"video\" (video sessions, timed transcripts) or \"document\" (official transcripts without video timing: White House transcripts, Congressional Record speeches). Omit for both.",
"title": "Kind"
}
},
"title": "list_sessionsArguments"
}Output Schema
{
"type": "object",
"properties": {
"total": {
"type": "integer"
},
"sessions": {
"items": {
"$ref": "#/$defs/McpSession"
},
"type": "array"
},
"next_cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"total",
"sessions",
"next_cursor"
],
"$defs": {
"McpSession": {
"properties": {
"video_id": {
"type": "string"
},
"title": {
"type": "string"
},
"event_date": {
"format": "date",
"type": "string"
},
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"duration_measured": {
"type": "boolean"
},
"timing_granularity": {
"default": "word",
"enum": [
"word",
"segment",
"sentence",
"turn",
"chunk",
"document"
],
"type": "string"
},
"fidelity": {
"default": "verbatim",
"enum": [
"verbatim",
"clean",
"edited"
],
"type": "string"
},
"words": {
"type": "integer"
},
"playable": {
"type": "boolean"
},
"playback_kind": {
"anyOf": [
{
"enum": [
"youtube",
"hls",
"mp4"
],
"type": "string"
},
{
"type": "null"
}
]
},
"speaker_labels": {
"type": "integer"
},
"speakers_confirmed": {
"type": "integer"
},
"transcript_rev": {
"type": "integer"
},
"collection": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"source_id": {
"type": "string"
}
},
"required": [
"video_id",
"title",
"event_date",
"duration_ms",
"duration_measured",
"words",
"playable",
"playback_kind",
"speaker_labels",
"speakers_confirmed",
"transcript_rev",
"source_id"
],
"type": "object"
}
}
}Community
Evidence
Recent observations
verifiedversion not recorded7 tools