# Wachete — how to use (mcp.ai)

Connect your Wachete account and use 11 tools for notifications straight from your AI agent. Connect with your own API key. Wachete is a web monitoring service that allows users to track changes on web pages and receive notifications based on specified criteria.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_wachete?ms=1787293500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `wachete_create_update_folder`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/wachete`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/wachete/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/wachete/create/update/folder` — Create a new folder or update an existing folder in Wachete. Folders help organize watchers into hierarchical structures. Omit the id parameter to create a new folder, or provide an id to update an ex
  - body: { id?: string, name?: string, count?: integer, parentId?: string, failedCount?: integer, pausedCount?: integer }
- `POST https://api.mcp.ai/api/wachete/create/watcher` — Create or update a Wachete watcher to monitor web page changes. Watchers check pages at specified intervals and send alerts when changes are detected. Use SinglePage mode for monitoring a single page,
  - body: { id?: string, url: string, name: string, xPath: string, alerts?: object[], jobType?: string, urlFilter?: object, crawlingDepth?: integer, recurrenceInSeconds?: integer, notificationEndpoints?: object[] }
- `POST https://api.mcp.ai/api/wachete/delete/folder` — Permanently deletes a folder along with all nested subfolders and watchers (monitoring tasks). This is a destructive operation that cannot be undone. Use when you need to remove an entire folder struc
  - body: { folder_id: string }
- `POST https://api.mcp.ai/api/wachete/delete/watcher` — Deletes a website monitoring watcher (task) by its unique ID. This operation is idempotent - deleting a non-existent or already-deleted watcher will succeed without error. Use when you need to permane
  - body: { watcher_id: string }
- `POST https://api.mcp.ai/api/wachete/get/crawler/pages` — Retrieves all pages monitored by a crawler watcher (portal monitor). Use this to get detailed information about each page being tracked including URLs, last check timestamps, content changes, and erro
  - body: { id: string }
- `POST https://api.mcp.ai/api/wachete/get/data/history` — Retrieve history for a wachet (monitor). Returns timestamped snapshots of monitored content showing when changes occurred. Supports time range filtering and optional diff with previous value. Use cont
  - body: { id: string, to?: string, from?: string, count?: integer, returnDiff?: boolean, continuationToken?: string }
- `POST https://api.mcp.ai/api/wachete/get/folder/content` — Retrieves the contents of a Wachete folder, including subfolders and watcher tasks. Use this tool to: - List all subfolders and tasks in the root folder (omit parentId) - List contents of a specific f
  - body: { parentId?: string }
- `POST https://api.mcp.ai/api/wachete/get/watcher` — Retrieve complete watcher (monitor) definition by ID. Use this to get detailed configuration and current status of a specific monitoring task including URL, XPath selector, alerts, notification endpoi
  - body: { watcher_id: string }
- `POST https://api.mcp.ai/api/wachete/list/notifications` — Retrieves notifications from Wachete watchers. Returns notifications for all watchers or filtered by specific watcher ID and/or time range. Useful for checking recent changes detected by your web page
  - body: { task_id?: string, to_time?: string, from_time?: string }
- `POST https://api.mcp.ai/api/wachete/list/watchers` — List all monitoring watchers (tasks) configured in your Wachete account. Optionally filter by search query. Returns up to 500 watchers with details including name, URL, monitoring settings, and notifi
  - body: { query?: string }
- `POST https://api.mcp.ai/api/wachete/move/items/to/folder` — Move tasks (watchers) and folders to a specified destination folder. Use this to organize your monitoring structure by relocating items within the folder hierarchy. Provide at least one of folderIds o
  - body: { task_ids?: string[], folder_id?: string, folder_ids?: string[] }

## Example prompts
- "What can I do in Wachete?"
- "Show me a summary of my Wachete account"

## More
- Page: https://mcp.ai/wachete
- Agent spec (llms.txt): https://mcp.ai/wachete/llms.txt
- Postman collection: https://mcp.ai/wachete/postman.json