@site-spy/mcp-server

MCP server that lets AI agents monitor websites for changes via Site Spy.

Track pages, get notified when content changes, view diffs and snapshots — all from your AI assistant.

Quick Start

Add to your AI client config:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

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

Claude Code (.mcp.json):

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

Cursor (.cursor/mcp.json):

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

OpenClaw (openclaw.yaml):

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

Get your API key from Site Spy Dashboard → Settings → API.

If you don't set SITE_SPY_API_KEY, the agent will ask you to authenticate interactively.

Tools

Authentication

| Tool | Description | | -------------- | ------------------------------------------------ | | authenticate | Connect with an API key (if not set via env var) | | auth_status | Check authentication status |

Watch Management

| Tool | Description | | ----------------- | ------------------------------------------------------ | | list_watches | List all monitored websites (optionally filter by tag) | | create_watch | Start monitoring a URL for changes | | get_watch | Get full details of a specific watch | | update_watch | Update config — pause/resume, change interval, rename | | delete_watch | Stop monitoring and delete a watch | | search_watches | Search watches by URL or title | | trigger_recheck | Force an immediate recheck of all watches |

Change History

| Tool | Description | | -------------------- | ---------------------------------------- | | get_change_history | Get timestamps of detected changes | | get_snapshot | Get page content at a specific timestamp | | get_diff | Compare content between two timestamps |

Personal Fetch

| Tool | Description | | ----------- | ------------------------------------------------------------------------------- | | fetch_url | One-off authenticated URL fetch through the Site Spy backend, with browser mode |

RSS Feeds

| Tool | Description | | -------------------- | ------------------------------------------------------ | | get_rss_settings | Get current RSS feed settings and token | | generate_rss_token | Generate or regenerate an RSS feed token for feed URLs | | revoke_rss_token | Revoke the RSS token, disabling all feed access |

Tags & Notifications

| Tool | Description | | ------------------- | ------------------------------------ | | list_tags | List all tags for organizing watches | | get_notifications | Get current notification settings |

RSS Feeds

Site Spy provides per-user RSS feeds so you can subscribe to change notifications in any RSS reader.

Once you have a token (via generate_rss_token), feed URLs follow this pattern:

• All watches: https://sitespy.app/api/rss?token={token}
• Single watch: https://sitespy.app/api/rss/watch/{watch_uuid}?token={token}
• By tag: https://sitespy.app/api/rss/tag/{tag_uuid}?token={token}

Environment Variables

| Variable | Description | Default | | ------------------- | --------------------------------------- | ------------------------------------------- | | SITE_SPY_API_KEY | API key for authentication | — (interactive auth) | | SITE_SPY_API_URL | Backend API URL | https://detect.coolify.vkuprin.com/api/v1 | | SITE_SPY_AUTH_URL | URL shown to users for getting API keys | https://sitespy.app/dashboard |

The backend fetch_url endpoint can be restricted with FETCH_URL_API_ENABLED, FETCH_URL_REQUIRE_MASTER_ADMIN, or FETCH_URL_ALLOWED_API_KEYS.

Documentation

Full documentation is available at docs.sitespy.app.

Example Prompts

Once configured, try asking your AI assistant:

• "Monitor https://example.com for changes every 30 minutes"
• "What websites am I monitoring?"
• "Show me what changed on my watched pages"
• "Pause all monitors tagged 'staging'"
• "Check all my sites right now"
• "Fetch this URL with the browser backend and return readable text"
• "Set up RSS feeds so I can follow changes in my feed reader"

License

ISC