get_meeting_details

Instructions

Implementation Reference

• tools/recordings.py:8-63 (handler)

  Core handler function that fetches meeting metadata and summary from Fathom API concurrently, strips markdown from summary, constructs a unified dictionary response excluding the transcript, and handles errors with context logging.

  async def get_meeting_details(
      ctx: Context,
      recording_id: int
  ) -> dict:
      """Retrieve comprehensive meeting details including summary and metadata (without transcript).
  
      Args:
          ctx: MCP context for logging
          recording_id: Numeric ID of the recording
  
      Returns:
          dict: Unified meeting object with metadata and summary (no transcript)
      """
      try:
          await ctx.info(f"Fetching meeting details for recording {recording_id}")
  
          # Fetch meeting metadata and summary concurrently
          meeting_task = client.get_meeting(recording_id)
          summary_task = client.get_summary(recording_id)
  
          meeting, summary = await asyncio.gather(meeting_task, summary_task)
  
          # Convert markdown summary to plain text
          markdown_summary = summary.get("summary", {}).get("markdown_formatted", "")
          plain_text_summary = strip_markdown.strip_markdown(markdown_summary) if markdown_summary else ""
  
          # Build unified meeting object without transcript
          result = {
              "recording_id": recording_id,
              "title": meeting.get("title"),
              "meeting_url": meeting.get("url"),
              "share_url": meeting.get("share_url"),
              "created_at": meeting.get("created_at"),
              "scheduled_start_time": meeting.get("scheduled_start_time"),
              "scheduled_end_time": meeting.get("scheduled_end_time"),
              "recording_start_time": meeting.get("recording_start_time"),
              "recording_end_time": meeting.get("recording_end_time"),
              "transcript_language": meeting.get("transcript_language"),
              "participants": meeting.get("participants", []),
              "recorded_by": meeting.get("recorded_by"),
              "teams": meeting.get("teams", []),
              "topics": meeting.get("topics", []),
              "sentiment": meeting.get("sentiment"),
              "crm_matches": meeting.get("crm_matches", []),
              "summary": plain_text_summary
          }
  
          await ctx.info("Successfully retrieved meeting details")
          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 meeting details: {str(e)}")
          raise e

• server.py:155-165 (registration)

  Registers the get_meeting_details tool with FastMCP using @mcp.tool decorator. Includes Pydantic Field for input validation/schema (recording_id), docstring, and delegates to the core implementation in tools.recordings.get_meeting_details.

  @mcp.tool
  async def get_meeting_details(
      ctx: Context,
      recording_id: int = Field(..., description="The recording identifier")
  ) -> Dict[str, Any]:
      """Retrieve comprehensive meeting details including summary and metadata (without transcript).
  
      Example:
          get_meeting_details([recording_id])
      """
      return await tools.recordings.get_meeting_details(ctx, recording_id)

• server.py:158-159 (schema)

  Pydantic input schema definition for the recording_id parameter using Field with required and description.

      recording_id: int = Field(..., description="The recording identifier")
  ) -> Dict[str, Any]: