AyeWatch MCP server

AyeWatch MCP

Connect an AI assistant to AyeWatch, which monitors topics and web pages and alerts you when something changes or matches what you care about. This repository holds the connection details and listing files for the AyeWatch MCP server. The server itself is hosted by AyeWatch.

• Endpoint: https://ayewatch.ai/api/mcp
• Transport: Streamable HTTP, stateless, no session ID
• Full documentation:

What you can do

The tools manage monitors and the webhook in your own account. They do not return alert history. The webhook tools are available only when you connect with an API key, not through OAuth, because the webhook receives every alert and its secret signs them.

Example prompts:

• "List my AyeWatch monitors and tell me which are paused."
• "Create a daily AyeWatch monitor for news about solid-state batteries."
• "Pause my AyeWatch monitor about the iPhone launch."
• "Send my AyeWatch alerts to https://example.com/hooks/ayewatch."

Alerts and webhooks

Alerts don't come back through MCP. They arrive through your AyeWatch notifications or a webhook. When a monitor detects new content, AyeWatch sends a POST with a JSON body (topic ID, headline, and the update) to an HTTPS endpoint that you run.

Set that endpoint with the set_webhook tool, the REST API (PUT https://ayewatch.ai/api/v1/webhook), or Notification settings. AyeWatch signs each delivery with a secret, sent in the X-AyeWatch-Signature header. The MCP tools never return that secret, so it stays out of AI conversations; read it in Notification settings or with GET https://ayewatch.ai/api/v1/webhook. AyeWatch also emails you whenever the webhook URL is set or changed. If you didn't make a change, revoke your API keys and rotate the secret. The payload fields, timeout, and retry behavior are in the webhooks documentation. The URL is yours, not AyeWatch's, so it is not part of the MCP connection files.

Requirements

• An AyeWatch account on a paid plan. API and MCP access are included with every paid plan.
• Active monitors use credits from your plan as checks run.
• Requests are limited to 120 per minute per API key by default.

Connect

Claude Code

Install the plugin from this repository. Claude Code asks for your API key when you enable the plugin and keeps it in your system's secure credential store.

claude plugin marketplace add SRX9/ayewatch-mcp
claude plugin install ayewatch@ayewatch

Or add the server without the plugin:

claude mcp add --transport http ayewatch https://ayewatch.ai/api/mcp \
  --header "Authorization: Bearer aw_live_YOUR_API_KEY"

Cursor

If you install the AyeWatch plugin from the Cursor Marketplace, set AYEWATCHAPIKEY when Cursor asks for the plugin's configuration. Otherwise, add this to your MCP configuration (~/.cursor/mcp.json):

{
  "mcpServers": {
    "ayewatch": {
      "url": "https://ayewatch.ai/api/mcp",
      "headers": { "Authorization": "Bearer aw_live_YOUR_API_KEY" }
    }
  }
}

VS Code

Add this to .vscode/mcp.json. VS Code asks for the key when the server starts and does not store it in the file.

Shortened. The full README is on GitHub.