goppa

Goppa in your AI assistant

Ask ChatGPT, Claude or any assistant that supports MCP about your site: whether AI assistants name your business, how you rank on Google, what changed and what to do next. The answers come from your own Goppa account, with the same numbers as your dashboard.

Connector address
https://trygoppa.com/mcp/account
Checking a site works right away, with no account. Reading your own data asks you to sign in to Goppa the first time you need it.

Connect it

Step by step for Claude Code and Codex, from the terminal or the app, is on the Goppa MCP server page. The short version:

Claude

  1. Open Customize → Connectors and choose Add custom connector.
  2. Paste https://trygoppa.com/mcp/account and add it.
  3. Ask something. When a question needs your account, Claude shows a Connect button in the conversation: sign in to Goppa, click Allow, and Claude finishes the answer.

Claude Code: claude mcp add --transport http goppa https://trygoppa.com/mcp/account, then run /mcp to sign in.

ChatGPT

  1. In Settings → Plugins, turn on developer mode and add a custom MCP server with https://trygoppa.com/mcp/account (available on the ChatGPT plans that allow custom servers).
  2. When a question needs your account, ChatGPT asks you to sign in to Goppa and click Allow.

Other assistants

Any assistant or tool that supports remote MCP servers over HTTPS with OAuth sign-in can use the same address. It identifies itself with a client ID metadata document or registers itself automatically.

What you can ask

The tools

24 tools. Every tool only reads, except run_site_check, add_site, run_ai_measurement and report_fixes_applied, which write to your Goppa account (the Effect of each is in the reference below). Nothing on your site changes.

Tool and what it doesNeeds
scan_site
Check a website's AI readability
No account needed
get_study
Read Goppa's AI readiness study
No account needed
get_account
Read your Goppa account
Any account
get_next_steps
Read your next steps in Goppa
Any account
get_site_check
Read your site's AI readability check
Any account
run_site_check
Run a new AI readability check
Any account
add_site
Add a site to your Goppa account
Any account
run_ai_measurement
Measure whether AI names your site
Any account
get_ai_visibility
Read whether AI names your site
Any account (history: paid plan)
get_google_rankings
Read your Google rankings
Google SEO (free accounts: summary)
get_site_audit
Read your Google site audit
Google SEO (free accounts: summary)
get_what_changed
Read what changed in AI answers
Paid plan
get_weekly_summary
Read your weekly summary
Paid plan
get_ai_traffic
Read real AI use on your site
Paid plan
get_competitors
Read who AI names instead of you
Paid AI plan
get_ai_sources
Read the sources AI cited
Paid AI plan
get_ai_answers
Read the measured AI answers
Paid AI plan
get_google_overview
Read your Google search overview
Paid plan with Google SEO
get_keyword_ideas
Read your keyword ideas
Paid plan with Google SEO
get_google_competitors
Read your Google competitors
Paid plan with Google SEO
get_backlinks
Read your backlinks
Paid plan with Google SEO
get_seo_fixes
Read your SEO fixes
Paid plan with Google SEO
get_fixes_to_apply
Get the approved SEO fixes to apply
Paid plan with Google SEO
report_fixes_applied
Report the SEO fixes you applied
Paid plan with Google SEO

A tool outside your plan answers not_in_current_plan instead of data. Approving fixes, adding keywords and changing your plan happen in your Goppa dashboard.

Tool reference

Each tool as your assistant sees it: what it does, its inputs, the keys of its answer, its effect, who can use it and its limits.

get_account · Read your Goppa account

Your Goppa account: plan, sites, AI measurements used and left this month (and in total, where the account has a total), keyword research left, the next scheduled AI measurement and the next automatic site check.

Inputs:

Output: plan, sites, sites_page, ai_measurements, ai_traffic_window_days, google_seo, keyword_research_this_month, next_scheduled_measurement, measurement_schedule, automatic_site_check, plus the fields of every account answer.

Effect: Read-only: it reads Goppa's own data and changes nothing.

Access: Any account. Needs your Goppa account connected (scope goppa.read).

Limits: Lists come 10 items at a time; pass next_cursor to read the next page.

get_ai_visibility · Read whether AI names your site

Whether AI assistants named your site in the latest Goppa measurement, one engine at a time (ChatGPT, Gemini, Google AI Overview, Google AI Mode, Perplexity): named in k of n answers, the market and the date, with earlier measurements of the same questions. A percentage is given only from 10 answers.

