Skip to content

suggest_questions

Suggest questions, or read the site's facts.

Before a scan, without starting one (limited per day). mode "facts" (no AI at all): a polite crawl of up to 4 pages, returning the site's name, kind, city, services, areas and pages with where each came from, so you write the customer questions yourself. mode "questions" (the default): twelve question suggestions written by ScanFree's own model, free and optional.

Who can use it

Access
Any account. Counts against the suggestion runs of the day (both modes); never uses a free scan.
Scope
Any: a key or sign-in with either scope
Changes anything
No. Read-only.

Inputs

NameTypeRequiredValues and limits
urlstringYes
site_typestringYeslocal_service, local_storefront, local_professional, agency, saas, ecommerce, marketplace, creator, nonprofit, publisher, other
citystringNo
modestringNoquestions, facts. facts: crawl only, no AI; questions (default): twelve suggestions

What it answers

Every answer has status and, where useful, message in plain words.

FieldMeaning
modefacts, or absent for questions.
suggestionsquestions mode: twelve questions, written by ScanFree's own model at no charge.
name, kind, city, description, services, areasfacts mode: what the site says about itself. No AI was used.
sourcesfacts mode: where name, services and areas came from.
pagesfacts mode: up to 4 pages read, each with its url, type, title, h1 and description.
crawlHow reading the site went (ok, js_only and so on).
ai_usedfacts mode: always false.

Errors

statusWhat it means
invalid_inputThe address is refused, site_type isn't one of the list, or city is missing for a local type.
limitedToo many suggestion runs today. Try tomorrow, or write the questions yourself.
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": "suggest_questions",
    "arguments": {
      "url": "example.com",
      "site_type": "local_service",
      "city": "Boise, Idaho",
      "mode": "facts"
    }
  }
}
The answer (structured content)
{
  "status": "ok",
  "mode": "facts",
  "url": "https://example.com/",
  "crawl": "ok",
  "name": "Example Plumbing",
  "kind": "local_service",
  "city": "Boise, Idaho",
  "description": "…",
  "services": [
    "Drain cleaning",
    "Water heaters"
  ],
  "areas": [
    "Boise",
    "Meridian"
  ],
  "sources": {
    "name": "https://example.com/ (title)",
    "services": "https://example.com/services",
    "areas": "https://example.com/"
  },
  "pages": [
    {
      "url": "https://example.com/",
      "type": "home",
      "title": "…",
      "h1": "…",
      "description": "…"
    }
  ],
  "ai_used": false,
  "message": "No AI was used. …"
}