Site Scanner MCP Server — how to use it
Once Evinced Site Scanner is connected to your AI assistant, you can ask about your accessibility scan results in plain language. The assistant picks the right Site Scanner tool, reads your live data and answers. This guide shows what you can ask, with prompts you can copy.
It works the same way in Claude, Claude Code, ChatGPT and Gemini Enterprise.
Before you start
Section titled “Before you start”- Connect it first. Follow the setup guide for your assistant: Claude, Claude Code, ChatGPT or Gemini Enterprise.
- You see what your account sees. You sign in with your own Evinced account, and the assistant can only read the sites and scans that account can access.
Start with your account
Section titled “Start with your account”Begin each conversation by checking which Evinced account the assistant is using. The assistant is asked to do this on its own before it reads any data, and to check with you before going on.
Which Evinced account and tenant am I signed in as?If it’s the wrong account, reconnect as shown in your assistant’s setup guide, under If something goes wrong.
What you can ask
Section titled “What you can ask”Use your site’s name as it appears in Site Scanner. Not sure of the name? Start by asking for the list of your sites.
See your sites and scores
Section titled “See your sites and scores”List my Evinced Site Scanner properties with their latest scan date and score.What's our overall accessibility score across all our sites, and how has it changed since the last scan?Understand a scan
Section titled “Understand a scan”Give me an overview of the latest scan of <site>: issues by severity, and the pages with the most issues.List the critical issues in the latest scan of <site>.Decide what to fix first
Section titled “Decide what to fix first”Ask for the fixes that improve your site the most for the least work.
What are the highest-impact fixes in the latest scan of <site>?The assistant ranks two kinds of fixes:
- Components: a piece of your site’s code, such as a menu or a card, that repeats across many pages. Fix it once and every copy is fixed.
- Widespread issues: an issue type found on many pages that usually comes from one shared cause, such as a style sheet or a page template.
Fixes are ranked the way your Evinced score is calculated: by severity, by WCAG level and by the number of issues they fix.
Then go deeper on any result:
Show me the details of the top component: the pages it's on, its selector and its code.Show me where this component sits on the page, and which larger part of the page it belongs to.For the second prompt, the assistant looks at a screenshot of the page to find the part of your code to fix, such as a navigation bar, a form or a header.
Track progress between scans
Section titled “Track progress between scans”Compare the last two scans of <site>. What was fixed, and what's new?Set up a new site
Section titled “Set up a new site”The assistant can explore a public website and suggest how to set it up in Site Scanner: where to start the crawl, how to group pages, which languages to include and how to accept the cookie banner.
Analyze https://www.example.com and suggest a Site Scanner property configuration.Review the suggestion, then ask the assistant to create it:
Create the property with that configuration.On sites in several languages, the suggestion covers the English pages only. Ask for other languages if you want them scanned too.
Tips for better answers
Section titled “Tips for better answers”- Name the scan. Say “the latest scan”, “the scan from 1 September” or “the last two scans”.
- Ask for the format you need, such as a table, a short summary for your manager, or a list of tickets for your developers.
- Ask follow-up questions. The assistant remembers the conversation, so “why is that one first?” or “show me the pages for number 3” work.
- Check before you act. The data comes from Site Scanner, but the explanations are written by the AI. Ask for a link to open a component in Site Scanner and check it there.
- Approve tool use. Your assistant may ask before it uses a Site Scanner tool. Allow it, or always allow the read-only tools you trust.
All the tools
Section titled “All the tools”You don’t need to name a tool: ask your question and the assistant chooses. This list helps if you want to.
| Tool | Access | What it does |
|---|---|---|
| Who Am I | Read | Shows the Evinced account and tenant you’re signed in as |
| List Properties | Read | Lists your sites with their score and latest scan |
| Get Property | Read | Shows the details of one site |
| List Scans | Read | Lists the scans of one site with their dates and scores |
| Get Scan Overview | Read | Summarizes one scan: issues by severity and type, pages and components |
| Get Issues | Read | Lists a scan’s issues, filtered by severity or issue type if you like |
| Get Pages | Read | Lists a scan’s pages, most issues first |
| Get Components | Read | Lists a scan’s components, most issues first |
| Get Tenant Overview | Read | Shows your overall score, critical issues and pages monitored, compared to the last scan |
| Analyze Fix ROI | Read | Ranks the fixes with the most impact in a scan |
| Get Component Details | Read | Shows a component’s pages, selector, code and issues |
| Expand Component Scope | Read | Uses a page screenshot to find the larger part of the page a component belongs to |
| Compare Scans | Read | Shows what was fixed, what’s still there and what’s new between two scans |
| Analyze Site Structure | Read | Explores a public website and suggests a property configuration |
| Create Property | Write | Adds a new site to Site Scanner |
| Preprocess Scan | Write (cache) | Prepares a scan so later questions about it answer faster |
| Clear Cache | Write (cache) | Clears prepared data, so the next answer reads fresh data from Site Scanner |
- Read: only reads, and changes nothing in your Evinced account.
- Write: changes your Evinced account. Create Property is the only one.
- Write (cache): changes only the Site Scanner MCP Server’s own copy of your scan data, never your Evinced account.
If something goes wrong
Section titled “If something goes wrong”| What you see | What to do |
|---|---|
| The assistant answers without Site Scanner data | Make sure the connector is switched on for this conversation, then ask again and add “Use the Evinced Site Scanner connector.” |
| Wrong account or tenant | Ask the assistant which account you’re using, then reconnect as shown in your assistant’s setup guide. |
| A site or scan is missing | Your Evinced account sees only the sites it has access to, and very old scans may no longer be available. Ask for the list of sites or scans to see what’s there. |
| The first answer about a scan is slow | The first analysis of a large scan reads a lot of data. Follow-up questions about the same scan are faster. |