Configuration Guide
Set up your AI agents to send MCP requests through HookWatch Proxy. Replace the original MCP server URL with your proxy URL — no other changes needed.
Prerequisites
- 1 Create an account at app.hookwatch.dev
- 2 Register an MCP server in the dashboard or via the Servers API
- 3 Copy your proxy URL:
https://mcp.hookwatch.dev/p/your-slug
Claude Desktop
Edit your Claude Desktop configuration file to point MCP servers to HookWatch proxy URLs.
Config file location:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Multiple servers:
Restart required
After updating the configuration, restart Claude Desktop for changes to take effect.
Claude Code
Add MCP servers to your project's .mcp.json file in the project root:
Cursor
Add MCP servers to your Cursor workspace configuration:
Config file:
.cursor/mcp.json in your project
root
Windsurf
Configure MCP servers in Windsurf's settings:
Custom agents
Any HTTP client that can send JSON-RPC 2.0 requests works with HookWatch MCP Proxy. Send POST requests to your proxy URL.
Python
Node.js / TypeScript
MCP protocol reference
The proxy supports all standard MCP JSON-RPC 2.0 methods. Here are the most common ones:
Initialize
Start an MCP session and exchange capabilities.
List Tools
Discover available tools on the MCP server.
Call Tool
Execute a specific tool with arguments.
| Method | Description |
|---|---|
initialize | Initialize MCP session and exchange capabilities |
tools/list | List all available tools on the server |
tools/call | Execute a specific tool with arguments |
resources/list | List available resources |
resources/read | Read a specific resource |
prompts/list | List available prompts |
Authentication forwarding
If your upstream MCP server requires authentication, include the Authorization header in your request. The proxy forwards it to the upstream server.
Headers forwarded
The proxy forwards these headers to the upstream MCP server: Content-Type, Accept, and Authorization.