> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zuddl.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Teams

> **Tool name:** `v1_list_teams` · **Behaviour:** 🔒 Read-only

List the teams in the user's Zuddl organization that events can be created in, paginated. Call this to get the teamId that v1_create_event requires. Pass q to search by name. Always ordered alphabetically by name. pagination.next is non-null when another page exists — call again with the next page number until it is null. When exactly one team comes back, or one is clearly the team the user named, use it; otherwise ask which team the event belongs to rather than guessing — an event created in the wrong team is visible to the wrong people.

**Same as Public API:** [Get all teams](/api-reference/teams/get-all-teams) (`GET /v1/teams`)



## OpenAPI

````yaml https://api.prod.zuddl.com/api/v3/api-docs/mcp-tools post /tools/v1_list_teams
openapi: 3.1.0
info:
  title: Zuddl MCP Tools Reference
  description: >-
    The Zuddl MCP server lets AI assistants such as Claude and ChatGPT work with
    your Zuddl organization through the [Model Context
    Protocol](https://modelcontextprotocol.io). This reference lists every tool
    the server offers. It is generated from the live server, so it always
    matches what your assistant sees.


    # Connecting


    Add `https://setup.zuddl.com/api/mcp` as a remote MCP server in your
    assistant. It signs you in to Zuddl with OAuth and then calls tools on your
    behalf, with your permissions. AI features must be enabled for your
    organization.


    # Calling a tool


    Assistants call a tool with a JSON-RPC `tools/call` request whose `name` is
    the tool name and whose `arguments` match the request body documented on the
    tool's page. The `/tools/<name>` paths in this reference identify tools;
    they are not HTTP endpoints.


    # Behaviour labels


    | Label | Meaning |

    | --- | --- |

    | 🔒 Read-only | Reads data and changes nothing. |

    | ✏️ Write | Creates or updates data, but does not delete it. |

    | ⚠️ Destructive | Deletes or removes data. Most assistants ask you to
    approve these calls. |

    | 🔁 Idempotent | Calling it again with the same arguments has no further
    effect. |


    A tool that mirrors a Public API endpoint links to that endpoint's page.
    MCP-only tools have no Public API equivalent.
  version: 1.0.0
servers:
  - url: https://setup.zuddl.com/api/mcp
    description: Zuddl MCP server
security:
  - oauth: []
tags:
  - name: Events
  - name: Attendees
  - name: Sessions
  - name: Speakers
  - name: Sponsors
  - name: Locations
  - name: Teams
  - name: Brand Kits
  - name: Registration flows & tickets
  - name: Analytics
paths:
  /tools/v1_list_teams:
    post:
      tags:
        - Teams
      summary: List Teams
      description: >-
        **Tool name:** `v1_list_teams` · **Behaviour:** 🔒 Read-only


        List the teams in the user's Zuddl organization that events can be
        created in, paginated. Call this to get the teamId that v1_create_event
        requires. Pass q to search by name. Always ordered alphabetically by
        name. pagination.next is non-null when another page exists — call again
        with the next page number until it is null. When exactly one team comes
        back, or one is clearly the team the user named, use it; otherwise ask
        which team the event belongs to rather than guessing — an event created
        in the wrong team is visible to the wrong people.


        **Same as Public API:** [Get all
        teams](/api-reference/teams/get-all-teams) (`GET /v1/teams`)
      operationId: v1_list_teams
      requestBody:
        description: The tool's `arguments`, as sent in a JSON-RPC `tools/call` request.
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  description: >-
                    Search teams whose name contains this text. Omit to list
                    all.
                page:
                  type: integer
                  format: int32
                  description: 1-based page number. Defaults to 1.
                size:
                  type: integer
                  format: int32
                  description: Teams per page. Defaults to 10, maximum 50.
        required: true
      responses:
        '200':
          description: A JSON-RPC `tools/call` result. The tool's output is in `content`.
components:
  securitySchemes:
    oauth:
      type: http
      description: >-
        OAuth 2.1 access token. MCP clients obtain it themselves (dynamic client
        registration + PKCE) when you connect them to the server URL above.
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.