Inputs:

Output: measured, measured_at, questions, engines, rule, named_rule_version, named_rule, history_starts_at_rule_change, history_starts_at_model_change, measurement_in_progress, by_stage, by_topic, fan_out, product_share_of_voice, ads, prompt_research, sentiment, brand_facts, by_location, daily, plus the fields of every account answer.

Effect: Read-only: it reads Goppa's own data and changes nothing.

Access: Any account (history: paid plan). Needs your Goppa account connected (scope goppa.read).

get_what_changed · Read what changed in AI answers

What changed between the two latest comparable measurements, with a paired test over the same questions and engines: pairs gained, pairs lost, and whether the change is real or within normal ups and downs.

Inputs:

Output: state, verdict, from, to, pairs, gained, lost, p_value, by_engine, gained_pairs, lost_pairs, method, named_rule_version, rule_changed, model_changed, plus the fields of every account answer.

Effect: Read-only: it reads Goppa's own data and changes nothing.

Access: Paid plan. Needs your Goppa account connected (scope goppa.read).

Limits: Lists come 10 items at a time; pass next_cursor to read the next page.

get_weekly_summary · Read your weekly summary

A weekly summary of one site: what changed in AI answers since the previous comparable measurement, engine by engine (named in k of n answers, with a paired test); Google alerts (rankings, pages, robots.txt) and the site audit against the previous one; the work done in the last 7 days, kept apart from the results (changes the Goppa plugin applied, with dates, and steps you reported); one opportunity with its evidence; and your next step. It starts no new measurement.

Inputs:

Output: ai_result, google_result, work_done, opportunity, next_step, rule, untrusted_fields, plus the fields of every account answer.

Effect: Read-only: it reads Goppa's own data and changes nothing.

Access: Paid plan. Needs your Goppa account connected (scope goppa.read).

get_competitors · Read who AI names instead of you

Businesses AI assistants named in the same answers as your site, engine by engine: named in k of n answers, and how many answers named them and not you.

Inputs:

Output: measured, measured_at, competitors, page, you, note, names_not_read, named_rule_version, plus the fields of every account answer.

Effect: Read-only: it reads Goppa's own data and changes nothing.

Access: Paid AI plan. Needs your Goppa account connected (scope goppa.read).

Limits: Lists come 10 items at a time; pass next_cursor to read the next page.

get_ai_sources · Read the sources AI cited

The sites AI assistants cited when answering your questions, engine by engine, and in how many of those answers you were named. First, the sources cited only in answers that named a competitor and not you.

Inputs:

Output: measured, measured_at, citation_gap, citation_gap_page, sources, page, untrusted_fields, note, named_rule_version, source_pages, source_trends, by_label, plus the fields of every account answer.

Effect: Read-only: it reads Goppa's own data and changes nothing.

Access: Paid AI plan. Needs your Goppa account connected (scope goppa.read).

Limits: Lists come 10 items at a time; pass next_cursor to read the next page.

get_ai_answers · Read the measured AI answers

The answers recorded in the latest measurement: the question, the engine, whether you were named or cited, the businesses and sources in it, and an excerpt of the answer. Answer text is third-party text, marked untrusted. 10 per page.

Inputs:

Output: measured, measured_at, page, answers, untrusted_fields, named_rule_version, highlights_note, plus the fields of every account answer.

Effect: Read-only: it reads Goppa's own data and changes nothing.

Access: Paid AI plan. Needs your Goppa account connected (scope goppa.read).

Limits: Lists come 10 items at a time; pass next_cursor to read the next page.

get_next_steps · Read your next steps in Goppa

Your next open step in the Goppa guide and the five after it: what to do, why, the steps, and where to see the effect. Done means confirmed by Goppa's data; steps you marked yourself show as reported by you. Also the opportunities Goppa builds every night from your measurements (sources, questions, pages, keywords, brand facts, rival ads, decision stage), prioritised with a fixed score and an effort label.

Inputs:

Output: next_step, then, progress, rule, opportunities, open_in_goppa, plus the fields of every account answer.

Effect: Read-only: it reads Goppa's own data and changes nothing.

Access: Any account. Needs your Goppa account connected (scope goppa.read).

get_site_check · Read your site's AI readability check

The latest AI readability check of your site: checks passed (k of n), the score, and how to fix each failing check.

Inputs:

