CueScout · Example Payload
CueScout Mcp Tools List Response
CompanyAI VisibilityGenerative Engine OptimizationBrand MonitoringSEOCompetitor AnalysisMCP
CueScout Mcp Tools List Response is an example object payload from CueScout, with 3 top-level fields. It illustrates the shape of data this provider's APIs accept or return.
Top-level fields
resultjsonrpcid
Example Payload
{
"result": {
"tools": [
{
"name": "check_ai_visibility",
"title": "Check whether an AI engine recommends a brand",
"description": "Use this when someone asks whether an AI answer engine names or cites a brand for a buying question, or which other brands it names. Sends one question to one search-grounded engine through its API and returns whether the brand was named, whether its domain was cited, which of the listed competitors were named, and the pages the answer cited. Each call is a fresh API request with no account history or personalization, and one question is one datapoint, not an overall visibility score.",
"inputSchema": {
"type": "object",
"properties": {
"brand": {
"type": "string",
"description": "The brand or product name to look for in the answer."
},
"question": {
"type": "string",
"description": "A question a buyer would actually type, e.g. \"best tool for tracking AI search visibility\". Not a keyword: the engines answer questions."
},
"domain": {
"type": "string",
"description": "The brand's domain. Supplying it enables citation detection, not just name matching."
},
"competitors": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 3,
"description": "Up to 3 competitor names to check for in the same answer."
},
"engine": {
"type": "string",
"enum": [
"perplexity",
"chatgpt"
],
"description": "Which engine answers: perplexity (the default) or chatgpt."
}
},
"required": [
"brand",
"question"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": true,
"title": "Check whether an AI engine recommends a brand"
},
"execution": {
"taskSupport": "forbidden"
},
"_meta": {
"securitySchemes": [
{
"type": "noauth"
}
],
"ui": {
"resourceUri": "ui://cuescout/visibility-v1.html"
},
"openai/outputTemplate": "ui://cuescout/visibility-v1.html",
"openai/toolInvocation/invoking": "Asking the engine",
"openai/toolInvocation/invoked": "Got the answer"
},
"outputSchema": {
"type": "object",
"properties": {
"brand": {
"type": "string"
},
"question": {
"type": "string"
},
"engine": {
"type": "string"
},
"mentioned": {
"type": "boolean"
},
"cited": {
"type": "boolean"
},
"rank": {
"type": [
"number",
"null"
]
},
"sentiment": {
"type": [
"string",
"null"
]
},
"snippet": {
"type": [
"string",
"null"
]
},
"competitors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"mentioned": {
"type": "boolean"
}
},
"required": [
"name",
"mentioned"
],
"additionalProperties": false
}
},
"sources": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"brand",
"question",
"engine",
"mentioned",
"cited",
"rank",
"sentiment",
"snippet",
"competitors",
"sources"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"securitySchemes": [
{
"type": "noauth"
}
]
},
{
"name": "check_ai_readiness",
"title": "Check whether AI engines can read a site",
"description": "Use this when someone asks whether AI engines can read, crawl or quote their website, or wants an AI-readiness audit of a site. Runs eight checks: AI crawler access in robots.txt, llms.txt, Organization and FAQ schema, canonical and meta tags, server-rendered copy, and whether an about page and a pricing page exist. It does not measure whether any engine actually cites the site. No AI call, nothing stored.",
"inputSchema": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The site or page URL to check. A bare domain like example.com is fine."
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": true,
"title": "Check whether AI engines can read a site"
},
"execution": {
"taskSupport": "forbidden"
},
"_meta": {
"securitySchemes": [
{
"type": "noauth"
}
]
},
"securitySchemes": [
{
"type": "noauth"
}
]
},
{
"name": "check_ai_crawler_access",
"title": "Check whether AI crawlers are blocked in robots.txt",
"description": "Use this when someone asks why their site never shows up in AI answers, or whether GPTBot, ClaudeBot, PerplexityBot or Google-Extended can crawl it. Reads the site's robots.txt and reports which of those crawlers are blocked, including by a blanket rule the owner may not have meant. One fetch, no AI.",
"inputSchema": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The site or page URL to check. A bare domain like example.com is fine."
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": true,
"title": "Check whether AI crawlers are blocked in robots.txt"
},
"execution": {
"taskSupport": "forbidden"
},
"_meta": {
"securitySchemes": [
{
"type": "noauth"
}
]
},
"securitySchemes": [
{
"type": "noauth"
}
]
},
{
"name": "validate_structured_data",
"title": "Validate the JSON-LD on a page",
"description": "Use this when someone wants their schema markup or JSON-LD checked on a specific page. Reports which schema types the page declares, which blocks fail to parse, and whether the fields that help an engine attribute a claim (sameAs, Organization identity, FAQ answers) are filled in. One fetch, no AI.",
"inputSchema": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The site or page URL to check. A bare domain like example.com is fine."
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": true,
"title": "Validate the JSON-LD on a page"
},
"execution": {
"taskSupport": "forbidden"
},
"_meta": {
"securitySchemes": [
{
"type": "noauth"
}
]
},
"securitySchemes": [
{
"type": "noauth"
}
]
},
{
"name": "check_sitemap",
"title": "Check whether a crawler gets a usable page list",
"description": "Use this when someone wants their XML sitemap checked. Reports whether a site's sitemap is reachable, parses, is declared in robots.txt, and is free of cross-host entries a crawler discards. A handful of fetches, no AI.",
"inputSchema": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The site or page URL to check. A bare domain like example.com is fine."
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": true,
"title": "Check whether a crawler gets a usable page list"
},
"execution": {
"taskSupport": "forbidden"
},
"_meta": {
"securitySchemes": [
{
"type": "noauth"
}
]
},
"securitySchemes": [
{
"type": "noauth"
}
]
},
{
"name": "get_profile",
"title": "Show the connected CueScout account",
"description": "Use this when someone asks which CueScout account is connected. Returns the account name and email.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {}
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false,
"title": "Show the connected CueScout account"
},
"execution": {
"taskSupport": "forbidden"
},
"_meta": {
"securitySchemes": [
{
"type": "oauth2",
"scopes": []
}
],
"openai/profile": true
},
"outputSchema": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"email": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"securitySchemes": [
{
"type": "oauth2",
"scopes": []
}
]
},
{
"name": "list_brands",
"title": "List the brands in the CueScout account",
"description": "Use this to see which brands the connected CueScout account tracks, with their sites and the competitors set for each. The other account tools take one of these brands.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {}
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false,
"title": "List the brands in the CueScout account"
},
"execution": {
"taskSupport": "forbidden"
},
"_meta": {
"securitySchemes": [
{
"type": "oauth2",
"scopes": [
"account:read"
]
}
]
},
"securitySchemes": [
{
"type": "oauth2",
"scopes": [
"account:read"
]
}
]
},
{
"name": "get_ai_visibility",
"title": "Show AI visibility for a tracked brand",
"description": "Use this when someone asks how visible their brand is in AI answers, what their share of AI voice is, or how they compare with competitors. Reads the results CueScout already collected for the brand: how often AI answers named it, its share of voice, how often its site was cited, and the same for each competitor, over the last 7, 28 or 90 days. It does not run new checks.",
"inputSchema": {
"type": "object",
"properties": {
"brand": {
"type": "string",
"description": "Which brand, by name or id, when the account tracks more than one. Leave empty to use the only brand; list_brands shows them all."
},
"days": {
"type": "number",
"enum": [
7,
28,
90
],
"description": "The window to report on, in days. Defaults to 28."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false,
"title": "Show AI visibility for a tracked brand"
},
"execution": {
"taskSupport": "forbidden"
},
"_meta": {
"securitySchemes": [
{
"type": "oauth2",
"scopes": [
"account:read"
]
}
],
"ui": {
"resourceUri": "ui://cuescout/account-visibility-v1.html"
},
"openai/outputTemplate": "ui://cuescout/account-visibility-v1.html",
"openai/toolInvocation/invoking": "Reading your visibility",
"openai/toolInvocation/invoked": "Read your visibility"
},
"outputSchema": {
"type": "object",
"properties": {
"brand": {
"type": "string"
},
"brand_id": {
"type": "string"
},
"days": {
"type": "number"
},
"answers": {
"type": "number"
},
"questions": {
"type": "number"
},
"engines": {
"type": "array",
"items": {
"type": "string"
}
},
"low_sample": {
"type": "boolean"
},
"rankings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"is_brand": {
"type": "boolean"
},
"visibility_pct": {
"type": "number"
},
"share_pct": {
"type": "number"
},
"citation_pct": {
"type": "number"
},
"avg_position": {
"type": [
"number",
"null"
]
}
},
"required": [
"name",
"is_brand",
"visibility_pct",
"share_pct",
"citation_pct",
"avg_position"
],
"additionalProperties": false
}
},
"app_url": {
"type": "string"
}
},
"required": [
"brand",
"brand_id",
"days",
"answers",
"questions",
"engines",
"low_sample",
"rankings",
"app_url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"securitySchemes": [
{
"type": "oauth2",
"scopes": [
"account:read"
]
}
]
},
{
"name": "list_prompts",
"title": "List the tracked prompts and how each engine answered",
"description": "Use this when someone asks which questions CueScout tracks for their brand, which ones the brand is missing from, or who gets named instead. Returns each tracked prompt with the latest verdict per engine (named and cited, named, or not named), the brand's mention and citation rate over the window, and the brands named instead.",
"inputSchema": {
"type": "object",
"properties": {
"brand": {
"type": "string",
"description": "Which brand, by name or id, when the account tracks more than one. Leave empty to use the only brand; list_brands shows them all."
},
"days": {
"type": "number",
"enum": [
7,
28,
90
],
"description": "The window to report on, in days. Defaults to 28."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false,
"title": "List the tracked prompts and how each engine answered"
},
"execution": {
"taskSupport": "forbidden"
},
"_meta": {
"securitySchemes": [
{
"type": "oauth2",
"scopes": [
"account:read"
]
}
]
},
"securitySchemes": [
{
"type": "oauth2",
"scopes": [
"account:read"
]
}
]
},
{
"name": "get_prompt_answers",
"title": "Show the latest AI answers to one tracked prompt",
"description": "Use this when someone wants to read what the AI engines actually answered to one of their tracked prompts. Returns the most recent answer from each engine, whether the brand was named or cited, which brands were named, and the pages each answer cited.",
"inputSchema": {
"type": "object",
"properties": {
"brand": {
"type": "string",
"description": "Which brand, by name or id, when the account tracks more than one. Leave empty to use the only brand; list_brands shows them all."
},
"prompt_id": {
"type": "string",
"description": "The prompt id, from list_prompts."
}
},
"required": [
"prompt_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false,
"title": "Show the latest AI answers to one tracked prompt"
},
"execution": {
"taskSupport": "forbidden"
},
"_meta": {
"securitySchemes": [
{
"type": "oauth2",
"scopes": [
"account:read"
]
}
]
},
"securitySchemes": [
{
"type": "oauth2",
"scopes": [
"account:read"
]
}
]
},
{
"name": "list_citation_sources",
"title": "List the pages AI answers cite for a brand",
"description": "Use this when someone asks which websites or pages AI answers rely on in their brand's category, or where they should try to get mentioned. Returns the pages cited most often across the brand's tracked prompts, with how many times each was cited, by which engines, and which brands each page names.",
"inputSchema": {
"type": "object",
"properties": {
"brand": {
"type": "string",
"description": "Which brand, by name or id, when the account tracks more than one. Leave empty to use the only brand; list_brands shows them all."
},
"days": {
"type": "number",
"enum": [
7,
28,
90
],
"description": "The window to report on, in days. Defaults to 28."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"description": "How many pages to return. Defaults to 15."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false,
"title": "List the pages AI answers cite for a brand"
},
"execution": {
"taskSupport": "forbidden"
},
"_meta": {
"securitySchemes": [
{
"type": "oauth2",
"scopes": [
"account:read"
]
}
]
},
"securitySchemes": [
{
"type": "oauth2",
"scopes": [
"account:read"
]
}
]
},
{
"name": "list_todos",
"title": "List the brand's To-dos",
"description": "Use this when someone asks what they should do next to show up in AI answers. Returns CueScout's To-dos for the brand in priority order: the action, why it matters and its priority. Filter by status: todo (default), suggested, done or dismissed.",
"inputSchema": {
"type": "object",
"properties": {
"brand": {
"type": "string",
"description": "Which brand, by name or id, when the account tracks more than one. Leave empty to use the only brand; list_brands shows them all."
},
"status": {
"type": "string",
"enum": [
"todo",
"suggested",
"done",
"dismissed"
]
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false,
"title": "List the brand's To-dos"
},
"execution": {
"taskSupport": "forbidden"
},
"_meta": {
"securitySchemes": [
{
"type": "oauth2",
"scopes": [
"account:read"
]
}
]
},
"securitySchemes": [
{
"type": "oauth2",
"scopes": [
"account:read"
]
}
]
},
{
"name": "get_todo",
"title": "Show one To-do with its steps and evidence",
"description": "Use this when someone wants the details of one To-do: why it matters, the steps to do it, and the evidence behind it.",
"inputSchema": {
"type": "object",
"properties": {
"brand": {
"type": "string",
"description": "Which brand, by name or id, when the account tracks more than one. Leave empty to use the only brand; list_brands shows them all."
},
"todo_id": {
"type": "string",
"description": "The To-do id, from list_todos."
}
},
"required": [
"todo_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false,
"title": "Show one To-do with its steps and evidence"
},
"execution": {
"taskSupport": "forbidden"
},
"_meta": {
"securitySchemes": [
{
"type": "oauth2",
"scopes": [
"account:read"
]
}
]
},
"securitySchemes": [
{
"type": "oauth2",
"scopes": [
"account:read"
]
}
]
},
{
"name": "get_site_audit",
"title": "Show the brand's site audit",
"description": "Use this when someone asks whether AI engines can read their own brand's site, based on CueScout's last audit of it: crawler access, llms.txt, schema, meta tags, server-rendered copy, and about and pricing pages. Reads the stored result; it does not re-run the audit.",
"inputSchema": {
"type": "object",
"properties": {
"brand": {
"type": "string",
"description": "Which brand, by name or id, when the account tracks more than one. Leave empty to use the only brand; list_brands shows them all."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false,
"title": "Show the brand's site audit"
},
"execution": {
"taskSupport": "forbidden"
},
"_meta": {
"securitySchemes": [
{
"type": "oauth2",
"scopes": [
"account:read"
]
}
]
},
"securitySchemes": [
{
"type": "oauth2",
"scopes": [
"account:read"
]
}
]
}
]
},
"jsonrpc": "2.0",
"id": 2
}Work with this as data
Every example here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for examples
4 MCP tools reach this
find_examplesBrowse and filter every example in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This example
curl "https://apis.io/api/v1/examples/cuescout-com-mcp-tools-list-response"
All examples
curl "https://apis.io/api/v1/examples?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.