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.
https://trygoppa.com/mcp/accountChecking 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.
Step by step for Claude Code and Codex, from the terminal or the app, is on the Goppa MCP server page. The short version:
https://trygoppa.com/mcp/account and add it.Claude Code: claude mcp add --transport http goppa https://trygoppa.com/mcp/account,
then run /mcp to sign in.
https://trygoppa.com/mcp/account
(available on the ChatGPT plans that allow custom servers).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.
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 does | Needs |
|---|---|
scan_siteCheck a website's AI readability | No account needed |
get_studyRead Goppa's AI readiness study | No account needed |
get_accountRead your Goppa account | Any account |
get_next_stepsRead your next steps in Goppa | Any account |
get_site_checkRead your site's AI readability check | Any account |
run_site_checkRun a new AI readability check | Any account |
add_siteAdd a site to your Goppa account | Any account |
run_ai_measurementMeasure whether AI names your site | Any account |
get_ai_visibilityRead whether AI names your site | Any account (history: paid plan) |
get_google_rankingsRead your Google rankings | Google SEO (free accounts: summary) |
get_site_auditRead your Google site audit | Google SEO (free accounts: summary) |
get_what_changedRead what changed in AI answers | Paid plan |
get_weekly_summaryRead your weekly summary | Paid plan |
get_ai_trafficRead real AI use on your site | Paid plan |
get_competitorsRead who AI names instead of you | Paid AI plan |
get_ai_sourcesRead the sources AI cited | Paid AI plan |
get_ai_answersRead the measured AI answers | Paid AI plan |
get_google_overviewRead your Google search overview | Paid plan with Google SEO |
get_keyword_ideasRead your keyword ideas | Paid plan with Google SEO |
get_google_competitorsRead your Google competitors | Paid plan with Google SEO |
get_backlinksRead your backlinks | Paid plan with Google SEO |
get_seo_fixesRead your SEO fixes | Paid plan with Google SEO |
get_fixes_to_applyGet the approved SEO fixes to apply | Paid plan with Google SEO |
report_fixes_appliedReport 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.
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 accountYour 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:
site (text, optional): Optional: one of your sites in Goppa, by domain (example.com), to also read that site's measurement schedule, automatic check and keyword research. Without it, the account as a whole and its sites.cursor (text, optional): next_cursor from the previous page, to read the next 10 items.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 siteWhether 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:
site (text, optional): One of your sites in Goppa, by domain (example.com). Required when the account has more than one site: without it, the answer lists the sites to choose from. With a single site it can be left out.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 answersWhat 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:
site (text, optional): One of your sites in Goppa, by domain (example.com). Required when the account has more than one site: without it, the answer lists the sites to choose from. With a single site it can be left out.cursor (text, optional): next_cursor from gained_pairs.page or lost_pairs.page, to read the next 10 of that list (the other list starts again from its first page).gained_cursor (text, optional): next_cursor from gained_pairs.page, to read the next 10 gained pairs.lost_cursor (text, optional): next_cursor from lost_pairs.page, to read the next 10 lost pairs.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 summaryA 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:
site (text, optional): One of your sites in Goppa, by domain (example.com). Required when the account has more than one site: without it, the answer lists the sites to choose from. With a single site it can be left out.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 youBusinesses 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:
site (text, optional): One of your sites in Goppa, by domain (example.com). Required when the account has more than one site: without it, the answer lists the sites to choose from. With a single site it can be left out.cursor (text, optional): next_cursor from the previous page, to read the next 10 items.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 citedThe 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:
site (text, optional): One of your sites in Goppa, by domain (example.com). Required when the account has more than one site: without it, the answer lists the sites to choose from. With a single site it can be left out.cursor (text, optional): next_cursor from the previous page, to read the next 10 items.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 answersThe 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:
site (text, optional): One of your sites in Goppa, by domain (example.com). Required when the account has more than one site: without it, the answer lists the sites to choose from. With a single site it can be left out.cursor (text, optional): next_cursor from the previous page, to read the next 10 items.engine (text, optional): Only the answers of this engine. One of: chatgpt, claude, copilot, gemini, google_ai_mode, google_ai_overview, perplexity.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 GoppaYour 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:
site (text, optional): One of your sites in Goppa, by domain (example.com). Required when the account has more than one site: without it, the answer lists the sites to choose from. With a single site it can be left out.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 checkThe latest AI readability check of your site: checks passed (k of n), the score, and how to fix each failing check.
Inputs:
site (text, optional): One of your sites in Goppa, by domain (example.com). Required when the account has more than one site: without it, the answer lists the sites to choose from. With a single site it can be left out.cursor (text, optional): next_cursor from the previous page, to read the next 10 items.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 siteReal 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:
site (text, optional): One of your sites in Goppa, by domain (example.com). Required when the account has more than one site: without it, the answer lists the sites to choose from. With a single site it can be left out.cursor (text, optional): next_cursor from the previous page, to read the next 10 items.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 rankingsYour 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:
site (text, optional): One of your sites in Goppa, by domain (example.com). Required when the account has more than one site: without it, the answer lists the sites to choose from. With a single site it can be left out.cursor (text, optional): next_cursor from the previous page, to read the next 10 items.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 auditYour 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:
site (text, optional): One of your sites in Goppa, by domain (example.com). Required when the account has more than one site: without it, the answer lists the sites to choose from. With a single site it can be left out.cursor (text, optional): next_cursor from the previous page, to read the next 10 items.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 overviewYour 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:
site (text, optional): One of your sites in Goppa, by domain (example.com). Required when the account has more than one site: without it, the answer lists the sites to choose from. With a single site it can be left out.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 ideasYour 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:
site (text, optional): One of your sites in Goppa, by domain (example.com). Required when the account has more than one site: without it, the answer lists the sites to choose from. With a single site it can be left out.cursor (text, optional): next_cursor from the previous page, to read the next 10 items.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 competitorsThe 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:
site (text, optional): One of your sites in Goppa, by domain (example.com). Required when the account has more than one site: without it, the answer lists the sites to choose from. With a single site it can be left out.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_backlinks · Read your backlinksThe sites that link to yours: linking sites, backlinks and broken backlinks, new and lost month by month, and the link gap: sites that link to your Google competitors and not to you.
Inputs:
site (text, optional): One of your sites in Goppa, by domain (example.com). Required when the account has more than one site: without it, the answer lists the sites to choose from. With a single site it can be left out.Output: read, read_at, linking_sites, backlinks, broken_backlinks, by_month, link_gap, 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 fixesThe 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:
site (text, optional): One of your sites in Goppa, by domain (example.com). Required when the account has more than one site: without it, the answer lists the sites to choose from. With a single site it can be left out.cursor (text, optional): next_cursor from the previous page, to read the next 10 items.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 checkRun 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:
site (text, optional): One of your sites in Goppa, by domain (example.com). Required when the account has more than one site: without it, the answer lists the sites to choose from. With a single site it can be left out.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 accountAdd 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:
site (text, required): The website address to add, like yourstore.com.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 siteMeasure 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:
site (text, optional): One of your sites in Goppa, by domain (example.com). Required when the account has more than one site: without it, the answer lists the sites to choose from. With a single site it can be left out.market (text, optional): Where to ask, as a country code (uk, us, de, fr…) or a region (eu, global). Without it, the market of the site's earlier measurements or the one Goppa detected.categories (list, optional): The products or services to ask about, like 'running shoes' (3 to 35 characters each). Without it, the categories on the site. Categories saved in Goppa's settings come first.approval (text, optional): The approval code from the preview, sent only after the user agreed to the questions. Without it, only the preview.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 applyThe 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:
site (text, optional): One of your sites in Goppa, by domain (example.com). Required when the account has more than one site: without it, the answer lists the sites to choose from. With a single site it can be left out.cursor (text, optional): next_cursor from the previous page, to read the next 10 items.include_site_files (true or false, optional): Also suggest an llms.txt built from the pages Goppa read (default true).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 appliedRecord 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:
site (text, optional): One of your sites in Goppa, by domain (example.com). Required when the account has more than one site: without it, the answer lists the sites to choose from. With a single site it can be left out.results (list, optional): One entry per fix handled, up to 50 per call.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 readabilityScore 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:
url (text, required): Website address, e.g. example.comOutput: 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 studyReturn 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.
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.
| Field | What it says |
|---|---|
site | The site the answer is about, by domain. |
market | The country or region the data is for (for example uk), when there is one. |
language | The language the AI questions were asked in. |
as_of | The date of the data. null in live reads of your account (it is never invented). |
period | The dates the answer covers, from and to. |
data_status | The state of the data: demo, limited_by_plan, disconnected, measuring, failed, not_measured, not_comparable, stale, measured_zero, measured. |
sample | What was counted: questions, engines, answers, pages or days. |
evidence_ids | The ids of the site check or site audit behind the answer. |
summary | One sentence in English with the numbers, ready to quote. |
next_action | What to do next, when there is something to do. |
workspace_url | A link that opens the same data for that site in Goppa. |
partial | true when part of the data could not be read. |
missing | Which parts could not be read. |
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.
| Question | What 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. |
next_cursor for the next page.| Answer | What it means |
|---|---|
| HTTP 401 | Your 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 403 | The request came from a web page that is not allowed (Origin), or the connection does not have the goppa.read scope. |
| HTTP 429 | Too many calls (see Limits). Retry-After says how many seconds to wait. |
| HTTP 503 | Sign-in could not be checked right now. Try again after Retry-After. |
| HTTP 400 | The 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 405 | A GET from an MCP client: the connector takes POST. |
-32602 | An unknown tool or prompt, or a prompt argument that does not fit. |
isError: true | The 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: false | With reason: not_in_current_plan: that data is not part of the account's current plan. |
site_required: true | The account has more than one site and the call did not say which: it lists the sites to choose from. |
null.null means not measured; 0 means measured as
zero.untrusted: your assistant treats it as data, never
as instructions.as_of (the
date of the data), data_status (such as
measured, stale or not_measured),
partial with missing when part of the data
could not be read, and workspace_url, a link to the same
data in Goppa. The not_in_current_plan answer, the
which-site question (site_required) and tool errors
carry none of them. Each tool declares its output schema.Details are in the Privacy Policy and the Terms of Service.
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.