com.igods/gvt

Tools

• gvt_delete_test

  Permanently delete a test session and all its associated results. This action cannot be undone. Use gvt_set_test_visibility instead if you only want to hide a test from public view.

  shallow
• gvt_get_baseline

  Get the oldest baseline test snapshot for a single URL, including expired tests. For pre-computed baseline-vs-latest deltas without fetching full snapshots, use gvt_get_score_trend instead; for baselines across many URLs in one call, use gvt_list_baselines. Use with gvt_get_latest to compare baseline vs current when you need the full snapshot detail on both ends. The url must be passed exactly as the test was run — matching is exact string equality (scheme, host, path, trailing slash), not nearest-match. When unsure of the recorded form, discover it with gvt_list_tests first.

  shallow
• gvt_get_batch_status

  Retrieves the current progress, state, and test IDs (tids) of an ongoing or completed visibility testing batch. Poll this tool with the batchId returned by gvt_run_visibility_batch until status is completed or failed. A tid appears on each URL entry only after its test completes — then call gvt_get_batch_summary for the compact per-page scores and top shared issues, or gvt_get_test_results for a single test. Batch records are retained for the lifetime of the account (no automated pruning); an unknown, pruned, or foreign batchId returns 404. Read-only: consumes rate limit, never test credits. Duplicate URLs in a batch are collapsed, so counts always sum to totalUrls.

  shallow
• gvt_get_batch_summary

  Compact per-page results and pre-computed aggregates for a completed visibility testing batch: per-URL overall and category scores, findingSentence, average overall score, strongest and weakest categories, best and worst scoring pages, and the top shared issue types with their fixIds. One call replaces one gvt_get_test_results call per URL for audit and status-report workflows — a 10-URL batch drops from roughly 1.6 MB to a few KB of context. The batch must be completed (poll gvt_get_batch_status first); an in-flight batch returns its current status without per-page data. Read-only: consumes rate limit, never test credits. For element-level detail on a single page, call gvt_get_test_results with that page's tid.

  shallow
• gvt_get_fix

  Read the canonical fix record for one GVT issue type: severity range, impact, scoring weight, plain-language description, and the recommended remediation. Issue IDs come from the fixId field on issues in gvt_get_test_results output. The same content is served as the gvt://knowledge/fixes/{issue_id} resource template for resource-capable clients.

  shallow
• gvt_get_knowledge

  Read GVT reference knowledge: how scoring works, score bands and category weights, what each analysis category checks, or GEO glossary definitions. Use it to interpret test results and scores correctly instead of guessing. The same content is served as MCP resources at gvt://knowledge/app/* for resource-capable clients.

  shallow
• gvt_get_latest

  Get the most recent non-expired test snapshot for a single URL. Use with gvt_get_oldest to compare baseline vs current, or use gvt_get_score_trend for a pre-computed comparison.

  shallow
• gvt_get_oldest

  Get the oldest baseline test snapshot for a single URL, including expired tests. Use with gvt_get_latest to compare baseline vs current, or use gvt_get_score_trend for a pre-computed comparison.

  shallow
• gvt_get_oldest_list

  Get the oldest baseline test snapshots for a batch of URLs (up to 100) in a single call. Ideal for monthly/periodic batch comparisons: fetch baselines in bulk here, then call gvt_get_latest per URL. Each result includes the URL and its oldest test object (null if no test exists for that URL).

  shallow
• gvt_get_prompt

  Render a GVT prompt workflow with concrete argument values, returning the complete step-by-step instruction text ready to follow. Also returns the effective arguments that were bound (provided values plus defaults for omitted optionals). Prompt names and their arguments come from gvt_list_prompts. The rendered text references GVT tools by name — call them as instructed.

  shallow
• gvt_get_score_trend

  Compare the oldest baseline vs the latest non-expired test for a single URL or an entire domain, with pre-computed per-category deltas (latest minus baseline). Provide exactly one of url or domain. Domain mode matches the exact domain, www.<domain>, and subdomains (alphabetical, capped by limit). Page through the whole domain with offset: offset=0 for the first page, offset=limit for the second, following hasMore/nextOffset. This replaces paging the full test history and computing comparisons client-side — one call per site.

  shallow
• gvt_get_sitemap_urls

  Discovers and ranks URLs from a domain's XML sitemaps. Use this tool to find the most significant pages on a website (e.g., homepages, product pages, recently updated content) before analyzing them. Supports filtering by URL patterns and automatically flags pages blocked by robots.txt or already tested. Returns a ranked list of URLs optimized for SEO importance. Legal/policy boilerplate pages (privacy, terms, cookies, disclaimers, refund policies, etc) are flagged with legalPage:true and carry a -25 significance penalty; use the legalPages filter to drop them (exclude) or isolate them for a policy-coverage audit (only).

  shallow
