published_pages
Pages you published.
Pages the business published (press releases, posts, listings) for one site (site_id) or an order's site (order_id). list (scan:read): each page with when it went live, checks since, and how often AI cited it since (since, never because). Writes (scan:write): add (url, kind, live_on up to 30 days back or ahead; the page is fetched once, politely, for its title); update (page_id, live_on); remove⚠ (page_id) stops tracking it; set_content_page (url, or empty to remove) is the page of your own site you'd like AI to cite. ⚠ answers needs_confirmation with a summary and a confirm_token. Show the summary to the person first, and only if they agree call again with the same arguments plus confirm_token (works once, for 10 minutes).
Who can use it
- Access
- Any of your sites; citations come from a paid order's checks.
- Scope
scan:readfor reading; each write action's scope is below.- Changes anything
- Its write actions do; see below.
Actions
Pass one in action. Without it: list.
| action | Scope | What it does |
|---|---|---|
list | scan:read | The pages logged for one site (site_id) or an order's site (order_id). |
add | scan:write | A write action: the description above says what it changes. |
update | scan:write | A write action: the description above says what it changes. |
remove | scan:write | A write action: the description above says what it changes. |
set_content_page | scan:write | A write action: the description above says what it changes. |
Inputs
| Name | Type | Required | Values and limits |
|---|---|---|---|
action | string | No | list, add, update, remove, set_content_page. Default list |
site_id | string | No | |
order_id | string | No | |
page_id | string | No | For update and remove: from action list |
url | string | No | 0 to 500 characters. For add and set_content_page |
kind | string | No | press, blog, listing, other, mention |
live_on | string | No | YYYY-MM-DD; for add (default today) and update |
confirm_token | string | No | Only for a ⚠ action, on the second call: the confirm_token from the first answer, after the person agreed |
What it answers
Every answer has status and, where useful, message in plain words.
| Field | Meaning |
|---|---|
pages | page_id, url, title, kind, added_on, live_on, checks_since, cited_since (answers that cited it since it went live), phrases, ais, first_cited_on and line. Since, never because. |
Errors
| status | What it means |
|---|---|
invalid_input | order_id isn't an order id. Take one from get_dashboard. |
invalid_input | site_id isn't a site id. Take one from sites (action list) or get_dashboard. |
not_found | No order with that id on this account. |
not_found | No site with that id on this account. |
invalid_input | An action that isn't in the list. |
forbidden | The credential lacks the tool's scope, or an agent's owner has no ScanFree account yet (the owner signs in on the website once). |
Input validation error | An argument doesn't match the schema below. The call fails with MCP error -32602, naming the field. |
Errors before the tool runs (a missing key, too many requests) are on the MCP page.
Example
Example shape; values are illustrative.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "published_pages",
"arguments": {
"action": "list",
"site_id": "00000000-0000-4000-8000-000000000004"
}
}
}{
"status": "ok",
"site_id": "00000000-0000-4000-8000-000000000004",
"pages": [
{
"page_id": "00000000-0000-4000-8000-000000000006",
"url": "https://example.com/blog/water-heater-guide",
"title": "…",
"kind": "blog",
"added_on": "2026-11-20",
"live_on": "2026-11-20",
"checks_since": 0,
"cited_since": 0,
"phrases": [],
"ais": [],
"first_cited_on": null,
"line": "…"
}
],
"note": "…"
}