Reference Data
Static reference lists — directory sites and categories.
list_sites
List the directory/publisher catalog OS can submit listings to (Google, Facebook, Apple, Bing + long-tail directories). Global reference data — no clientId. Filter by search (name or url), active, siteType, or country (ISO-2; includes worldwide sites). Ordered by priority (GABF first).
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_sites",
"arguments": {}
}
}{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "..."
}
]
}
}Response shape shown for illustration — the actual content depends on the tool and your data.
list_categories
Search the general business category taxonomy (mirrors Google's, thousands of entries). Global reference data — no clientId. Pass a `search` query; returns id + name. The id is a Category id (cuid) to set as a location's general category. For a specific publisher's own catalog, use list_publisher_categories.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_categories",
"arguments": {}
}
}{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "..."
}
]
}
}Response shape shown for illustration — the actual content depends on the tool and your data.
list_publisher_categories
Search a single publisher's OWN category catalog — GABF: google, apple, bing, facebook. Global reference data. Returns that publisher's native category ids + display names. Apple categories are country-specific — pass country (ISO-2). Use the returned ids for a location's publisher categories (primaryCategoryGoogle / facebookCategoryId / appleCategoryId / bingCategoryId).
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_publisher_categories",
"arguments": {
"publisher": "google"
}
}
}{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "..."
}
]
}
}Response shape shown for illustration — the actual content depends on the tool and your data.