Account data tools
Ask ChatGPT
Ask Claude
Ask Perplexity
Ask CopilotThese tools cover the account-scoped surface of the MCP server — your own private data. Every one is read-only and gated by your membership: the server checks that your signed-in account can access the property before returning anything.
Almost everything here starts from a propertyId, so the first call in any account session is list_properties.
Many of these tools return numeric series over time. Nothing is charted server-side — the assistant builds any visualization from the returned data. Just ask for "a chart of share of voice over the last 90 days" and it will.
Discover your properties
list_properties
Lists the properties (brands / sites) on your account, each with its organization and your role. Use a returned id as the propertyId for every other tool on this page.
| Parameter | Type | Notes |
|---|---|---|
organizationId | string (optional) | Restrict to one of your organizations. |
includeProspects | boolean (optional) | Include bulk-imported prospect properties (default false). |
Projects
Projects are bundled, time-bound tracking efforts (an SEO push, a PR campaign). See the Projects dashboard for the concept.
list_projects
Lists a property's projects with each one's type, status, date range, goals, and counts.
| Parameter | Type | Notes |
|---|---|---|
propertyId | string | From list_properties. |
status | ACTIVE | COMPLETED | ARCHIVED (optional) | Filter by status. |
get_project_insights
A project's deep insights, matching its exported report: metric deltas from start to now (consistency, share of voice, mentions, citations, citation rate), a weekly trend series, goals and their first-hit details, the annotation timeline, key insights, and next steps.
| Parameter | Type | Notes |
|---|---|---|
projectId | string | From list_projects. |
Project-level deltas and weekly trends come from get_project_insights. Property-wide history (not scoped to a project) comes from get_metrics_history below.
Historical trends
get_metrics_history
A property's AI visibility metrics over time — one point per report / nightly run: share of voice, mentions, citations, citation rate, and per-platform breakdowns. Pass a projectId to also get the grounding-search ranking trend scoped to that project's tracked queries.
| Parameter | Type | Notes |
|---|---|---|
propertyId | string | From list_properties. |
projectId | string (optional) | Also return grounding-search trends scoped to this project. |
startDate / endDate | string (optional) | ISO date bounds. |
limit | number (optional) | Max points when no date range is given (default 30, max 100). |
get_consistency_history
A property's brand-consistency score over time (overall and per platform) — how consistently AI platforms describe the brand vs. its source-of-truth identity.
| Parameter | Type | Notes |
|---|---|---|
propertyId | string | From list_properties. |
startDate / endDate | string (optional) | ISO date bounds. |
limit | number (optional) | Max points (default 30, max 100). |
Message tracking and drift
These two pair together: one shows how often your key messages get pulled through, the other shows how the wording changes.
get_message_tracking
How often each tracked key message is pulled through into AI answers over time — a mention rate per message, plus first/latest values and the change. Good for a per-message trend chart.
| Parameter | Type | Notes |
|---|---|---|
propertyId | string | From list_properties. |
startDate / endDate | string (optional) | ISO date bounds. |
get_answer_summaries
The full answer text AI platforms gave for one tracked query, bucketed by week (one representative answer per week per platform). Compare weeks to narrate how the AI's description of the brand shifts. Omit query to first list the property's tracked queries, then call again with the one you want.
| Parameter | Type | Notes |
|---|---|---|
propertyId | string | From list_properties. |
query | string (optional) | A tracked query (exact or substring). Omit to list available queries. |
platform | string (optional) | openai, claude, gemini, perplexity, or google_ai_overview. |
maxWeeks | number (optional) | Most-recent weeks to return (default 12, max 52). |
startDate / endDate | string (optional) | ISO date bounds. |
See the Key Messages dashboard for the concept behind both.
Citation intelligence
get_citation_intelligence
A property's citation intelligence: the mix of sources AI cites, broken down by media type, authority type, content format, and page type; per-platform stats; a historical trend (citation mix over time); and the top citation sources by owner (brand / competitor / third-party). Use the historicalData series to chart how the mix shifts.
| Parameter | Type | Notes |
|---|---|---|
propertyId | string | From list_properties. |
platform | string (optional) | Filter by platform, or all. |
contentFormat | string (optional) | |
mediaType | string (optional) | |
authorityType | string (optional) | |
brandAttributed | string (optional) | A brand name, _any_brand, or _unattributed. |
startDate / endDate | string (optional) | ISO date bounds. |
See the Citation Intelligence dashboard for how these breakdowns are defined.
A typical flow
list_properties → copy the propertyId you want to work with.
For trends: get_metrics_history / get_consistency_history, then ask for charts.
For messaging: get_message_tracking, then get_answer_summaries on the most strategic query.
For a specific effort: list_projects → get_project_insights.
Or run the Analyze a project, Track message drift, or Citation mix over time prompts.
Related
- Historical Metrics dashboard — the trends these tools mirror
- Projects dashboard · Key Messages dashboard · Citation Intelligence dashboard
- Scoring tools — evaluate publishers and placements for a property