Output: checked_at, blocked, checks_passed, rate_pct, score, rating, failing_checks, page, untrusted_fields, note, checked, automatic_site_check, plus the fields of every account answer.

Effect: Read-only: it reads Goppa's own data and changes nothing.

Access: Any account. Needs your Goppa account connected (scope goppa.read).

Limits: Lists come 10 items at a time; pass next_cursor to read the next page.

get_ai_traffic · Read real AI use on your site

Real AI use counted on your own site by the Goppa plugin: pages an assistant opened to answer a person, clicks from inside AI answers, and crawler visits, kept separate and never added together.

Inputs:

Output: read, counted_by_plugin, people_asked, clicks_from_ai_answers, crawler_visits, by_engine, pages, page, untrusted_fields, note, ga4, plus the fields of every account answer.

Effect: Read-only: it reads Goppa's own data and changes nothing.

Access: Paid plan. Needs your Goppa account connected (scope goppa.read).

Limits: Lists come 10 items at a time; pass next_cursor to read the next page.

get_google_rankings · Read your Google rankings

Your tracked Google searches: the position range (Top 3, 4-10, 11-20, 21-30, not in top 30), the change since the last check, monthly searches, and ranking alerts.

Inputs:

Output: country, country_name, keywords, page, ranges, not_checked_yet, alerts, next_check, rule, google_update, plus the fields of every account answer.

Effect: Read-only: it reads Goppa's own data and changes nothing.

Access: Google SEO (free accounts: summary). Needs your Goppa account connected (scope goppa.read).

Limits: Lists come 10 items at a time; pass next_cursor to read the next page.

get_site_audit · Read your Google site audit

Your page-by-page site audit: pages without errors (k of n), each problem with how many pages have it and why it matters, and what changed since the previous audit. Also ai_readiness_pages: for the least ready pages, k of n checks for being read and cited by AI assistants, the failed checks and a ready-to-paste fix prompt for Cursor or Claude Code.

Inputs:

Output: audited, audited_at, pages_without_errors, rate_pct, complete, problems, page, since_previous_audit, orphan_pages, next_audit, ai_readiness_pages, ai_readiness_summary, ai_readiness_note, plus the fields of every account answer.

Effect: Read-only: it reads Goppa's own data and changes nothing.

Access: Google SEO (free accounts: summary). Needs your Goppa account connected (scope goppa.read).

Limits: Lists come 10 items at a time; pass next_cursor to read the next page.

get_google_overview · Read your Google search overview

Your site on Google and Bing beyond rankings: Search Console clicks and impressions over the last 28 days with the top searches and pages, the pages in Google's index, Bing clicks, the visibility index week by week, what shows in the searches you track (AI Overview, People also ask, shopping), mobile speed, and orders by channel.

Inputs:

Output: country, country_name, search_console, bing, visibility_index, search_results_features, searches_where_you_appear_in_top_100, mobile_speed, orders_by_channel, alerts, untrusted_fields, google_update, plus the fields of every account answer.

Effect: Read-only: it reads Goppa's own data and changes nothing.

Access: Paid plan with Google SEO. Needs your Goppa account connected (scope goppa.read).

get_keyword_ideas · Read your keyword ideas

Your latest Google keyword research: quick wins (searches where you already rank 4 to 20), keyword ideas with monthly searches, difficulty and intent, the research left this month, and the keyword gap: searches your Google competitors rank for and you do not.

Inputs:

Output: country, country_name, research_this_month, keyword_gap, researched, researched_at, seeds, quick_wins, ideas, page, already_ranking, note, plus the fields of every account answer.

Effect: Read-only: it reads Goppa's own data and changes nothing.

Access: Paid plan with Google SEO. Needs your Goppa account connected (scope goppa.read).

Limits: Lists come 10 items at a time; pass next_cursor to read the next page.

get_google_competitors · Read your Google competitors

The sites that rank on Google for the most of the same searches as you: keywords in common, their size, and in how many of your tracked keywords they rank above you. Large portals are listed apart.

Inputs:

Output: country, country_name, read, read_at, your_keywords_in_top_100, competitors, large_portals_left_out, note, plus the fields of every account answer.

Effect: Read-only: it reads Goppa's own data and changes nothing.

Access: Paid plan with Google SEO. Needs your Goppa account connected (scope goppa.read).

get_seo_fixes · Read your SEO fixes

The SEO fixes Goppa prepared for your pages (titles, meta descriptions, image text): the ones waiting for your approval with the current and proposed text, the ones applied on your site, and the product questions. Read-only: approving happens in Goppa.

