Radveo MCP

{
  "type": "object",
  "properties": {
    "website": {
      "type": "string",
      "description": "The business website URL, e.g. https://joesplumbing.com. Optional if business_name is given; improves accuracy."
    },
    "location": {
      "type": "string",
      "description": "City or region, e.g. \"Seattle, WA\". Optional but improves accuracy."
    },
    "business_name": {
      "type": "string",
      "description": "The business name, e.g. \"Joe's Plumbing\". Provide this OR a website."
    }
  }
}

{
  "type": "object",
  "required": [
    "ok",
    "verdict",
    "reportUrl",
    "note"
  ],
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "False when the check could not be completed (bad input, rate limit, or the audit engine timed out)."
    },
    "note": {
      "type": "string",
      "description": "Honesty framing: an indicative, measured read of how AI assistants tend to answer, never a guarantee of placement."
    },
    "verdict": {
      "enum": [
        "named",
        "absent",
        "unknown",
        "not_checked"
      ],
      "type": "string",
      "description": "Whether AI engines named this business when asked customer-style recommendation questions. 'named' = at least one query named it; 'absent' = confidently not named; 'unknown' = the engines could not give a confident read; 'not_checked' = the live AI-answer probe did not run for this call (the on-page audit still did)."
    },
    "business": {
      "type": [
        "string",
        "null"
      ],
      "description": "The business name or website that was checked."
    },
    "seoGrade": {
      "type": [
        "string",
        "null"
      ],
      "description": "Letter grade (A-D) for the readiness score, when measured."
    },
    "seoScore": {
      "type": [
        "number",
        "null"
      ],
      "description": "0-100 on-page AI-visibility readiness score, when measured."
    },
    "topFixes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The top fixes to improve the odds of being named (max 3 here; full list in the report)."
    },
    "reportUrl": {
      "type": "string",
      "description": "Free, shareable, public report URL for this check."
    },
    "enginesChecked": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The AI engine panel the probes consult: an indicative read of how AI assistants tend to answer, not a live probe of every public engine."
    },
    "queriesChecked": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The customer-style questions asked to the AI engines (empty when the probe didn't run)."
    },
    "competitorsNamed": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Businesses surfaced instead of this one (deduped). Same list the public shareable report shows."
    },
    "aiVisibilityScore": {
      "type": [
        "number",
        "null"
      ],
      "description": "0-100: the share of customer-style AI queries that named the business. Null when the probe didn't produce a measured score."
    },
    "competitorsSource": {
      "enum": [
        "ai",
        "places",
        null
      ],
      "type": [
        "string",
        "null"
      ],
      "description": "'ai' = an AI engine named them; 'places' = real local leaders from Google's local results (shown when the engines named none). Null when no competitors surfaced."
    }
  }
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "required": [
    "ok",
    "steps",
    "note",
    "freeCheckUrl"
  ],
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "note": {
      "type": "string",
      "description": "Honesty framing: these steps improve odds, they never guarantee placement."
    },
    "steps": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The AEO steps, in order. Empty only when the server is rate-limiting."
    },
    "freeCheckUrl": {
      "type": "string",
      "description": "Where to run the free AI-visibility check."
    }
  }
}