list_cited_passages
Read only
This page as markdown, for an agentStored text from sampled answers that cited the brand's own pages: passage, kind, URL, title, how many times, on which engines, best position. Most frequent first. kind says whose words they are: 'source' is quoted FROM the page (Claude); 'answer' is the engine's own sentence that cites the page (ChatGPT). Never treat an 'answer' passage as text on the page.
When to use it
- Use it when: You need the stored text from answers that cited the brand's own pages, labelled by whose words it is.
- Not when: You need how engines describe the brand where they did NOT cite its pages; that is not stored here.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| assetId | string | yes | The Visibility Asset UUID to query. |
| engine | string | no | Only passages quoted by this engine, as stored (for example perplexity). |
| limit | number | no | Maximum items to return; default 12, at most 50. |
What comes back
Every field this tool can return. Checked against the handler on a real database in the test suite, not typed from memory.
| Field | Meaning |
|---|---|
| assetId | The asset asked about, echoed back. |
| dataStatus | One of ok, not_measured or empty_filter. not_measured means no measurement of this kind exists yet, which is not zero; empty_filter means data exists and your filter matched none of it. |
| href | The dashboard page that holds the evidence behind this result, for the right site. A signed-in person can open it; quote it beside the numbers. |
| passages | Most frequent first: passage, kind, kindLabel, url, title, quotes, engines, bestPosition. kind 'source' = quoted from the page (Claude); 'answer' = the engine's own sentence citing it (ChatGPT). Empty with dataStatus ok means no stored passage for your pages yet. |
| note | Which kind is which, and which engines store no passage at all. |
What comes back with the number
Shares arrive with the sample size behind them and a 95% Wilson interval. Values carry a provenance of measured, estimated or derived. A pillar that was not measured reports as not measured rather than as zero, and the composite Visibility Score is held until at least 5 of its 7 pillars are measured.
Example request
The wire shape, from the schema. Every argument is a placeholder.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_cited_passages",
"arguments": {
"assetId": "<assetId from list_assets>",
"engine": "<engine>",
"limit": "<number>"
}
}
}What dataStatus means
ok: There is at least one result, or a measured zero.not_measured: No measurement of this kind exists yet for the asset. Not zero, and not a broken connection.empty_filter: Data exists, and the filter you passed matched none of it. Retry without the filter.
Example prompt
Call list_cited_passages for my site. Which of our sentences do the engines quote, and on which engine?
Calling it
Connect the MCP server at https://app.seoaio.ai/api/mcp over the Streamable HTTP transport. Per-customer authentication is required, so nothing is exposed without it. Call list_assets first: every other tool needs an assetId from it.
Next
For an agent
Read the skill at /SKILL.md before calling anything. It carries the tool order and the rules for quoting a number, including the one that matters most: quoting a share without its interval overstates what we measured.