SUBS.WATCH — MCP setup in 60 seconds

Last updated: 2026-02-11

1) Create token

Open /settings in SUBS.WATCH.
Create AI Agent Connection.
Copy token (shown once).

2) Add MCP server

Server URL: https://subs.watch/api/mcp
Header: Authorization: Bearer <TOKEN>

Example MCP config (generic)

{
  "name": "subs-watch",
  "url": "https://subs.watch/api/mcp",
  "headers": {
    "Authorization": "Bearer <SUBS_WATCH_TOKEN>"
  }
}

Example config (mcpServers format)

{
  "mcpServers": {
    "subs-watch": {
      "type": "http",
      "url": "https://subs.watch/api/mcp",
      "headers": {
        "Authorization": "Bearer <SUBS_WATCH_TOKEN>"
      }
    }
  }
}

Provider quick paste (MCP)

Use the block required by your client settings. Put token only in Secret/Auth field, not into a normal chat message.

ChatGPT

Preferred: add remote MCP server in ChatGPT connector/settings UI.
URL: https://subs.watch/api/mcp
Auth: Authorization: Bearer <SUBS_WATCH_TOKEN>

{
  "name": "subs-watch",
  "url": "https://subs.watch/api/mcp",
  "headers": {
    "Authorization": "Bearer <SUBS_WATCH_TOKEN>"
  }
}

Claude

If Claude asks for mcpServers JSON, use:

{
  "mcpServers": {
    "subs-watch": {
      "type": "http",
      "url": "https://subs.watch/api/mcp",
      "headers": {
        "Authorization": "Bearer <SUBS_WATCH_TOKEN>"
      }
    }
  }
}

Gemini

For Gemini clients with MCP support, use:

{
  "name": "subs-watch",
  "type": "http",
  "url": "https://subs.watch/api/mcp",
  "headers": {
    "Authorization": "Bearer <SUBS_WATCH_TOKEN>"
  }
}

If your Gemini UI does not expose MCP, use OpenAPI fallback: https://subs.watch/.well-known/agent-openapi.json

Perplexity

For Perplexity clients with MCP support, use:

{
  "mcpServers": {
    "subs-watch": {
      "type": "http",
      "url": "https://subs.watch/api/mcp",
      "headers": {
        "Authorization": "Bearer <SUBS_WATCH_TOKEN>"
      }
    }
  }
}

If native MCP is unavailable for your account, connect through your MCP bridge/proxy and keep the same endpoint and header.

3) Use tools

list_subscriptions
list_upcoming_payments
create_subscription
create_reminder

Security

Never paste live token into normal chat messages. Use secret/auth field only.

MCP self-test (optional)

curl -X POST "https://subs.watch/api/mcp" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <SUBS_WATCH_TOKEN>" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

curl -X POST "https://subs.watch/api/mcp" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <SUBS_WATCH_TOKEN>" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

curl -X POST "https://subs.watch/api/mcp" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <SUBS_WATCH_TOKEN>" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"list_subscriptions","arguments":{}}}'