whoami or list_brands first — the brand_id values they return are what the other tools expect.
Resolver tools
whoami
Returns your key’s identity: its scopes and the brands it can access.
list_brands
The brands your key can access, with names and websites. A single-brand key returns one; an agency (multi-brand) key returns all granted brands — loop over these to run a report per brand.
list_dimensions
Args: brand_id
The filterable dimensions for a brand: the AI platforms tracked, the competitors configured, and the topics covered. Use these to scope other tools.
Read tools
get_ai_shelf_products
Args: brand_id, days (default 30), platform (optional), limit (default 50)
The products AI shopping answers show for your brand’s category — title, position, whether it’s you vs a competitor, merchant, price, platform, and topic.
Requires the Scale plan or higher (or a per-brand override).
get_cited_index
Args: edition (optional — latest if omitted), category (optional — id, slug, or name), top_n (default 10)
The Cited Index — India’s AI-visibility ranking of brands across categories and LLMs. Market-wide data (not scoped to your brand); any valid key can read it. Returns the top brands per category for an edition.
Coming soon
- Metric tools —
cube_slice/cube_drill: a single, composable, recursive query over Cited’s conformed metrics cube (visibility, share of voice, citation share, by platform / topic / domain / page). Returns the exact numbers the dashboard shows. - Action tools — generate a content brief, find source targets, create a task: run Cited’s execution layer from your assistant.
Errors
Tools return an error (surfaced as an MCP tool error) when: the API key is missing/invalid/expired or revoked (Invalid API key), the key isn’t granted the requested brand (API key not granted this brand), the plan doesn’t include the feature (e.g. AI Shelf requires the Scale plan or higher), or a rate limit is hit (Rate limit exceeded).