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

# Discovery tools

> Understand the discovery tools available through Profound MCP

Discovery tools resolve human-readable context, such as an organization, category, domain, region, AI model, tag, or topic, into the IDs the other Profound MCP tools take as inputs. Most conversations start here: the assistant confirms what you can access, finds the right scope, and then passes the resolved IDs to other tools. To connect your MCP client to the hosted server, refer to the [Connection guides](/mcp/common-mcp-clients).

## Behavior and safety

All discovery tools are read-only. They retrieve reference data, but don't create, update, or delete anything in Profound.

| Behavior        | What it means                                                                             |
| --------------- | ----------------------------------------------------------------------------------------- |
| Non-destructive | No tool performs destructive updates                                                      |
| Live data       | Tools read from the Profound API, so results reflect the caller's current access and data |

All discovery tools set the following MCP hints:

| Hint             | Value  | What it means                                     |
| ---------------- | ------ | ------------------------------------------------- |
| `readOnlyHint`   | `true` | The tool only reads data                          |
| `idempotentHint` | `true` | The tool is safe to retry with the same arguments |

## Discovery tools

| Tool                                                                  | Usage                                                                                                                                                                 |
| --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `whoami`                                                              | Confirm the authenticated principal, organizations, regions, and entitlements                                                                                         |
| `list_organizations`                                                  | List organizations the user can access                                                                                                                                |
| `list_regions`                                                        | List geographic regions, optionally scoped to an organization                                                                                                         |
| `list_models`                                                         | List tracked AI models such as ChatGPT, Perplexity, Google AI Overviews, and Gemini                                                                                   |
| `list_categories`                                                     | List tracked categories for an organization                                                                                                                           |
| `list_domains`                                                        | List tracked domains for an organization                                                                                                                              |
| `list_tags`                                                           | List tags in a category                                                                                                                                               |
| `list_topics`                                                         | List topics in a category                                                                                                                                             |
| [`list_prompts`](/mcp/capabilities/prompts-capabilities#list-prompts) | List configured prompts in a category, with optional status, tag, and topic filters. Documented with the other [prompt tools](/mcp/capabilities/prompts-capabilities) |

<AccordionGroup>
  <Accordion title="whoami">
    Confirms the authenticated user, organizations, regions, and entitlements available to this MCP session.

    **Example prompts**:

    * "Which Profound account am I signed in as?"
    * "What organizations and regions can I see?"

    **Inputs:** none.
  </Accordion>

  <Accordion title="list_organizations">
    Lists the organizations the authenticated user can access. Returned IDs feed category, domain, and report tools.

    **Example prompts**:

    * "Which organizations can I pull Profound data from?"

    **Inputs:** none.
  </Accordion>

  <Accordion title="list_regions">
    Lists geographic regions configured for an organization.

    **Example prompts**:

    * "Which regions do we track?"

    **Inputs**

    | Input    | Required | Default | Description                                                                               |
    | -------- | -------- | ------- | ----------------------------------------------------------------------------------------- |
    | `org_id` | No       | `null`  | Organization to scope to. When omitted, shows regions across all accessible organizations |
  </Accordion>

  <Accordion title="list_models">
    Lists the AI models Profound tracks. Returned model IDs filter reports to a single engine.

    **Example prompts**:

    * "Which AI models does Profound track?"

    **Inputs:** none.
  </Accordion>

  <Accordion title="list_categories">
    Lists tracked categories, markets, or segments in an organization. Most brand visibility reports are scoped to a category.

    **Example prompts**:

    * "What categories are we tracking?"

    **Inputs**

    | Input    | Required | Default | Description                           |
    | -------- | -------- | ------- | ------------------------------------- |
    | `org_id` | Yes      | -       | Organization whose categories to list |
  </Accordion>

  <Accordion title="list_domains">
    Lists tracked domains for an organization. Domains are exact hostnames, so `www.example.com` and `example.com` are distinct.

    **Example prompts**:

    * "Which of our domains does Profound track traffic for?"

    **Inputs**

    | Input    | Required | Default | Description                                |
    | -------- | -------- | ------- | ------------------------------------------ |
    | `org_id` | Yes      | -       | Organization whose tracked domains to list |
  </Accordion>

  <Accordion title="list_tags">
    Lists tags available within a category for filtering prompts and reports.

    **Example prompts**:

    * "What tags exist in the Banking category?"

    **Inputs**

    | Input         | Required | Default | Description                 |
    | ------------- | -------- | ------- | --------------------------- |
    | `category_id` | Yes      | -       | Category whose tags to list |
  </Accordion>

  <Accordion title="list_topics">
    Lists topics available within a category for filtering prompts and reports.

    **Example prompts**:

    * "What topics do we track under Banking?"

    **Inputs**

    | Input         | Required | Default | Description                 |
    | ------------- | -------- | ------- | --------------------------- |
    | `category_id` | Yes      | -       | Category to list topics for |
  </Accordion>
</AccordionGroup>