VisualQ MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| VISUALQ_API_KEY | Yes | Your VisualQ API key (prefix vq_live_) | |
| VISUALQ_BASE_URL | No | Base URL of VisualQ server, defaults to https://visualq.ai | https://visualq.ai |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_projectsA | List projects accessible with the current credentials. |
| list_scenariosC | List VRT scenarios (labels, URLs, viewports) for the project. |
| run_vrtC | Run a VRT comparison against baselines. |
| run_baselineC | Capture new VRT baselines. |
| get_run_statusB | Get status and summary for a run. |
| wait_for_runC | Poll until a run completes or times out. |
| get_run_failuresC | List failed scenarios with mismatch % from a VRT run (batch, no images). |
| get_diff_statsC | Detailed diff stats for one scenario from the latest VRT run. |
| get_quality_scoreC | Composite quality score and pillar breakdown for the project. |
| get_run_historyC | Recent VRT and audit runs for the project. |
| get_scenario_detailsC | Full configuration for one VRT scenario. |
| compare_runsC | Compare metrics between two runs. |
| check_setup_healthC | Project setup blockers and warnings before running audits. |
| explain_vrt_failureC | Structured VRT failure analysis with hypotheses and next actions. |
| perf_get_latest_reportD | Latest performance audit report. |
| seo_get_reportD | Latest SEO audit report. |
| a11y_get_reportD | Latest accessibility audit report. |
| tracking_get_planD | Analytics tracking plan for the project. |
| approve_vrt_resultsB | Approve failed VRT results and promote them to baselines. Requires confirm: true and explicit scenario list. |
| create_comparison_ruleC | Add a VRT comparison rule (ignore, dynamic, layout_only) on a scenario. Requires confirm: true. |
| run_frt_featureC | Run an FRT feature test suite. Requires confirm: true. |
| post_pr_commentB | Post or update a VisualQ VRT summary comment on a GitHub PR (requires GitHub integration). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| diagnose-vrt-failure | Workflow to diagnose the latest VRT failures |
| pre-merge-check | Run VRT and summarize blockers before merge |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| latest-failures | Failed scenarios from the latest VRT run (batch summary) |
| quality-score | Composite quality score for the API-key project |
TDQS
Scored across 22 tools
Most tools target distinct resources and actions: scenario listing/detail, run execution, failure/diff extraction, audit reports, approval, rules, and PR posting. A few pairs could be confused, such as wait_for_run vs get_run_status and run_baseline vs approve_vrt_results, but descriptions and return shapes generally separate them. Overall, the boundaries are clear enough for an agent to select correctly in most cases.
The dominant pattern is verb_noun, e.g., list_projects, run_vrt, get_run_history, approve_vrt_results, and post_pr_comment. The audit/tracking tools break this slightly with prefix_get style like perf_get_latest_report and tracking_get_plan, and wait_for_run uses a phrasal verb. These are minor deviations rather than a chaotic mix.
22 tools is on the heavy side, especially with some functional overlap such as wait_for_run wrapping get_run_status polling and get_run_failures vs get_diff_stats both reporting VRT diff details. The broad scope across VRT, FRT, audits, tracking, setup, and PR integration explains the count, but trimming convenience/overlapping tools would make the surface feel tighter. It is borderline, not grossly excessive.
The VRT lifecycle is well covered: scenarios, run, status, failures, diffs, analysis, approval, baseline capture, comparison rules, and PR comments. Gaps include no scenario create/update/delete, no run trigger for perf/SEO/a11y audits despite check_setup_health mentioning audits, and no cancel-run or historical audit report retrieval. These are workaroundable if configuration and audit scheduling are managed externally, but they are real gaps.