Enhance documentation for search_meetings and list_teams

- Updated README.md to clarify the search_meetings functionality, specifying the use of 'meeting_title' and suggesting the use of list_meetings for better performance with many meetings.
- Revised the link for list_teams in README.md to point to the correct Fathom API reference.
- Improved descriptions in openapi.ts and server.ts to reflect the updated search_meetings parameters.

Author: jpatterson933

README.md

@@ -41,27 +41,16 @@ That's it. Ask Claude about your meetings.
 | `search_meetings`   | Search meetings by title with optional filters          | [MCP Custom](#custom-mcp-tools)                                                         |
 | `get_transcript`    | Get full transcript for a recording                     | [Fathom API](https://developers.fathom.ai/api-reference/recordings/get-transcript)      |
 | `get_summary`       | Get AI-generated summary for a recording                | [Fathom API](https://developers.fathom.ai/api-reference/recordings/get-summary)         |
-| `list_teams`        | List all accessible teams                               | [Fathom API](https://developers.fathom.ai/sdks/available-methods)                       |
+| `list_teams`        | List all accessible teams                               | [Fathom API](https://developers.fathom.ai/api-reference/teams/list-teams)               |
 | `list_team_members` | List members of a team                                  | [Fathom API](https://developers.fathom.ai/api-reference/team-members/list-team-members) |
 
 ### Custom MCP Tools
 
-Tools marked as **MCP Custom** are built specifically for this server and don't exist in the Fathom API. See the [/docs](https://www.fathom-mcp-server.com/docs) page for full parameter documentation.
-
 #### `search_meetings`
 
-Search meetings by title. This is an MCP-native tool that performs client-side filtering since Fathom's API doesn't provide a search endpoint.
+Search Fathom meetings by title or meeting_title. This is an MCP-native tool that performs client-side filtering since Fathom's API doesn't provide a search endpoint. For users with many meetings, use `list_meetings` with date filters for better performance.
 
-| Parameter                        | Type     | Required | Description                                        |
-| -------------------------------- | -------- | -------- | -------------------------------------------------- |
-| `query`                          | string   | ✓        | Search term to match against meeting titles        |
-| `limit`                          | number   |          | Max results to return (1-100)                      |
-| `created_after`                  | string   |          | ISO datetime - only meetings created after this    |
-| `created_before`                 | string   |          | ISO datetime - only meetings created before this   |
-| `calendar_invitees_domains`      | string[] |          | Filter by attendee company domains                 |
-| `calendar_invitees_domains_type` | enum     |          | `all` \| `only_internal` \| `one_or_more_external` |
-| `teams`                          | string[] |          | Filter by team names                               |
-| `recorded_by`                    | string[] |          | Filter by recorder email addresses                 |
+See the [Fathom MCP Server documentation](https://www.fathom-mcp-server.com/docs) for full request and response parameters.
 
 ### Example Usage in Claude
 
@@ -94,6 +83,7 @@ The Fathom API itself only provides read access via its `public_api` scope. Writ
 ## Limitations
 
 - `search_meetings` performs client-side filtering since Fathom's API doesn't provide a search endpoint. For users with many meetings, use `list_meetings` with date filters instead.
+- You can always ask the LLM what query params are avaialable.
 
 ## Self-Hosting
 
@@ -194,6 +184,12 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
 
 See [RELEASING.md](RELEASING.md) for version and release instructions.
 
+## Future Development Plans
+
+- **Transcript vectorization** — Enable vectorization of large transcripts so LLMs can parse and understand them more efficiently. Would be implemented as a stateless worker to ensure no user data is persisted.
+
+Contributions toward these goals are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md).
+
 ## License
 
 MIT License - see [LICENSE](LICENSE) for details.

src/docs/openapi.ts

@@ -43,7 +43,7 @@ export const openapiDocument: oas31.OpenAPIObject = createDocument({
         operationId: "search_meetings",
         summary: "Search Meetings",
         description:
-          "Search Fathom meetings by title. This is an MCP-native tool that " +
+          "Search Fathom meetings by title or meeting_title. This is an MCP-native tool that " +
           "performs client-side filtering since Fathom's API doesn't provide a search endpoint. " +
           "For users with many meetings, consider using list_meetings with date filters for better performance.",
         tags: ["Custom MCP Tools"],

src/tools/server.ts

@@ -65,7 +65,7 @@ export class ToolServer {
       {
         title: "Search Meetings",
         description:
-          "Search Fathom meetings by title. Required: query (search term). " +
+          "Search Fathom meetings by title or meeting_title. Required: query (search term). " +
           "Optional filters: cursor (pagination), created_after, created_before (ISO timestamps), " +
           "calendar_invitees_domains, calendar_invitees_domains_type, teams, recorded_by, " +
           "include_action_items (boolean), include_crm_matches (boolean)",