# squirrelscan [Health: Active]

**Category:** 🎯 Marketing  
**Repository:** https://github.com/squirrelscan/skills  
**GitHub Stars:** 106  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/squirrelscan

## Description
Audit websites for SEO, performance, security, accessibility and agent experience issues.

## Tools
Capabilities this server exposes over MCP:

- **run_audit** — Run a cloud audit of a website (crawl + 300+ rule analysis + report). Only for sites the user owns or is authorized to test. Credits are spent as the audit runs (pay-as-you-go). The dry run is optional: pass confirm: true on the first call to start straight away. Without confirm, an audit whose estimate is over the org's auto-run threshold comes back as status "confirmation_required" with the estimate to show the user; one at or under the threshold just starts. That response carries "sufficient": true means the organization can pay, so show the estimate and call again with confirm: true; false means it cannot, and the response then carries the cost, the balance, the credit reset date and an upgrade_url for that organization. Relay those, and do NOT retry with confirm: true, which is refused. Pick the audit with level: quick (25 pages from the seed and sitemaps with external link checks, without the cloud checks), surface (100 pages, one per URL pattern, with the cloud checks and external link checks) or full (500 pages, every page it can reach; Pro and Team only: on the Free plan a full request crawls one page per URL pattern instead, up to the plan's page ceiling, and says so in level_notice). Without level the website's own level applies (a new website starts on surface). Every level checks external links, quick included, unless the website's external link setting or this run's external_links turns them off; each distinct external link the cloud verifies costs 1 credit (a link it cannot verify costs nothing), at most one per page of the page budget, and the estimate includes it. Use max_pages to size the crawl (max_pages: 1 audits just the entry URL, the cheapest run). Audits are asynchronous and take minutes: poll get_audit_status with the returned run_id, then fetch results with get_report. The website is registered automatically on first audit. A started run carries a schedule field describing the site's recurring audits: when state is active say so, since each of those runs costs credits, and settings_url is where the user turns them off. pending_first_audit: true means they switch on by themselves after this site's first successful audit, estimated_cost is the most they spend per run, week and month, and update_website_settings with schedule "off" turns them off. squirrelscan audits are meant to be tailored to each site through rules: rule classes that do not apply to a site (no privacy, about or contact pages on a hobby site, say) are disabled in its disable_rules, not re-reported on every audit, so the score reflects what matters for that site. Local runs read the disable list in squirrel.toml; cloud runs cannot see the repository and use the website's stored disable_rules.
- **get_audit_status** — Poll a running audit by run_id (from run_audit or list_audits). Status queued/pending/running means keep polling (every 15-30 seconds): the response includes a progress field (phase, message, page/link counts) when available. Status queued means cloud audits are busy and the run is waiting for a slot: it starts by itself, and its queue field gives its position, a rough eta_minutes (null when unknown) and a message to pass on. Do not start the audit again. Status completed means the report is ready: call get_report with the same run_id. Status failed/cancelled includes the error and completion reason. A failed run also carries failure_reason_code (one of dns, tls, connection, timeout, http_4xx, http_5xx, redirect, robots, audit_timeout, stalled, unknown) and failure_next_step, so you can act on the cause rather than parsing the error sentence, plus failure_diagnostics: attribution (target_site, squirrelscan, mixed or unknown; never guess past it), category, stage, the observations that support it, what remains uncertain, and the bounded list of fetch attempts; legacy is true when the run predates recorded evidence. A cancelled run has none of these, because it was stopped rather than defeated by the site. Once the run has a report, health_score and issues_found are read from that published report, so they equal get_report's summary.healthScore and its failed+warnings (#1700). health_score is null for a blocked or unreachable site: that audit has no meaningful grade. It is also null, with partial: true, for a run started with a rule include filter (run_audit `rules`): a score computed from a subset of the rules is not the site's score (get_report returns the per-rule results of such a run instead). A completed run also carries a schedule field describing the website's recurring audits: state is off, active, capped, unschedulable or paused, cadence_label reads as a sentence, settings_url is where the user changes the cadence or turns it off, and cap says how many scheduled sites the plan funds and how many are spent. estimated_cost is the most those runs spend per run, week and month. Recurring audits turn on by themselves after a site's first successful audit and each run costs credits, so pass that on rather than leaving the user to discover the charge.
- **list_audits** — List the organization's audit runs: currently active (queued/pending/running; queued means waiting for a free cloud slot, and it starts by itself) plus recent runs of any status. Pass website_id (from list_websites) to get one website's full audit history, oldest runs included, and page through it with limit/offset using the returned total/has_more. This is the way to reach the preserved reports of a soft-deleted website: its runs still list under its old website_id. total/has_more describe the `recent` array only, and `recent` already includes any queued/pending/running run, so `active` is a live view of those same runs and not extra items to add to the count. Use the run ids with get_audit_status or get_report, and website ids with list_issues. Numbers on a recent run come from its published report (#1700): health_score is that report's overall score (the same value as get_report's summary.healthScore; null when the site was blocked or down, which earns no grade, and null with partial: true on a run started with a rule include filter, whose subset score is withheld) and issues_found is the report's failing + warning checks (its summary.failed + summary.warnings). health_score is the metric to compare run over run: it is the only one rescored consistently across the whole site. Do NOT compare issues_found with the `open` count from list_issues: the issue tracker folds a rule failing on many pages into one open issue and carries issues forward until they are re-checked, so its count is legitimately much smaller and moves independently.
- **list_websites** — List websites the organization has audited, with their latest run status, health score, and owned/prospect kind. Each row carries last_run_id (the latest run, any status) and last_report_run_id / last_report_id (the latest completed run whose report has not been deleted). Pass last_report_run_id to get_report to read a website's newest report without knowing a run id in advance, or list_audits with website_id for its full history. Use the website_id with list_issues/get_issue. Websites registered but never audited do not appear; run_audit or add_website registers a new one. Ephemeral one-shot audits never appear. Returns total/has_more for pagination. Filter by kind to separate sites the user runs from one-off prospect audits: kind: "prospect" returns ONLY sites explicitly marked as such, so it is the safe way to build a bulk-delete list.
- **add_website** — Register a website with the organization without running an audit (run_audit registers automatically, so this is only needed to set a site up ahead of time). Returns the website_id. Calling it again for the same domain returns the existing website, and a kind or scope passed again replaces the stored one. Pass kind to classify it as owned or prospect up front. On a plan with scheduled audits, a NEW site's recurring audits switch on by themselves after its first successful audit, and each of those runs costs credits: tell the user before calling this; update_website_settings with schedule "off" turns them off. The result's scheduled_audits field reports what was set.
- **delete_website** — Delete a website from the organization (soft delete: past audits, reports, and issues are preserved, and published report links keep working). Frees a slot under the plan's website limit. Re-adding the same domain later registers a fresh website with a new website_id. Call once without confirm to see what will happen; call again with confirm: true to delete. To remove many sites at once, use delete_websites.
- **delete_websites** — Delete up to 50 websites in one call, for cleaning up a dashboard that has filled with one-off or prospect audits. Same soft delete as delete_website (past audits, reports, and issues are preserved, published report links keep working, slots are freed) and the same two-step confirm: call once without confirm to see the domain behind every id, then again with confirm: true. EVERY result echoes the domain, so read them back to the user before and after: an id is not a name, and this is the tool most likely to be pointed at the wrong list. The preview also shows each site's kind and an owned_count: unclassified sites read as owned, so an 'owned' entry in a list you built from prospects is the clearest sign the wrong ids were assembled. Ids that do not resolve are reported per-id, never as a whole-call failure. To pick the ids, list_websites with kind: "prospect" returns only sites explicitly marked disposable.
- **get_website_settings** — Read one website's stored audit settings: its audit level (quick, surface, full or custom) with the page cap, crawl strategy, rendering and external link checks it sets, the crawl depth, crawl scope, include/exclude patterns and internal link checks, whether broken link alerts are on (broken_link_alerts, Pro and Team), whether the user confirmed the site is theirs (ownership_confirmed), its disable_rules (rule ids and category globs switched off for its cloud audits, with disabled_rule_count rules matched), and its recurring-audit schedule. runs_as is how the next audit runs on the organization's plan (a level or page cap the plan does not run is held to the plan there, with a notice) and credits_per_run_max is the most one audit of it can cost. schedule says whether recurring audits are on; pending_first_audit: true means they switch on by themselves after the site's first successful audit, and estimated_cost is the most they spend per run, week and month. squirrelscan audits are meant to be tailored to each site through rules: rule classes that do not apply to a site (no privacy, about or contact pages on a hobby site, say) are disabled in its disable_rules, not re-reported on every audit, so the score reflects what matters for that site. Local runs read the disable list in squirrel.toml; cloud runs cannot see the repository and use the website's stored disable_rules.
- **update_website_settings** — Change one website's stored audit settings: level, max_pages, render, external_links, max_depth, scope, include_patterns, exclude_patterns and internal_links, broken_link_alerts (Pro and Team; switching it off is allowed on every plan), disable_rules (rule ids such as eeat/about-page and category globs such as eeat/*, with the same meaning as the disable list in squirrel.toml; replaces the stored list, and an empty list re-enables everything), schedule (off, daily, weekly or monthly) for its recurring audits, and confirm_ownership, which records that the user owns the site or is authorized to audit it (set it only when they have said so). Omitted fields are left unchanged. Values are checked the same way the dashboard's settings are and held to the organization's plan; the result reports what is stored afterwards, which fields were applied, and any plan clamp. Turning recurring audits on, changing their cadence, or a change that raises the most one audit can cost returns status "confirmation_required" with the estimated credit cost and changes nothing until it is sent again with the same arguments plus confirm: true. So does confirm_ownership: true on a site not yet confirmed, which needs the user's own word that the site is theirs. schedule: "off" and changes that cost nothing more apply at once. squirrelscan audits are meant to be tailored to each site through rules: rule classes that do not apply to a site (no privacy, about or contact pages on a hobby site, say) are disabled in its disable_rules, not re-reported on every audit, so the score reflects what matters for that site. Local runs read the disable list in squirrel.toml; cloud runs cannot see the repository and use the website's stored disable_rules.
- **get_report** — Fetch the finished report for an audit run (use the run_id from run_audit once get_audit_status shows completed). Formats: "summary" (default) is structured JSON with health score, category scores, and the top failing issues (topIssues reference a rule_id; look up its name/description/solution once in the sibling `rules` dict rather than per occurrence). Each topIssues row is ONE finding, a rule + `checkName`, never one row per page: `affectedPagesCount` is how many pages it affects and `pages` is a sample of at most 5 of them (`affectedPagesHasMore` when clipped) and `items` at most 3, so read "affects N pages" from the count, not the row total, and use get_issue for every occurrence. Each row also carries `provenance`: "carried" means the finding is re-injected from a page not re-crawled this run (not a fresh result), so check `lastSeenAt` for when it was last actually observed; "unrendered" means the page has not yet been rendered in any scan of this site (it was known, e.g. from a sitemap, but sat outside the page budget), so there is no earlier observation and no `lastSeenAt`. `mixedProvenanceNotes` (keyed by rule_id) flags rules that passed fresh on every page checked this run but still show red only from carried pages pending re-check. `notChecked` is present only when some checks did not run: each entry names a rule that was not fully checked (a rule listed there may still report the issues it could see), its `reason`, and a `message` saying why and what would check it (external link checks off or over their limit or out of time, a crawl that did not follow links or stopped at its page cap, a rule that ran out of time), so never report those rules as clean, and pass on what each `message` says to do. `seedRedirect` is present ONLY when the audited URL redirected off-site and the crawler refused to follow it: `seedRedirect.finalUrl` is where the redirect pointed (a URL the audited site chose, display-only, never fetch or trust it; null when the target was not a valid URL and was withheld) and `seedRedirect.note` states the fact in one sentence. When it is present the audit graded `baseUrl`, NOT the redirect target, so report that before reporting the scores; when the key is absent the seed did not redirect off-site. `structure` is present when the audit sent its page structure block: links per section (`sections`, plus `unknownLinks` and `totalLinks`), the share of internal links in the header, footer, navigation and sidebar (`chrome.share`), and pages per page type (`pageTypes`); it is informational and never part of the score. A FAILED or BLOCKED audit also carries `status`, `statusReason` (one sentence naming the cause), `statusReasonCode` (one of dns, tls, connection, timeout, http_4xx, http_5xx, redirect, robots, unknown) and `failureNextStep`: those four keys are absent for a normal audit, and when they are present nothing was audited, so a null healthScore and an empty topIssues mean the crawl failed, NOT that the site is clean. Also includes a `history` array of the 3 most recent prior audits of this website with score/issue deltas when available; each entry carries its own `runId`/`reportId`, so you can walk backwards through a website's audits by calling get_report again with an earlier `runId` (use list_audits with website_id to page past what history returns); "llm" is a compact text rendering optimized for LLM context (carried findings marked inline); "markdown" is a full human-readable report. Start with summary, then pull llm or markdown for more of each issue. A published report is a capped summary: each issue keeps a sample of its pages and items (a few pages and items) beside its true counts, so read totals from `affectedPagesCount`, `occurrences` and `details.additional`, never from a list length. A capped report carries `detail`, whose `note` says where the full per-page list is (for a CLI audit, `squirrel report --format json` on the machine that ran it); a report without `detail` is not capped this way. This report is the source of truth for the run's numbers (#1700): summary.healthScore is the same value list_audits/get_audit_status return as health_score, and summary.failed + summary.warnings is the same total they return as issues_found. Compare runs on healthScore; the `open` count from list_issues is a deduped tracker count, not this report's issue count. `rulesDisabledByConfig` (summary and rule_ids; a line at the top of llm and markdown) says how many rules the website's stored disable_rules switched off for this run, e.g. "3 rules disabled by config", so scores read against the same rule set; it is shown in every format, 0 included, for a cloud run that recorded its rule selection, and absent otherwise. `includeFilter` (summary; `include_filter` in rule_ids; a line at the top of llm and markdown) is present only when the run was started with a rule include filter (run_audit `rules`): it lists the patterns and how many rules ran (`rulesSelected` of `rulesTotal`), so a filtered report is never read as a full rule set, and its scores and issue counts are not comparable to a full audit's. A filtered run is also `partial` (summary: `partial: true`; rule_ids: `partial: true`): its `healthScore` and every category `score` are null, and llm and markdown print the score as N/A, because a score computed from a subset of the rules is not the site's score. `partial` is absent for a run without a filter. A partial summary also carries `results`: one entry for EVERY rule the run selected (ruleId, category, name, severity, `status` pass, warn, fail, info, skipped or not_applicable, `skipReason` as an enum for the last two, and an `evidence` object of counts and rule-authored tokens, with per-bot `bots` verdicts for ax/ai-crawlers), so a passing or skipped rule is not read from the silence of topIssues. `results` holds no text from the audited site, and is absent for a run without a filter; `status` skipped with `skipReason` not_reported means the rule was selected but the stored report has no result for it, which is never a pass. Audits should be tailored to each site through rules: classes that do not apply to a site (no privacy, about or contact pages on a hobby site, say) are disabled in the website's disable_rules (update_website_settings) rather than re-reported on every audit. Local runs read squirrel.toml; cloud runs use the stored list. format "rule_ids" returns just the distinct failing or warning rule ids of the whole report (rule_ids, plus name, category, status and occurrences per rule), uncapped, which is what to pick from when building a disable_rules list. It carries the status, statusReason and notChecked the summary carries, when they apply, so an empty list on a failed run or with unchecked rules is not a clean site.
- **compare_audits** — Compare two completed audits of one website and get what changed. Defaults to the website's latest completed audit against the one before it; pass base/head run ids to compare any two. Each finding gets one of eight kinds: new, resolved, worsened, improved, unchanged (both audits published it), still_open (still there, but one audit did not list it: the evidence store says it is open although the newer audit did not republish it, or the older audit's capped report sampled it out; `sampledOut` marks a clipped one, which is never counted as new; a sampled class that fails more often is listed in `sampledClassGrowth` and still counts as a change), not_crawled (the page was not visited, so the issue is neither fixed nor still broken), or not_checked (the newer audit could not run that rule, a capped crawl's inbound-link rules or a check that did not run, so its issue is neither fixed nor still broken; `skipReason` says why). resolutionEvidence says what backed the resolved verdicts; when it is "none" nothing is reported as fixed. Score movement is broken down by category. A website with only one audit returns first_run with an empty finding list; an audit where nothing moved returns changed: false. Unchanged, still-open, not-crawled and not-checked rows are omitted unless requested; totals count every kind.
- **list_issues** — List a website's open audit issues (like a bug tracker: each issue is one failing rule with occurrences across pages, numbered per website). Returns issues sorted by severity. `total`, `returned` and `has_more` describe the issues matching YOUR filters; `website_totals` (by_status, active_by_severity: open and in_progress) always counts the whole website regardless of filters, so the two can differ (it replaces the earlier `severity_summary` and `status_counts` fields). Rows omit the long `recommendation` (use get_rule with the row's rule_id, or get_issue, or pass include_recommendation: true). Use the issue number with get_issue for full detail and comments. Filter by status/severity/category to narrow down. After a smart audit each row also carries `provenance`: "fresh" means this audit re-checked the issue, "carried" means it only survives because its pages were not re-crawled this audit, so `last_seen_at` (when it was last actually observed) is the evidence date, not `last_detected_at`, and a carried issue needs a re-crawl to confirm before you act on it; "unrendered" means its page has never been rendered in any scan (no earlier observation, no `last_seen_at`). Both keys are absent when the website's audits carry none. This is a per-website tracker spanning audits, not a per-run count: one rule failing on 600 pages is ONE issue here, and an issue stays open until an audit re-checks it. So the open count is expected to be far smaller than a run's issues_found (list_audits) or a report's failed+warnings, and the two are not comparable (#1700). To compare runs, use health_score from list_audits.
- **get_issue** — Fetch one issue by website_id + issue number, including its full description, recommendation, affected pages, occurrence detail from the latest report (which page/image/URL, snippets), and comment thread. The issue carries `provenance` as in list_issues ("fresh": re-checked this audit; "carried": not re-crawled, so `last_seen_at` is when it was last actually observed and a re-crawl should confirm it before you edit anything; "unrendered": never rendered, no `last_seen_at`; both keys absent when none was recorded). `occurrence_count` is the true total; the listed occurrences are a sample when `occurrences_truncated` is true, and on a capped report `full_detail` says where every occurrence is. Use comment_on_issue to add analysis or a fix note to the thread.
- **comment_on_issue** — Post a comment on a website issue to record analysis, a proposed fix, or what you changed, so the team sees it in the dashboard issue thread. Markdown is supported.
- **list_entities** — List the entities a site declares in its JSON-LD, collapsed across every crawled page into one graph, so an Organization declared identically on 60 pages is one row rather than 60. Declarations collapse by resolved @id, or by type and name when there is no @id, so the SAME real-world thing can still occupy several rows when its declared identity differs between pages: a relative @id such as "#organization" resolves against each page and yields one row per page. That is the split-identity problem, not a quirk of this tool. Filter by @type, by declaring page, by problem class, or by a text match on the name. Page-local entities (a page's own WebPage, BreadcrumbList and unnamed images) usually outnumber the site's actual subject matter and are hidden unless include_page_local is true. Returns the site-wide summary (it does not change with the filters), a filtered block with the node and edge counts that survived them, a page of nodes, total, and hasMore; keep requesting pages while hasMore is true rather than describing a site from one page. Fix-and-verify loop: call list_entities with problem="no-id" to find entities declared on several pages with nothing to tie them together, give each one an absolute @id, re-run the audit with run_audit, then call compare_entities and check that gainedId contains the keys you fixed. gainedId is the only confirmation that the fix landed: an entity that gained an @id changes key, so it would otherwise look like one removal plus one addition. Check each entry's coverage field before calling it done: "proven" means the newer audit visited every page that declared the broken version AND found the replacement on all of them, "partial" means one of those could not be established.
- **get_entity** — Get one entity as the map recorded it: the properties the map keeps (name, url, logo, image, sameAs, telephone, email, address, description), the pages that declare it, the properties whose values disagree between those pages, and the references in and out of it. The map keeps those nine and @type, and it also compares six legal identifiers (legalName, vatID, taxID, leiCode, duns, iso6523Code) for conflicts without storing them; a node with a url conflict can also carry an @identity entry that guards localized URL aliases and is not a finding. A property missing here may still be in the page's JSON-LD, and a disagreement in any other property is not detected. Accepts the entity key, its @id, or its name. Use this after list_entities to see why an entity was flagged, before deciding what to change. Edges and declaring pages are capped; the counts tell you when. Fix-and-verify loop: call list_entities with problem="no-id" to find entities declared on several pages with nothing to tie them together, give each one an absolute @id, re-run the audit with run_audit, then call compare_entities and check that gainedId contains the keys you fixed. gainedId is the only confirmation that the fix landed: an entity that gained an @id changes key, so it would otherwise look like one removal plus one addition. Check each entry's coverage field before calling it done: "proven" means the newer audit visited every page that declared the broken version AND found the replacement on all of them, "partial" means one of those could not be established.
- **get_entity_graph** — Get the whole entity graph, or a filtered part of it, in a chosen format: json for the canonical document, jsonld for a validator, mermaid or markdown to read in a conversation, dot or graphml for a graph tool. Defaults to json. Takes the same filters as list_entities. mermaid caps declared entities at 150 and markdown caps rows at 50, and both say so in truncation; json, jsonld, dot and graphml apply no node cap. No cap is not the same as complete: every format renders the stored map, and on the local server that map carries no per-edge page list and no per-page reference list, so those arrays are empty because they were never stored rather than because nothing matched. mermaid's cap bounds declared entities only, so one entity referencing thousands of undeclared ids still renders thousands of placeholder nodes. Not every server implements every format: one that does not will say so rather than return an empty or partial graph, so read the error rather than treating a refusal as a site with nothing to draw. Fix-and-verify loop: call list_entities with problem="no-id" to find entities declared on several pages with nothing to tie them together, give each one an absolute @id, re-run the audit with run_audit, then call compare_entities and check that gainedId contains the keys you fixed. gainedId is the only confirmation that the fix landed: an entity that gained an @id changes key, so it would otherwise look like one removal plus one addition. Check each entry's coverage field before calling it done: "proven" means the newer audit visited every page that declared the broken version AND found the replacement on all of them, "partial" means one of those could not be established.
- **compare_entities** — Compare two audits of a site and get the change set: entities added and removed, entities that gained or lost an @id, occurrence changes, new and resolved conflicts and dangling references, summary deltas, and the pages each audit saw that the other did not. Defaults to the previous audit versus the latest. An entity is only reported as removed when every page that declared it was crawled again; anything unproven is reported separately as not crawled, so a smaller crawl never reads as a site that deleted its structured data. Each gainedId and lostId entry carries a coverage field saying whether the newer audit visited every page that declared the old version and found the replacement there. Absence of a gainedId entry is not proof a fix failed: the match needs the type and the name to be unchanged, so changing the @id and the name in one edit appears as a removal plus an addition instead. Fix-and-verify loop: call list_entities with problem="no-id" to find entities declared on several pages with nothing to tie them together, give each one an absolute @id, re-run the audit with run_audit, then call compare_entities and check that gainedId contains the keys you fixed. gainedId is the only confirmation that the fix landed: an entity that gained an @id changes key, so it would otherwise look like one removal plus one addition. Check each entry's coverage field before calling it done: "proven" means the newer audit visited every page that declared the broken version AND found the replacement on all of them, "partial" means one of those could not be established.
- **get_entity_findings** — Get the schema/entity-* rule verdicts for an audit: what is wrong with the site's entity graph, which entity keys and pages each finding affects, and the fix text for each. Use this instead of re-deriving the problems from the graph yourself. Each finding names one problem across the whole site rather than one per entity, so a count of 1 can still mean hundreds of pages. The keys and pages on a finding are a SAMPLE: the rule that produced it clipped its own lists before this tool saw them, so the pages listed are never the complete affected set and no field reports how many were left out. Use list_entities with the matching problem filter for the full set. analyzed says whether the rules ran at all: false means this audit was never analyzed, so empty findings are an absence of evidence rather than a clean result. Fix-and-verify loop: call list_entities with problem="no-id" to find entities declared on several pages with nothing to tie them together, give each one an absolute @id, re-run the audit with run_audit, then call compare_entities and check that gainedId contains the keys you fixed. gainedId is the only confirmation that the fix landed: an entity that gained an @id changes key, so it would otherwise look like one removal plus one addition. Check each entry's coverage field before calling it done: "proven" means the newer audit visited every page that declared the broken version AND found the replacement on all of them, "partial" means one of those could not be established.
- **list_rules** — Browse the catalog of 300+ audit rules that run during an audit, grouped into categories (crawlability, meta tags, performance, security, accessibility, content, and more). Filter by category code or search by keyword to find what a specific rule checks. Each rule carries cloud (credit-metered), requires_cloud (reads a cloud-backed step) and requires_render (reads the headless-browser render step, skipped on a run with render off). Use get_rule for one rule's full detail.
- **get_rule** — Fetch one audit rule by id (e.g. "core/meta-title"), including what it checks, how to fix it (recommendation), its severity and score weight, a docs link, and whether it is a cloud (credit-billed) rule (`requires_cloud`) and whether it needs the render step (`requires_render`). Rule ids appear in report topIssues and issue rule_id fields.
- **whoami** — Identify the current credentials: how you are authenticated, which organization you act for, the plan, and the current credit balance. Useful at the start of a session, to see which organization the other tools act for.
- **get_credit_balance** — Get the organization's credit balance: monthly credits (reset each billing period) and pack credits (purchased, never expire). Audits spend credits pay-as-you-go while they run; run_audit shows an upper-bound estimate before starting. An audit costs 50 credits plus 2 per audited page, however the page is fetched, plus 1 per distinct external link the cloud verifies when external link checking is on (a link it cannot verify costs nothing). A balance under 52 (a one-page audit) cannot start one, and a balance that covers fewer pages than requested starts a smaller audit. Read-only.
- **list_credit_transactions** — Audit the organization's credit accounting log: grants (signup/monthly/pack/promo), debits (audit_base 50cr + audit_page 2cr per audited page + external_link 1cr per checked link + folded 0-cost services; older audits carry render rows instead of audit_page), refunds, and adjustments, newest first, paginated. Each debit/refund carries `run_id` so you can group a single audit's spend. Use this to explain why an audit cost what it cost or to reconcile a balance. For one audit's per-feature breakdown, use get_report (its `cost` field). Read-only.
- **create_api_key** — Mint a new squirrelscan API key for this organization and return it. The result contains a secret, a live credential for the organization, returned exactly once and never retrievable again; it is meant to be saved as the SQUIRRELSCAN_API_KEY environment variable for the CLI, CI, and MCP. Requires credentials carrying the keys:write scope, which OAuth sign-in grants to organization owners and admins. Minted keys cannot themselves mint keys.
- **send_feedback** — Send feedback to the squirrelscan team: a bug, a missing feature, what worked, what was confusing, missing report data, or tool ergonomics. Use it when the user wants to report something or share their experience. Works with any authenticated credentials, including read-only API keys.
- **list_notifications** — Read the organization's notification feed, newest first: what finished, what broke, and what changed since you last looked. Categories include audit_complete, issues_detected, audit_failed, broken_links, third_party_added, third_party_spread, third_party_digest, schedule_paused. Use this to catch up at the start of a session ("did last night's scheduled audit run?", "what failed?") instead of polling every website. Each entry carries the category, the human-readable title and body, a data payload with the ids involved (website_id, run_id, report_id), and whether a human has read it in the dashboard. Filter with category, or unread_only to see just what nobody has looked at yet. Paginated with limit/offset, or poll for new events: every response carries next_cursor, and passing it back as after returns only notifications created since, oldest first (offset is ignored). Read-only: this never marks anything read.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "squirrelscan": {
    "url": "https://mcp.squirrelscan.com/mcp"
  }
}
```

## Documentation

## What squirrelscan does

squirrelscan provides website auditing tools for AI agents through a hosted MCP endpoint. Audits crawl a website and evaluate pages against more than 300 rules spanning SEO, crawlability, performance, security, accessibility, content, and related categories. Results include a health score, category scores, concrete findings, affected-page counts, recommendations, and report history.

The server also exposes an issue tracker for each website. Agents can list open issues, retrieve occurrence details and affected pages, and add Markdown comments for analysis or remediation notes. Separate entity tools inspect JSON-LD structured data as a site-wide graph, including declared entities, relationships, conflicting properties, missing identifiers, dangling references, and entity-related rule findings.

## How it works

Call `run_audit` with a website URL to start an asynchronous cloud audit. The website is registered automatically on its first audit. Use `quick`, `surface`, or `full` to select the crawl level, or set `max_pages` for a smaller run; a one-page run audits only the entry URL. Poll `get_audit_status` with the returned `run_id` every 15–30 seconds until the run completes, then call `get_report`.

The default report format is structured JSON. It includes summary scores and top findings, while `llm` and `markdown` provide more extensive renderings. Reports may cap page and item samples, so agents should use the reported totals rather than list lengths. `compare_audits` identifies new, resolved, improved, worsened, unchanged, still-open, not-crawled, and not-checked findings between completed runs.

Recurring audits can activate after a website’s first successful audit on plans that support them. Scheduled runs consume credits. Audit estimates account for the base audit, crawled pages, and verified external links, and some settings changes require explicit confirmation before they take effect.

## Setup and configuration

The repository includes skills and plugins for operating the CLI and running a website fix loop. The hosted MCP server can be installed through the Claude Code plugin, the Cursor plugin or MCP installer, OpenAI Codex configuration, or an Agent Plugins-compatible setup. Skills can also be installed with:

```bash
npx skills add squirrelscan/skills
```

The squirrel CLI must be installed and available on `PATH` for the repository’s skills. Verify it with `squirrel --version`. Authentication for CLI, CI, and MCP can use the `SQUIRRELSCAN_API_KEY` environment variable. `create_api_key` returns a new organization key only once, so it must be stored when created.

## Tools and capabilities

The tool set supports:

- Starting, polling, listing, comparing, and reporting on audits.
- Registering, configuring, soft-deleting, and listing websites.
- Reading and updating crawl depth, scope, page limits, rendering, external-link checks, and recurring schedules.
- Listing rules and retrieving rule severity, recommendations, score weights, and documentation links.
- Browsing, inspecting, comparing, and exporting JSON-LD entity graphs.
- Tracking issues, retrieving occurrence details, and posting comments.
- Checking authentication, plans, balances, transactions, notifications, and audit costs.
- Sending feedback and creating organization API keys.

## Limitations and notes

Only audit websites the user owns or is authorized to test. Audits spend credits as they run; a run may require confirmation when its estimate exceeds the organization’s automatic-run threshold or when a setting increases possible cost. A queued audit starts automatically, so it should not be submitted again.

A failed or blocked audit is not evidence that a site is healthy. Its report contains a failure reason and next step, and its health score may be null. A rule listed under `notChecked` must not be treated as passing. Full audits are restricted by plan, and plan limits can clamp requested page counts or levels.

The issue tracker is site-wide and deduplicated across runs: one failing rule across many pages can be one open issue. Its open count therefore should not be compared with a report’s `issues_found` value. For run-to-run comparisons, use the report health score or `health_score` returned for the run.

_Full upstream README: https://allmcps.com/mcp/squirrelscan/readme_