<!-- The markdown copy of https://oppalerts.com/docs/mcp/taxonomy_taxonomies . All pages: https://oppalerts.com/docs/llms.txt -->

[Documentation](https://oppalerts.com/docs/) / [MCP](https://oppalerts.com/docs/mcp/) / taxonomy_taxonomies

# taxonomy_taxonomies

`POST https://mcp.oppalerts.com/mcp tool: taxonomy_taxonomies`

The taxonomies used by the category tools: each name accepted by the taxonomy field of taxonomy_categories, and how many categories it holds.

## What it does

The tool lists the taxonomies that the category tools use. For each taxonomy, it gives the name and the number of categories. Use a name as the `taxonomy` parameter of `taxonomy_categories`.

## Connect

```bash
claude mcp add --transport http oppalerts https://mcp.oppalerts.com/mcp
```

The first call opens a browser window for the OppAlerts login. [Connect an AI Agent](https://oppalerts.com/docs/mcp/) has the details.

## Parameters

This tool has no parameters. Send an empty object.

## Strict Rules

- This tool accepts no fields. Any field you send is refused. The result then has `isError` true, and its text starts with `bad_param`. The error names the field: "<field> is not a field of this tool."
- An error about the format of a call, such as a refused field, names the field. Its message ends with one sentence: "Read the documentation at https://oppalerts.com/docs for the correct format." Every other error has only its own sentence.

## Response

The answer has one field, `taxonomies`. Each entry has two fields:

**`taxonomy`string**

The name of the taxonomy. Send it as the `taxonomy` parameter of [taxonomy_categories](https://oppalerts.com/docs/mcp/taxonomy_categories).

**`categories`int**

The number of categories that the taxonomy holds.

## Example

### Call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "taxonomy_taxonomies",
    "arguments": {}
  }
}
```

### Response

```json
{
  "taxonomies": [
    {
      "taxonomy": "google-ads-topics",
      "categories": 2558
    },
    {
      "taxonomy": "google-merchant",
      "categories": 5595
    },
    {
      "taxonomy": "iab-ad-product-taxonomy",
      "categories": 583
    },
    {
      "taxonomy": "iab-audience-taxonomy",
      "categories": 1558
    },
    {
      "taxonomy": "iab-content-taxonomy",
      "categories": 704
    },
    {
      "taxonomy": "iptc-media-topics",
      "categories": 1084
    },
    {
      "taxonomy": "linkedin-industry-codes",
      "categories": 424
    },
    {
      "taxonomy": "microsoft-advertising",
      "categories": 5427
    },
    {
      "taxonomy": "census-naics",
      "categories": 2125
    },
    {
      "taxonomy": "soc",
      "categories": 1447
    },
    {
      "taxonomy": "us-cities",
      "categories": 4117
    }
  ]
}
```

## Errors

An error returns as a tool result with `isError` true. Its text starts with the error code, except for `daily_limit`, whose text is only the sentence. The HTTP status shown for each code is its API status.

- `bad_param` (HTTP 400 in the API): the request has a field. This tool accepts no fields, and the error names the field you sent.
- `backend_error` (HTTP 502 in the API): the data server did not answer, or its answer could not be read. Try again in a few minutes.
- `daily_limit` (HTTP 429 in the API): the account has used all its calls for this tool today. [account_calls_left](https://oppalerts.com/docs/mcp/account_calls_left) shows when the count resets.

This tool has its own daily count. A call through the API or MCP uses one call from this count. A web app page reading the same data does not count. It is not an index search, so it does not use the shared count of the `news_` and `prospects_` tools, and the error `one_at_a_time` does not apply to it.

## Same data in the API

```http
POST /v1/taxonomy/taxonomies HTTP/1.1
Host: api.oppalerts.com
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{}
```

See [POST /v1/taxonomy/taxonomies](https://oppalerts.com/docs/api/taxonomy_taxonomies).

## Related pages

- [POST /v1/taxonomy/taxonomies in the API](https://oppalerts.com/docs/api/taxonomy_taxonomies)
- [taxonomy_categories: the categories of one taxonomy](https://oppalerts.com/docs/mcp/taxonomy_categories)
- [taxonomy_semantic_content_analyzer: analyze a text against your target categories](https://oppalerts.com/docs/mcp/taxonomy_semantic_content_analyzer)
