AcuityScan MCP Server

Run AcuityScan website security, accessibility, performance, and SEO scans directly from your AI client via the Model Context Protocol.

Compatible with Claude Desktop, Cursor, Continue, and any other MCP client.

You:    Is yourpghtech.com missing any email-auth records?
Claude: [calls acuityscan_email] → Your DMARC policy is "none" (monitor
        only). SPF is configured. DKIM selectors not found at the 16
        common locations — confirm with your mail provider…

What it gives your AI

Ten tools, each wrapping one AcuityScan REST endpoint:

| Tool | What it does | | -------------------------- | ---------------------------------------------------------------------------------- | | acuityscan_full_scan | Full Site+ Scan — 350+ checks across all 8 modules (30s–5min) | | acuityscan_latest_scan | Fetch your last saved scan without re-running | | acuityscan_email | SPF, DKIM, DMARC, MX, BIMI, MTA-STS, 77 blacklists, Google/Yahoo bulk compliance | | acuityscan_dns | All records, DNSSEC, 20-resolver propagation | | acuityscan_ssl | TLS protocol + cipher, cert chain, security headers, Google Safe Browsing | | acuityscan_performance | Desktop + mobile Lighthouse, Core Web Vitals, tech-stack detection | | acuityscan_seo | Title/meta/headings/canonical/OG/sitemap/schema.org | | acuityscan_accessibility | Full axe-core WCAG 2.1 AA at desktop + mobile viewports + 38 custom checks | | acuityscan_privacy | 28+ trackers, consent banner, CCPA link, Consent Mode v2 | | acuityscan_mobile | Viewport, tap targets, font size, PWA features, intrusive interstitials |

Setup

1. Get an API key

AcuityScan API access requires the Agency plan.

1. Sign up or sign in at acuityscan.com
2. Upgrade to Agency on the pricing page
3. Open /settings → API keys and create a key
4. Copy the token — it's shown once

2. Configure your MCP client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "acuityscan": {
      "command": "npx",
      "args": ["-y", "@acuityscan/mcp"],
      "env": {
        "ACUITYSCAN_API_KEY": "asc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Quit and reopen Claude Desktop. You'll see acuityscan in the tools menu.

Cursor

Open Cursor settings → MCP → add a new server. Same command, args, and env as the Claude Desktop config above.

Continue.dev

In .continue/config.json:

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "@acuityscan/mcp"]
        },
        "env": {
          "ACUITYSCAN_API_KEY": "asc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
        }
      }
    ]
  }
}

Usage

Once configured, just ask:

• "Run a full AcuityScan on stripe.com"
• "What email-auth records is acme.com missing?"
• "Check the accessibility of vercel.com"
• "Is example.com's SSL configured correctly?"
• "Get my last scan for clientsite.com"

Your AI client will pick the right tool, send the request to AcuityScan with your API key, and explain the results in plain English.

Rate limits

The Agency plan ships with 250 API requests / 24 hours per account, shared across all your keys. Each MCP tool call counts as one request. Need more? Email [email protected].

Troubleshooting

"ACUITYSCAN_API_KEY is not set"

Your MCP client isn't passing the env var. Double-check the env block in your client config and restart the client.

"API access requires the Agency plan"

You're signed in but on Free or Pro. Upgrade at acuityscan.com/pricing. API access auto-activates within seconds of upgrading — no key re-issue needed.

"Scan timed out after 300s"

Some heavy WordPress sites push the performance / accessibility scanners to their ceiling. Retry, or run individual tools (acuityscan_dns, acuityscan_ssl, etc.) instead of acuityscan_full_scan.

Development

git clone https://github.com/acuityscan/mcp
cd mcp
npm install
ACUITYSCAN_API_KEY=asc_live_xxx npm run dev

Then in your MCP client config, swap the npx command for an absolute path to your local clone:

"command": "node",
"args": ["/path/to/mcp/dist/index.js"]

License

MIT — see LICENSE.

Links

• AcuityScan
• API reference
• Pricing
• Model Context Protocol spec