Site Spy Docs

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

Site Spy provides an MCP server that lets AI assistants monitor websites, compare snapshots, and manage watches through natural language.

Setup

Copy your API key from Dashboard Settings > API & Monitoring
Add the following configuration to your AI client's settings file:

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

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

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 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.

MCP Integration