Inputs:

Output: counts, waiting_for_your_approval, page, recently_applied, pages_read_from_your_site, fixes_paused_by_you, left_this_month, product_questions, untrusted_fields, rule, note, open_in_goppa, plus the fields of every account answer.

Effect: Read-only: it reads Goppa's own data and changes nothing.

Access: Paid plan with Google SEO. Needs your Goppa account connected (scope goppa.read).

Limits: Lists come 10 items at a time; pass next_cursor to read the next page.

run_site_check · Run a new AI readability check

Run a new AI readability check on one of your sites now and save it to your Goppa account. It reads your public pages; nothing on your site changes. Up to 10 per hour per account.

Inputs:

Output: saved, checked_at, blocked, checks_passed, rate_pct, score, rating, failing_checks, page, untrusted_fields, note, report, plus the fields of every account answer.

Effect: Saves a new AI readability check of your site to your Goppa account. It reads your public pages; nothing on your site changes.

Access: Any account. Needs your Goppa account connected (scope goppa.read).

Limits: 10 new site checks an hour per account (3 a day without a paid plan), shared with scan_site.

add_site · Add a site to your Goppa account

Add one of your websites to your Goppa account, so Goppa can check, measure and track it. It counts toward the sites your account includes. Goppa reads the site's home page to see its platform; nothing on the site changes. Adding a site that is already in the account changes nothing.

Inputs:

Output: sites_in_account, added, already_in_account, platform, next_steps, plus the fields of every account answer.

Effect: Adds a website to your Goppa account, within the sites it includes. It reads the site's home page; nothing on the site changes. Repeating it changes nothing.

Access: Any account. Needs your Goppa account connected (scope goppa.read).

Limits: 10 sites an hour per account, within the sites the account includes.

run_ai_measurement · Measure whether AI names your site

Measure whether AI assistants (ChatGPT, Gemini, Google AI Overview, Google AI Mode, Perplexity) name one of your sites, with real answers. Called without approval it returns a preview that runs nothing: the questions, the market, the engines and an approval code. Show the questions to the user and call it again with that approval only after they agree: the measurement then runs in the background for a few minutes and counts as one of the AI measurements your account includes. get_ai_visibility shows the result. Nothing on your site changes.

Inputs:

Output: started, preview, already_running, already_measured_today, approval, approval_changed, market_name, questions, times_each, engines, answers_per_engine, ready_in_minutes, measurements_this_month, requested_at, plus the fields of every account answer.

