Setup

Connect your MCP client to Promptwatch using OAuth or an API key

Claude Web

1. Open Connectors

   Go to Customize → Connectors in Claude.

2. Add custom connector

   Click +, then Add custom connector, and fill in:

   • Name: Promptwatch
   • URL: https://server.promptwatch.com/mcp

   No OAuth Client ID or secret needed.

3. Authorize

   Click Add. Complete the Promptwatch authentication in the browser that opens: sign in, select your organization and optionally a specific project, then click Allow.

Claude Desktop

OAuth (recommended)

1. Open Connectors

   In Claude Desktop, go to Customize → Connectors.

2. Add custom connector

   Click +, then Add custom connector, and fill in:

   • Name: Promptwatch
   • URL: https://server.promptwatch.com/mcp

   No OAuth Client ID or secret needed.

3. Authorize

   Click Add. Complete the Promptwatch authentication in the browser that opens: sign in, select your organization and optionally a specific project, then click Allow.

API key

Claude Desktop can also connect using the mcp-remote proxy with a Promptwatch API key.

Prerequisites

npx is required. It ships with Node.js. Install it from nodejs.org (LTS) if you don’t have it:

npx --version

1. Get your API key

Go to Settings → API Keys in your Promptwatch dashboard, click Create API Key, and copy it.

2. Open your config file

In Claude Desktop, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json. You can also find it at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Add the Promptwatch server

Add the "promptwatch" entry inside "mcpServers" (create the key if it doesn’t exist):

{
  "mcpServers": {
    "promptwatch": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://server.promptwatch.com/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Replace YOUR_API_KEY with the key from step 1.

4. Restart Claude Desktop to apply the new configuration.

Claude Code CLI

OAuth (recommended)

1. Add the server

   claude mcp add --transport http promptwatch https://server.promptwatch.com/mcp
   

   Do not pass --header. That would use API key auth and skip the OAuth flow.

2. Authenticate

   Inside a Claude Code CLI session, run:

   /mcp
   

   Select promptwatch, choose Authenticate, and complete the Promptwatch consent page in your browser.

3. Verify

   claude mcp list
   

   The server should show as Connected.

API key

1. Get your API key

   Go to Settings → API Keys in your Promptwatch dashboard, click Create API Key, and copy it.

2. Add the server

   claude mcp add --transport http promptwatch https://server.promptwatch.com/mcp \
     --header "Authorization: Bearer YOUR_API_KEY"
   

   Replace YOUR_API_KEY with the key from step 1.

3. Verify

   claude mcp list
   

   The server should show as Connected.

Cursor

1. Get your API key

   Go to Settings → API Keys in your Promptwatch dashboard, click Create API Key, and copy it.

2. Install automatically

   Click the button below. Cursor opens an install dialog. Replace YOUR_API_KEY with your key, then click Install:

   

3. Or configure manually

   Add to .cursor/mcp.json:

   {
     "mcpServers": {
       "promptwatch": {
         "url": "https://server.promptwatch.com/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_API_KEY"
         }
       }
     }
   }
   

Other MCP clients

Any MCP-compatible client can connect using:

URL:           https://server.promptwatch.com/mcp
Transport:     Streamable HTTP
Authorization: Bearer YOUR_API_KEY

If your client does not support remote HTTP servers, use the mcp-remote proxy:

{
  "mcpServers": {
    "promptwatch": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://server.promptwatch.com/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Start using it

Once connected, ask your AI assistant questions like:

• “How visible is my brand in AI search results?”
• “Which sources are LLMs citing when they mention us?”
• “Compare our AI visibility against competitors”
• “What content gaps should I address?”
• “How much traffic are we getting from AI tools?”
• “Generate a blog post for prompt X using persona Y”