> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sitespy.app/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Integration

> Connect Site Spy to AI assistants like Claude, Cursor, and other MCP-compatible tools

Site Spy provides an [MCP server](https://www.npmjs.com/package/@site-spy/mcp-server) that lets AI assistants monitor websites, compare snapshots, and manage watches through natural language.

## Setup

1. Copy your API key from [Dashboard Settings > API & Monitoring](https://sitespy.app/dashboard/settings?tab=api)
2. Add the following configuration to your AI client's settings file:

```json theme={null}
{
  "mcpServers": {
    "site-spy": {
      "command": "npx",
      "args": ["-y", "@site-spy/mcp-server"],
      "env": {
        "SITE_SPY_API_KEY": "your-api-key"
      }
    }
  }
}
```

> **OpenClaw users:** You can run `openclaw mcp set site-spy npx -y @site-spy/mcp-server` or add it to your `openclaw.yaml` file instead.

3. Restart your AI client — Site Spy tools appear automatically

## Configuration file locations

| Client                   | Path                                                              |
| ------------------------ | ----------------------------------------------------------------- |
| Claude Desktop (macOS)   | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Claude Desktop (Windows) | `%APPDATA%\Claude\claude_desktop_config.json`                     |
| Claude Code              | `.mcp.json` in project root                                       |
| Cursor                   | `.cursor/mcp.json` in project root                                |
| OpenClaw                 | `openclaw.yaml` in project root or `~/.openclaw/openclaw.yaml`    |

## Available tools

### Read tools (all plans)

| Tool                 | Description                                       |
| -------------------- | ------------------------------------------------- |
| `authenticate`       | Connect to Site Spy with an API key               |
| `auth_status`        | Check whether the MCP server is authenticated     |
| `list_watches`       | List all monitored websites                       |
| `get_watch`          | Get full details of a specific watch              |
| `get_change_history` | Get timestamps when changes were detected         |
| `get_snapshot`       | Get page content captured at a specific timestamp |
| `get_diff`           | Compare page content between two timestamps       |
| `search_watches`     | Search watches by URL, title, or content          |
| `list_tags`          | List all available tags                           |
| `get_rss_settings`   | Get RSS feed settings                             |
| `get_notifications`  | Get current notification settings                 |

### Write tools (Starter and above)

| Tool                 | Description                        |
| -------------------- | ---------------------------------- |
| `create_watch`       | Start monitoring a URL for changes |
| `update_watch`       | Update a watch's configuration     |
| `delete_watch`       | Stop monitoring a URL              |
| `trigger_recheck`    | Force an immediate recheck         |
| `generate_rss_token` | Generate or regenerate RSS token   |
| `revoke_rss_token`   | Revoke RSS feed token              |

### AI tools (Pro and above)

| Tool             | Description                                                      |
| ---------------- | ---------------------------------------------------------------- |
| `get_ai_summary` | Get AI-generated plain-English summary of the most recent change |

## Plan limits

MCP access follows the same plan limits as the REST API:

| Plan     | MCP access                                     |
| -------- | ---------------------------------------------- |
| Free     | Read-only (100 requests/day)                   |
| Starter  | Full access (1,000 requests/day)               |
| Pro      | Full access + AI summary (10,000 requests/day) |
| Business | Full access + AI summary (50,000 requests/day) |

## Example usage

Once connected, you can ask your AI assistant things like:

* "What changed on my watches recently?"
* "Start monitoring [https://example.com/pricing](https://example.com/pricing) for price changes"
* "Show me the diff for my Amazon watch"
* "Summarize the latest change on my competitor's site"
* "Recheck all my watches"

## Troubleshooting

* **"Not authenticated" errors** — Make sure `SITE_SPY_API_KEY` is set correctly in the config. You can verify by asking the assistant to run `auth_status`.
* **Tools not appearing** — Restart your AI client after adding the config. Ensure `npx` is available (requires Node.js 18+).
* **"Write access required" errors** — Free plan has read-only MCP access. Upgrade to Starter or above for write operations.
* **"Pro plan required" errors** — The `get_ai_summary` tool requires Pro or Business plan.