get_summary_tool
Fetch markdown summaries for recordings using synchronous return or asynchronous POST callbacks to destination URLs.
Instructions
Fetch the markdown summary for a specific recording. Supports synchronous return or asynchronous POST when destination_url is provided.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| destination_url | No | Optional async callback URL | |
| recording_id | Yes | The recording identifier |
Implementation Reference
- tools/recordings.py:5-32 (handler)The core handler function that executes the logic for retrieving the AI-generated meeting summary using the Fathom client.async def get_summary( ctx: Context, recording_id: int ) -> dict: """Retrieve AI-generated markdown summary for a specific meeting recording. Args: ctx: MCP context for logging recording_id: Numeric ID of the recording (from meeting.recording_id) Returns: dict: { "summary": { "markdown_formatted": "Full markdown summary text" } } """ try: await ctx.info(f"Fetching summary for recording {recording_id}") result = await client.get_summary(recording_id) await ctx.info("Successfully retrieved summary") return result except FathomAPIError as e: await ctx.error(f"Fathom API error: {e.message}") raise e except Exception as e: await ctx.error(f"Unexpected error fetching summary: {str(e)}") raise e
- server.py:113-123 (registration)Registers the 'get_summary' tool (referred to as 'get_summary_tool' in example) with MCP using the @mcp.tool decorator, delegating to the handler in tools/recordings.py.@mcp.tool async def get_summary( ctx: Context, recording_id: int = Field(..., description="The recording identifier") ) -> Dict[str, Any]: """Fetch AI-generated markdown summary for a recording. Example: get_summary_tool(recording_id=101470681) # Get summary for specific recording """ return await tools.recordings.get_summary(ctx, recording_id)
- server.py:114-117 (schema)Input schema definition using Pydantic Field for the recording_id parameter.async def get_summary( ctx: Context, recording_id: int = Field(..., description="The recording identifier") ) -> Dict[str, Any]: