MCP reference

Run the server with fmtr mcp. It uses the MCP 2024-11-05 protocol over stdio. Every tool is read-only, non-destructive, idempotent, and local-only.

Tools

list_meetings

Parameter	Type	Default	Notes
query	string	None	Case-insensitive title or meeting ID substring.
limit	integer	20	Clamped to 1..200.
offset	integer	0	Number of results to skip.

search_meetings

Full-text search across meeting titles, notes, summaries, and transcript words. At least one of query and speaker is required.

Parameter	Type	Default	Notes
query	string	None	Case-insensitive terms; every whitespace-separated term must occur.
speaker	string	None	Person ID or name substring. Limits results to meetings where that person spoke; the query matches anywhere in those transcripts. Without query it lists those meetings.
kinds	array	all	Any of title, note, summary, transcript. Ignored when speaker is set.
limit	integer	20	Clamped to 1..50.
offset	integer	0	Number of hits to skip.

Hits are ordered by meeting recency and carry meeting_id, kind, and a snippet around the first match. Transcript hits add the resolved speaker, speaker_id, and start_ms, which lines up with the [HH:MM:SS] timestamps in get_meeting_transcript’s text. At most three transcript hits per meeting are returned.

get_meeting

Accepts required string meeting_id. Returns meeting metadata, the canonical note, summaries, and action items. Transcript words are intentionally separate.

get_meeting_transcript

Parameter	Type	Default	Notes
meeting_id	string	required	A returned Free Meeting Transcriber meeting ID.

Returns meeting_id and text. The text uses one [HH:MM:SS] Speaker: ... line per speaker turn, timed from the start of the meeting. Speaker names come from the people registry, and unknown voices fall back to Speaker N. Word-level detail, including IDs, timestamps, and channels, is available through fmtr meetings export --format json.

Resources

URI	MIME type	Content
fmtr://meetings/{meeting_id}	text/markdown	Meeting detail without transcript text.
fmtr://meetings/{meeting_id}/transcript	text/plain	The full speaker-labeled transcript.

Resource listing returns recent meeting resources in pages of 20. Its cursor is a numeric result offset.