# 🕵️ Watched MCP Server

> **Website change detection for AI agents** — Monitor any URL for content changes via the [Model Context Protocol](https://modelcontextprotocol.io).

[![Glama](https://glama.ai/mcp/servers/NG-PR0JECT/mcp-watched/badges/score.svg)](https://glama.ai/mcp/servers/NG-PR0JECT/mcp-watched)

## Quick Start

Use Watched with any MCP-compatible client (Claude Desktop, Cursor, VS Code, etc.).

### Via Glama (streamable HTTP)

This server is registered on [Glama](https://glama.ai). Connect in one click:

1. Go to [glama.ai/mcp/servers/NG-PR0JECT/mcp-watched](https://glama.ai/mcp/servers/NG-PR0JECT/mcp-watched)
2. Authenticate with your `wk_` API key from [watchedapi.com](https://watchedapi.com)
3. Start monitoring URLs directly from your AI agent

### Via MCP client config

Add to your `claude_desktop_config.json` or `mcp_servers.json`:

```json
{
  "mcpServers": {
    "watched": {
      "type": "streamable-http",
      "url": "https://watchedapi.com/mcp",
      "headers": {
        "X-API-Key": "wk_your-api-key"
      }
    }
  }
}
```

### Local stdio server (advanced)

```bash
pip install -r requirements.txt
export WATCHED_API_KEY="wk_your-api-key"
python -m src.mcp_server
```

Then point your MCP client to `stdio` with command `python -m src.mcp_server`.

## Tools

| Tool | Description |
|------|-------------|
| `create_watch` | Monitor a URL for changes (interval, CSS selector, webhook optional) |
| `list_watches` | List all your watches with status |
| `get_watch` | Get full details of a specific watch |
| `delete_watch` | Remove a watch and its history |
| `get_changes` | View change history snapshots |
| `get_change_summary` | Human-readable change summaries |
| `health` | Check API connectivity |

## Example

```
> Create a watch on https://example.com/pricing, check every 60 minutes

✅ Watch created successfully!
  ID: 42
  URL: https://example.com/pricing
  Interval: 60 min
  Status: active
```

## Get an API Key

Sign up at **[watchedapi.com/signup](https://watchedapi.com/signup)** to get your free API key.

## License

MIT