Effect: Without approval, a preview of the questions that runs nothing (it reads the site's home page and catalog). With the approval code, starts one AI measurement of your site, which counts toward the AI measurements your account includes. Nothing on your site changes.

Access: Any account. Needs your Goppa account connected (scope goppa.read).

Limits: 20 previews an hour per account; measurements within the AI measurements the account includes, at most one a day per site with the same questions.

get_fixes_to_apply · Get the approved SEO fixes to apply

The SEO fixes the user already approved in Goppa for one site, ready to apply on the site with the tools you have there (the site's code, its builder or its own app): the page, the field (title, meta description, image alt text), where it goes, the current text and the new text, exactly, and an llms.txt for a site that has none. Show the fixes to the user and apply them only with their go-ahead; then call report_fixes_applied. Reading this changes nothing.

Inputs:

Output: fixes, page, plugin_applies_the_rest, site_files, how_to_report, rule, untrusted_fields, open_in_goppa, plus the fields of every account answer.

Effect: Read-only: it reads Goppa's own data and changes nothing.

Access: Paid plan with Google SEO. Needs your Goppa account connected (scope goppa.read).

Limits: Lists come 10 items at a time; pass next_cursor to read the next page.

report_fixes_applied · Report the SEO fixes you applied

Record in Goppa which approved SEO fixes from get_fixes_to_apply were applied on the site (applied), could not be applied (not_applied, with a reason), or were undone (undone, kept). Goppa's next site audit then checks each page. It changes nothing on the site.

Inputs:

Output: recorded, not_recorded, rule, open_in_goppa, plus the fields of every account answer.

Effect: Records in your Goppa account which approved SEO fixes your AI app applied on your site, or could not apply. Nothing on your site changes; Goppa's next site audit checks each page. Repeating it changes nothing.

Access: Paid plan with Google SEO. Needs your Goppa account connected (scope goppa.read).

Limits: 50 fixes per call.

scan_site · Check a website's AI readability

Score any website 0-100 on how readable it is to AI assistants: crawler access, structured data, discovery files and agent protocols. Returns the score and the failing checks. Public information only, no account needed.

Inputs:

Output: domain, score, rating, site_type, platform, failing_checks, report, note.

Effect: Read-only: it reads the public pages of the site you give and changes nothing on it.

Access: No account needed. Works without signing in.

Limits: Without an account, checks are limited per network address. Signed in, it counts toward the account's site checks: 10 an hour (3 a day without a paid plan), shared with run_site_check.

get_study · Read Goppa's AI readiness study

Return findings from Goppa's 2026 Q3 study of 176 businesses that already rank on page one of Google: how many returned nothing to an identified crawler, which checks fail most, and how technical readiness related to being mentioned by AI assistants.

Inputs: none.

Output: edition, measured_on, sites_attempted, sites_scored, returned_nothing_to_crawler_pct, markets, top_failures_pct, headline_finding, dataset, report, caveats.

Effect: Read-only: it reads Goppa's own data and changes nothing.

Access: No account needed. Works without signing in.

Fields in every account answer

Every account tool answer with data carries these fields. The not_in_current_plan answer, the which-site question (site_required) and tool errors carry none of them.

FieldWhat it says
siteThe site the answer is about, by domain.
marketThe country or region the data is for (for example uk), when there is one.
languageThe language the AI questions were asked in.
as_ofThe date of the data. null in live reads of your account (it is never invented).
periodThe dates the answer covers, from and to.
data_statusThe state of the data: demo, limited_by_plan, disconnected, measuring, failed, not_measured, not_comparable, stale, measured_zero, measured.
sampleWhat was counted: questions, engines, answers, pages or days.
evidence_idsThe ids of the site check or site audit behind the answer.
summaryOne sentence in English with the numbers, ready to quote.
next_actionWhat to do next, when there is something to do.
workspace_urlA link that opens the same data for that site in Goppa.
partialtrue when part of the data could not be read.
missingWhich parts could not be read.

Ready-made questions

The connector also offers 5 ready-made questions (MCP prompts). Your assistant may show them as prompts or slash commands; each one tells it which of the tools above to call, and none starts a measurement. Each takes an optional site.

QuestionWhat you get
What should I improve first?
improve_first
The one thing to improve first on your site, with its evidence and the next step from your Goppa guide.
Who appeared instead of me?
who_appeared_instead
The businesses AI assistants named in answers where your site was not named, engine by engine.
Which sources cited competitors?
sources_citing_competitors
The sites AI assistants cited in answers that named a competitor and not you, engine by engine.
What changed since last week?
what_changed_this_week
What changed in AI answers since the previous comparable measurement, engine by engine, and the work done in the last week, kept apart.
Write a short update for my client.
client_update
A short update on one site to send to your client: the work done and the results, kept apart.

Limits

What comes back when something is wrong

AnswerWhat it means
HTTP 401Your Goppa account is not connected, or the sign-in expired. It carries WWW-Authenticate and _meta["mcp/www_authenticate"], which make the assistant offer to connect.
HTTP 403The request came from a web page that is not allowed (Origin), or the connection does not have the goppa.read scope.
HTTP 429Too many calls (see Limits). Retry-After says how many seconds to wait.
HTTP 503Sign-in could not be checked right now. Try again after Retry-After.
HTTP 400The request is not valid MCP: -32700 (not JSON-RPC), -32600 (no method), -32020 (a header does not match the request body) or -32022 (a protocol version we do not support, with the supported list).
HTTP 404-32601: a method this server does not have (in 2026-07-28 requests).
HTTP 405A GET from an MCP client: the connector takes POST.
-32602An unknown tool or prompt, or a prompt argument that does not fit.
isError: trueThe tool ran and could not answer: the text says what happened and what to do (a wrong argument, a site that is not in your account, a limit reached).
available: falseWith reason: not_in_current_plan: that data is not part of the account's current plan.
site_required: trueThe account has more than one site and the call did not say which: it lists the sites to choose from.

How to read the numbers

Your data and access

Details are in the Privacy Policy and the Terms of Service.

Help

If the connector stops answering or sign-in fails, remove it from your assistant and add it again. Still stuck? Write to contact@trygoppa.com with the assistant you use and what you asked.

← Goppa  ·  Privacy Policy  ·  Terms of Service