Documentation / MCP / taxonomy_taxonomies
taxonomy_taxonomies
POSThttps://mcp.oppalerts.com/mcptool: 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
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 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
isErrortrue, and its text starts withbad_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:
taxonomystring- The name of the taxonomy. Send it as the
taxonomyparameter of taxonomy_categories. categoriesint- The number of categories that the taxonomy holds.
Example
Call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "taxonomy_taxonomies",
"arguments": {}
}
}
Response
{
"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 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
POST /v1/taxonomy/taxonomies HTTP/1.1
Host: api.oppalerts.com
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
{}
See POST /v1/taxonomy/taxonomies.