# AuditSpark MCP Server

Audit any website from Claude using AuditSpark's AI-powered analysis engine — SEO, performance, accessibility, security, content quality, and 10+ other categories.

**Free tier:** 3 audits/day — register your email at https://auditspark.io/api/api-keys-register to get a key instantly.

**Paid plans** (15–60 audits/month + full reports): https://auditspark.io/#pricing

## Tools

| Tool | Description |
|---|---|
| `poll_until_done` | One-shot: start audit + wait for results (recommended) |
| `audit_website` | Start an audit, returns `auditId` immediately |
| `get_audit_status` | Check status + get free-view report |
| `get_full_report` | Fetch the full report markdown |

## Setup

**1. Install dependencies**

```bash
cd mcp && npm install
```

**2. Get an API key**

*Free (3 audits/day):*
```bash
curl -s -X POST https://auditspark.io/api/api-keys-register \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com"}'
```
Your key will arrive by email within seconds.

*Subscriber (15–60/month):* Sign in at https://auditspark.io/dashboard → API Keys tab → Generate Key.

**3. Add to your MCP config**

Claude Desktop (`~/.claude/claude_desktop_config.json`) or Claude Code (`.mcp.json`):

```json
{
  "mcpServers": {
    "auditspark": {
      "command": "node",
      "args": ["/absolute/path/to/mcp/index.js"],
      "env": {
        "AUDITSPARK_API_KEY": "ak_your_key_here"
      }
    }
  }
}
```

## Environment Variables

| Variable | Required | Description |
|---|---|---|
| `AUDITSPARK_API_KEY` | **Yes** | API key from your AuditSpark dashboard |
| `AUDITSPARK_API_URL` | No | Override API base URL (default: `https://auditspark.io/api`) |

## Example Usage

Once connected, ask Claude:

- "Audit https://example.com and tell me the top 3 issues"
- "Run a website audit on my client's site at example.com"
- "Check the SEO and performance scores for example.com"

## Quota

API audits count against your plan's monthly quota (15/mo on Freelance, 60/mo on Agency) — same pool as web audits. Quota resets on your billing date.

## Smithery / Registry

To list on [Smithery](https://smithery.ai) or [mcp.so](https://mcp.so), create `smithery.yaml` in the `mcp/` directory:

```yaml
name: auditspark
version: 1.0.0
description: AI-powered website audit — SEO, performance, accessibility, security, and more
homepage: https://auditspark.io
tools:
  - poll_until_done
  - audit_website
  - get_audit_status
  - get_full_report
startCommand:
  type: stdio
  command: node
  args: ["index.js"]
  env:
    AUDITSPARK_API_KEY:
      description: API key from your AuditSpark dashboard (auditspark.io/dashboard)
      required: true
```