Skip to content

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:read for reading; each write action's scope is below.
Changes anything
Its write actions do; see below.

Actions

Pass one in action. Without it: list.

actionScopeWhat it does
listscan:readThe pages logged for one site (site_id) or an order's site (order_id).
addscan:writeA write action: the description above says what it changes.
updatescan:writeA write action: the description above says what it changes.
removescan:writeA write action: the description above says what it changes.
set_content_pagescan:writeA write action: the description above says what it changes.

Inputs

NameTypeRequiredValues and limits
actionstringNolist, add, update, remove, set_content_page. Default list
site_idstringNo
order_idstringNo
page_idstringNoFor update and remove: from action list
urlstringNo0 to 500 characters. For add and set_content_page
kindstringNopress, blog, listing, other, mention
live_onstringNoYYYY-MM-DD; for add (default today) and update
confirm_tokenstringNoOnly 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.

FieldMeaning
pagespage_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

statusWhat it means
invalid_inputorder_id isn't an order id. Take one from get_dashboard.
invalid_inputsite_id isn't a site id. Take one from sites (action list) or get_dashboard.
not_foundNo order with that id on this account.
not_foundNo site with that id on this account.
invalid_inputAn action that isn't in the list.
forbiddenThe 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 errorAn 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.

The call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "published_pages",
    "arguments": {
      "action": "list",
      "site_id": "00000000-0000-4000-8000-000000000004"
    }
  }
}
The answer (structured content)
{
  "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": "…"
}