Answer Audit measures whether AI assistants such as ChatGPT, Gemini, Perplexity, Claude and Google Search's AI answer name a company when a buyer asks them who to use. AEO, answer engine optimisation, is the work of getting named in those answers; Answer Audit is the measurement.
Connect Claude, ChatGPT, Claude Code or Cursor to our MCP server (MCP is the Model Context Protocol, the way AI apps connect to outside tools) and ask about your reports in plain words, or read them with the REST API. Both only read: nothing can be bought or changed through them.
https://answeraudit.co.uk/api/mcphttps://answeraudit.co.uk/api/mcp/publichttps://answeraudit.co.uk/api/v1Paste this line into the assistant you want to connect. It reads our setup guide and walks you through the steps for that app.
Read https://answeraudit.co.uk/developers/setup.md and help me connect Answer Audit to the app I am using now.Every app takes the same address, https://answeraudit.co.uk/api/mcp, and signs you in on Answer Audit's own site.
The same steps work on claude.ai and in the Claude desktop app.
https://answeraudit.co.uk/api/mcpIf you do not see the option to add a custom connector, your Claude plan or your organisation's settings may not allow it yet.
ChatGPT adds your own MCP servers through its developer mode, on the plans that offer it. OpenAI renames these menus from time to time, so look for developer mode in Settings.
https://answeraudit.co.uk/api/mcp, and pick OAuth if it asks how to sign in.--scope user to have it in every project, not only this one./mcp, choose answer-audit and sign in. Answer Audit opens in your browser: sign in with the link we email you, then choose Allow.claude mcp add --transport http answer-audit https://answeraudit.co.uk/api/mcpclaude mcp add --transport http answer-audit https://answeraudit.co.uk/api/mcp --header "Authorization: Bearer aa_key_..."~/.cursor/mcp.json for every project, or to .cursor/mcp.json in one project.{
"mcpServers": {
"answer-audit": {
"url": "https://answeraudit.co.uk/api/mcp"
}
}
}{
"mcpServers": {
"answer-audit": {
"url": "https://answeraudit.co.uk/api/mcp",
"headers": {
"Authorization": "Bearer aa_key_..."
}
}
}
}https://answeraudit.co.uk/api/mcp (Streamable HTTP).https://answeraudit.co.uk/.well-known/oauth-protected-resource and https://answeraudit.co.uk/.well-known/oauth-authorization-server; both dynamic client registration and Client ID Metadata Documents work.Authorization: Bearer aa_key_....https://answeraudit.co.uk/api/mcp/public.Every account reads exactly what its report pages and CSVs show it, for what it bought: a free check reads as the free report, a paid report as what was bought, and an agency reads its clients' reports as well as its own. Nothing is read that the report page would not show.
The answers are collected through each AI assistant's API with web search switched on. They are a close proxy for what a person sees in the apps, not a copy of it.
Every tool reads only. The public tools read the published category league tables and their questions, on both servers. The signed-in tools read your own reports, on https://answeraudit.co.uk/api/mcp only.
list_categoriesList published categories
Lists the buyer categories Answer Audit publishes league tables for, in every market or in one. Each entry has the category's slug and market (for get_category and get_questions), how many questions it holds, whether it has been measured, and its public page. Filter with query to find a category by name or sector.
market string, optional: Only this market: us, uk, global, ca, au, ie or de.query string, optional: Words to look for in the category name or sector, such as "payroll".limit whole number, optional: How many to return (default 50, at most 200).offset whole number, optional: How many to skip, to read the next page.get_categoryGet a category's league table
One published category in one market: which companies AI assistants name most often for its buyer questions (the top of the table, with counts and the date asked), how many more were named, and the category's public page. Use list_categories to find the slug and market.
slug string, required: The category's slug, from list_categories.market string, required: A market code such as us, uk or global.get_questionsGet a category's buyer questions
Every buyer question in one published category and market, numbered as its public page numbers them, with its topic and buying stage, and a link to the question's own page where it has one (questions answered by at least two assistants).
slug string, required: The category's slug, from list_categories.market string, required: A market code such as us, uk or global.get_questionGet one question's results
One buyer question's public page: the companies the assistants named most often in answer to it (with counts and the date asked), how many more were named, and the websites the answers cited. Use get_questions for the question slugs; only questions with hasPage true have one.
slug string, required: The category's slug, from list_categories.market string, required: A market code such as us, uk or global.question string, required: The question's slug, from get_questions.brand_lookupFind a company in the league tables
Finds where a company is named near the top of Answer Audit's published league tables: the category, market, its place, how many answers named it and when they were asked. A company named only further down a table, or only in private reports, is not found.
name string, required: The company or brand name, such as "HubSpot".list_reportsList my reports
Lists every report on the signed-in account: free checks, full reports, monitored reports, market reports and, for an agency, its clients' reports. Each has its id (for the other report tools), domain, brand, category, market, status, kind, score and when it last ran.
No inputs.
get_reportGet a report
One report's results as its page shows them for what was bought: the score, how often each AI assistant named the brand, the question sets, gaps, suggested fixes, who was named instead, the websites cited, competitor grids and the page plan where the report includes them, and this month against last on a monitored report.
id string, required: A report id, from list_reports.get_answersGet a report's answers
The answers behind a report, question by question and assistant by assistant: whether the brand was named, who else was, the websites cited and the answer text, as much of it as the report's tier shows. Narrow with set (0 is the buyer questions, then each supplied list) and question (its number in that set).
id string, required: A report id, from list_reports.set whole number, optional: The question set: 0 for the buyer questions, 1 and up for supplied lists.question whole number, optional: The question's number in its set, as the report numbers it.get_historyGet a report's history
Every run of a report, newest first, with its date, why it ran, the score and how many answers named the brand, so a monitored report's movement month by month can be read.
id string, required: A report id, from list_reports.get_report_csvGet a report as CSV
The report as CSV, one row per question and assistant, exactly as the report's own Download CSV gives it for its tier.
id string, required: A report id, from list_reports.Base URL https://answeraudit.co.uk/api/v1. Routes for your reports need a personal API key, sent as Authorization: Bearer aa_key_.... A sign-in from an AI assistant works only with the MCP server, not here. Public routes need no key. The full description is at openapi.json (OpenAPI 3.1).
Every route reads only, with GET. A reply is { data, meta } when it works, where meta holds the version and when the reply was made, and { error: { code, message } } when it does not. The codes are unauthorized, rate_limited, not_found, bad_request, not_ready, method_not_allowed and server_error. A report that is still being built answers ready: false with its status, and its CSV route answers 409.
/reportsEvery report under your account.
curl -H "Authorization: Bearer aa_key_..." "https://answeraudit.co.uk/api/v1/reports"[
{
"id": "string",
"domain": "string",
"brand": "string",
"category": "string",
"market": "string",
"status": "string",
"kind": "string",
"tier": "string",
"monitored": "boolean",
"score": "number | null",
"createdAt": "date-time",
"updatedAt": "date-time",
"parentId": "string | null",
"agencyClient": {
"active": "boolean"
},
"monitor": {
"refreshed": "string | null",
"next": "string"
},
"links": {
"report": "url",
"csv": "url"
}
}
]/reports/{id}One report's summary.
id in the path, required: The report's id.curl -H "Authorization: Bearer aa_key_..." "https://answeraudit.co.uk/api/v1/reports/REPORT_ID"{
"ready": true,
"id": "string",
"domain": "string",
"brand": "string",
"category": "string",
"market": "string",
"createdAt": "date-time",
"kind": "string",
"tier": "string",
"preparedBy": {
"name": "string",
"contact": "string",
"contactHref": "string",
"logo": "string",
"whiteLabel": "boolean"
},
"score": "number",
"namedIn": "integer",
"answered": "integer",
"cited": "integer",
"questions": {
"asked": "integer",
"total": "integer"
},
"engines": [
{
"engine": "string",
"assistant": "string",
"namedIn": "integer",
"answered": "integer"
}
],
"weakestAssistant": "string | null",
"insight": "string",
"sets": [
{
"label": "string",
"kind": "category | supplied",
"givenAt": "string | null",
"score": "number",
"namedIn": "integer",
"answered": "integer",
"questions": "integer",
"movement": "{...} | null"
}
],
"gaps": [
{
"question": "string",
"namedOthers": "integer",
"answered": "integer",
"names": [
{
"name": "string",
"count": "integer"
}
],
"fit": "string"
}
],
"fixes": [
{
"text": "string",
"effort": "string | null",
"impact": "string | null"
}
],
"shareOfVoice": {
"share": "string",
"namedIn": "integer",
"mentions": "integer",
"position": {
"average": "number",
"always": "boolean",
"answers": "integer",
"text": "string"
}
},
"competitorShare": [
{
"name": "string",
"count": "integer",
"share": "string"
}
],
"otherNamed": [
{
"name": "string",
"count": "integer",
"share": "string"
}
],
"competitorDomains": [
{
"domain": "string",
"count": "integer"
}
],
"topCitedDomains": [
{
"domain": "string",
"count": "integer"
}
],
"citationChecks": "{...} | null",
"competitors": [
{
"name": "string",
"domain": "string",
"score": "number",
"namedIn": "integer",
"answered": "integer",
"cells": [
{
"question": "string",
"engine": "string",
"assistant": "string",
"named": "boolean",
"cited": "boolean",
"status": "answered | no_answer | no_ai_answer"
}
],
"shareOfVoice": {
"share": "string",
"namedIn": "integer",
"mentions": "integer",
"position": "{...} | null"
}
}
],
"pagePlan": "{...} | null",
"monitor": {
"refreshed": "string | null",
"next": "string"
},
"trial": {
"active": "boolean",
"lastDay": "string"
},
"lockedAssistants": [
"string"
],
"lockedQuestions": [
"string"
],
"markets": {
"parent": {
"id": "string",
"market": "string"
},
"children": [
{
"id": "string",
"market": "string",
"status": "string",
"score": "number | null"
}
]
},
"links": {
"report": "url",
"csv": "url"
}
}/reports/{id}/answersA report's answers, cut for its tier.
id in the path, required: The report's id.set query, optional: Only this question set: 0 for the buyer questions, then 1, 2... for each list of your own questions.question query, optional: Only this question, by its number in its set (from 1).curl -H "Authorization: Bearer aa_key_..." "https://answeraudit.co.uk/api/v1/reports/REPORT_ID/answers"{
"ready": true,
"id": "string",
"brand": "string",
"answers": [
{
"label": "string",
"kind": "category | supplied",
"answers": [
{
"n": "integer",
"question": "string",
"engine": "string",
"assistant": "string",
"status": "answered | no_answer | no_ai_answer | locked",
"brandNamed": "boolean",
"competitorsNamed": [
"string"
],
"alsoNamed": [
"string"
],
"position": "integer",
"companiesNamed": "integer",
"cited": "boolean",
"citedDomains": [
"string"
],
"text": "string",
"textCut": "full | excerpt | tease",
"error": "string"
}
],
"lockedQuestions": [
"string"
]
}
]
}/reports/{id}/historyA report's runs, as scores only.
id in the path, required: The report's id.curl -H "Authorization: Bearer aa_key_..." "https://answeraudit.co.uk/api/v1/reports/REPORT_ID/history"{
"ready": true,
"id": "string",
"versions": [
{
"version": "integer",
"date": "date-time",
"reason": "string",
"questionSet": "buyer questions | an earlier run, question set not recorded",
"score": "number | null",
"namedIn": "integer | null",
"answered": "integer | null",
"movement": {
"since": "string",
"previousScore": "number",
"gained": "integer",
"lost": "integer"
}
}
]
}/reports/{id}/csvA report as CSV.
id in the path, required: The report's id.curl -H "Authorization: Bearer aa_key_..." "https://answeraudit.co.uk/api/v1/reports/REPORT_ID/csv"Returns: CSV text, with a Content-Disposition file name.
/categoriesEvery published category.
market query, optional: Only this market, such as us, uk or global.curl "https://answeraudit.co.uk/api/v1/categories"[
{
"slug": "string",
"market": "string",
"region": "string",
"name": "string",
"head": "string",
"sector": "string",
"measured": "boolean",
"questions": "integer",
"answers": "integer",
"asked": "string | null",
"written": "string",
"assistants": [
"string"
],
"url": "url"
}
]/categories/{slug}/{market}One category in one market.
slug in the path, required: The category's slug, as in its page URL.market in the path, required: The market's short name, such as us, uk or global.curl "https://answeraudit.co.uk/api/v1/categories/crm-software/global"{
"slug": "string",
"market": "string",
"region": "string",
"name": "string",
"head": "string",
"sector": "string",
"measured": "boolean",
"questions": "integer",
"answers": "integer",
"asked": "string | null",
"written": "string",
"assistants": [
"string"
],
"url": "url",
"top": [
{
"name": "string",
"answers": "integer",
"share": "string",
"position": {
"average": "number",
"always": "boolean",
"answers": "integer",
"text": "string"
}
}
],
"moreNamed": "integer"
}/categories/{slug}/{market}/questionsA category's questions.
slug in the path, required: The category's slug, as in its page URL.market in the path, required: The market's short name, such as us, uk or global.curl "https://answeraudit.co.uk/api/v1/categories/crm-software/global/questions"[
{
"n": "integer",
"text": "string",
"topic": "string | null",
"stage": "string | null",
"slug": "string",
"hasPage": "boolean",
"url": "url | null"
}
]/categories/{slug}/{market}/questions/{question}One question's page.
slug in the path, required: The category's slug, as in its page URL.market in the path, required: The market's short name, such as us, uk or global.question in the path, required: The question's slug, from the questions list.curl "https://answeraudit.co.uk/api/v1/categories/crm-software/global/questions/QUESTION_SLUG"{
"category": {
"slug": "string",
"market": "string",
"region": "string",
"name": "string",
"head": "string",
"sector": "string",
"measured": "boolean",
"questions": "integer",
"answers": "integer",
"asked": "string | null",
"written": "string",
"assistants": [
"string"
],
"url": "url"
},
"text": "string",
"stage": "string | null",
"slug": "string",
"answers": "integer",
"assistants": [
"string"
],
"asked": "string",
"top": [
{
"name": "string",
"answers": "integer"
}
],
"moreNamed": "integer",
"citedDomains": [
{
"domain": "string",
"count": "integer"
}
],
"url": "url"
}/brandsWhere a company is named in the published league tables.
name query, required: The company name, 2 to 100 characters.curl "https://answeraudit.co.uk/api/v1/brands?name=HubSpot"[
{
"category": "string",
"head": "string",
"slug": "string",
"market": "string",
"region": "string",
"rank": "integer",
"answers": "integer",
"of": "integer",
"asked": "string",
"url": "url"
}
]/openapi.jsonThe OpenAPI 3.1 description of this API.
curl "https://answeraudit.co.uk/api/v1/openapi.json"Returns: The OpenAPI 3.1 document itself (not wrapped in data and meta).
aa_key_ and is shown once: we keep only a fingerprint of it, so we cannot show it again.An account can hold up to 10 keys. Revoke one on the same page and it stops working at once. A key reads what your account page shows you and nothing more; keep it out of web pages and shared code.
Past a limit the reply is 429 with a Retry-After header; wait that many seconds and try again.