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
| Name | Type | Required | Values and limits |
|---|---|---|---|
url | string | Yes | |
site_type | string | Yes | local_service, local_storefront, local_professional, agency, saas, ecommerce, marketplace, creator, nonprofit, publisher, other |
city | string | No | |
mode | string | No | questions, facts. facts: crawl only, no AI; questions (default): twelve suggestions |
What it answers
Every answer has status and, where useful, message in plain words.
| Field | Meaning |
|---|---|
mode | facts, or absent for questions. |
suggestions | questions mode: twelve questions, written by ScanFree's own model at no charge. |
name, kind, city, description, services, areas | facts mode: what the site says about itself. No AI was used. |
sources | facts mode: where name, services and areas came from. |
pages | facts mode: up to 4 pages read, each with its url, type, title, h1 and description. |
crawl | How reading the site went (ok, js_only and so on). |
ai_used | facts mode: always false. |
Errors
| status | What it means |
|---|---|
invalid_input | The address is refused, site_type isn't one of the list, or city is missing for a local type. |
limited | Too many suggestion runs today. Try tomorrow, or write the questions yourself. |
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": "suggest_questions",
"arguments": {
"url": "example.com",
"site_type": "local_service",
"city": "Boise, Idaho",
"mode": "facts"
}
}
}{
"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. …"
}