Fathom AI MCP

Instructions

Implementation Reference

• src/fathom-client.ts:131-138 (handler)

  The actual API client method that fetches the team members data.

  async listTeamMembers(
    options: {
      team?: string | null;
      cursor?: string | null;
    } = {}
  ): Promise<Record<string, unknown>> {
    return this._get('/team_members', { cursor: options.cursor, team: options.team });
  }

• src/server.ts:543-562 (registration)

  Registration of the 'list_team_members' tool including its schema.

  server.registerTool(
    'list_team_members',
    {
      description: 'List team members, optionally filtered by team name.',
      inputSchema: {
        team: z.string().optional().describe('Team name to filter by.'),
        page: z
          .number()
          .int()
          .min(1)
          .default(1)
          .describe('Page number (starts at 1). Any page can be requested directly.'),
        page_size: z
          .number()
          .int()
          .min(1)
          .default(DEFAULT_PAGE_SIZE)
          .describe('Number of members per page (default 10).'),
      },
    },

• src/server.ts:563-574 (handler)

  Tool handler in src/server.ts which uses the Fathom client to fetch the data.

  async args => {
    const client = getClient();
    const key = cacheKey('list_team_members', { team: args.team });
  
    let cached = _itemsCache.get(key);
    const isExpired = cached !== undefined && Date.now() - cached.fetchedAt > CACHE_TTL_MS;
    if (!cached || isExpired) {
      try {
        const result = await fetchAll(
          opts => client.listTeamMembers(opts as Record<string, unknown>),
          { team: args.team }
        );