• gvt_get_test_results

  Get full results for a visibility test by tid. Returns per-category resultData for all 7 analysis types (heading, semantic, accessibility, schema, javascript, nojs, social), overall scores, findingSentence, and shareableTid. If status is "pending" or "running", the test is not yet complete — wait and retry. findingSentence is a pre-generated natural language verdict; use it as the primary summary for the developer. shareableTid is non-null when the result is public and can be linked.

  shallow
• gvt_list_baselines

  Get the oldest baseline test snapshots for a batch of URLs (up to 100) in a single call. Each result includes the URL and its oldest test object (null if no test exists for that URL). For a single URL use gvt_get_baseline; for pre-computed baseline-vs-latest deltas use gvt_get_score_trend. This bulk form is ideal for monthly/periodic batch comparisons: fetch baselines in bulk here, then call gvt_get_latest per URL. One call replaces up to 100 gvt_get_baseline calls; split larger URL sets into consecutive calls of at most 100. Order of results follows the submitted order.

  shallow
• gvt_list_prompts

  List the GVT prompt workflows: user-invocable recipes that chain GVT tools into complete tasks (check a page, review a monthly batch, analyze regressions, verify fixes, set up domain monitoring, report client status). Each entry lists its arguments. Use gvt_get_prompt to render a prompt with concrete argument values, then follow the rendered instructions to run the workflow.

  shallow
• gvt_list_schedules

  Retrieves the paginated roster of the authenticated caller's test monitoring schedules, allowing filtering by domain, frequency, and status. This is the only way to discover existing schedules and their schids, which the pause/resume/cancel/change_frequency modes of gvt_schedule_test require. Completed one-off rows are hidden by default: batch runs create a throwaway once row per queued URL, so include them only with includeCompletedOnce true. The row's tid is deliberately not surfaced (it is often stale); use gvt_list_tests or gvt_get_latest for test result lookups. Read-only: consumes rate limit, never test credits.

  shallow
• gvt_list_sitemap_urls

  Discovers and ranks URLs from a domain's XML sitemaps to find the most significant pages (homepages, product pages, recently updated content) before analyzing them. Supports URL-pattern filtering and automatically flags robots.txt-blocked and already-tested pages. Legal/policy boilerplate (privacy, terms, cookies, disclaimers, refunds) is flagged legalPage:true with a -25 significance penalty; use the legalPages filter to drop it (exclude) or isolate it for a policy-coverage audit (only). Parameters group into three jobs: discovery (url), ranking and paging (limit, sort), and filtering (include and exclude URL patterns, excludeDisallowed, excludeTested, excludeScheduled, legalPages).

  shallow
• gvt_list_tests

  List visibility tests for the authenticated user, newest first. Supports filtering by domain (optionally including subdomains), by URL (exact or contains match), by creation date range, by status, and by test type.

  shallow
• gvt_run_visibility_batch

  Queue up to 500 URLs for batch GEO visibility testing. Returns a batch ID for tracking progress. Optionally add URLs to recurring schedules (daily, weekly, monthly) during the same call. Results are retrieved individually via gvt_get_test_results once the batch completes. This tool queues paid test runs and consumes credits; for score interpretation, methodology, or reference knowledge, use gvt_get_knowledge instead — it never runs tests. A webhook URL can be provided to receive a completion notification.

  shallow
• gvt_run_visibility_test

  Run a GEO visibility test on a URL. Analyzes 7 categories: JavaScript dependencies (js), no-JS rendering (nojs), semantic HTML5, heading structure, schema.org markup, social tags, and accessibility. This is an async operation — it returns a tid immediately. Pass that tid to gvt_get_test_results to retrieve scores and issues once the test completes (poll until status is not "pending" or "running").

  shallow
• gvt_schedule_test

  Manage recurring test schedules. Schedule management modes (require urls array): "add" to create or update scheduled URLs, "delete" to remove scheduled URLs (by schid or url), "reset" to reset existing schedules. In reset mode, an optional domain field scopes the reset to schedules matching that domain only (e.g. "example.com" deletes all schedules for that domain before upserting the provided URLs; omitting domain resets ALL schedules). Schedule control modes (require schid): "pause" to temporarily halt a schedule, "resume" to restart a paused schedule (also clears auto-pause reasons and failure counts), "cancel" to permanently cancel a schedule, "change_frequency" to update how often a test re-runs. Subscription-tier enforcement applies.

  shallow
• gvt_set_test_visibility

  Toggle the public visibility of a test session. Set is_public to true to make the test shareable via a public link, or false to make it private. This is the primary way to control who can view a test result without requiring MCP authentication.

  shallow
• gvt_share_test

  Enable public sharing for a test and return a shareable URL. This is a convenience wrapper around gvt_set_test_visibility (is_public=true) that also returns the full share_url the recipient can visit without any authentication.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/fcbbe7d3-1be6-4d65-b703-abd95eb5df0e/badge.svg)](https://vouch.tools/servers/fcbbe7d3-1be6-4d65-b703-abd95eb5df0e)