# Account data tools
These 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](/docs/dashboards/projects) 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](/docs/dashboards/key-messages) 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](/docs/dashboards/citation-intelligence) 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](/docs/mcp/prompts).
## Related
- [Historical Metrics dashboard](/docs/dashboards/historical-metrics) — the trends these tools mirror
- [Projects dashboard](/docs/dashboards/projects) · [Key Messages dashboard](/docs/dashboards/key-messages) · [Citation Intelligence dashboard](/docs/dashboards/citation-intelligence)
- [Scoring tools](/docs/mcp/scoring) — evaluate publishers and placements for a property