MCP Servers API
Register and manage MCP servers for proxying. Each server gets a unique slug used in the proxy URL.
Base URL
https://api.hookwatch.dev/v1/mcp/serversThe MCP Server Object
Properties
| Field | Type | Description |
|---|---|---|
id | string | UUID identifier for the MCP server |
user_id | string | ID of the user who created the server |
team_id | string | ID of the team that owns the server |
slug | string | URL-safe identifier used in the proxy URL (/p/:slug) |
name | string | Human-readable name for the MCP server |
target_url | string | Upstream MCP server URL where requests are forwarded |
is_active | boolean | Whether the proxy is accepting requests for this server |
created_at | string | ISO 8601 timestamp of creation |
updated_at | string | ISO 8601 timestamp of last update |
Create Server
Register a new MCP server. A unique slug is automatically generated and used to construct the proxy URL.
POST /v1/mcp/serversRequest Body
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Display name for the MCP server |
target_url | string | Yes | URL of the upstream MCP server to proxy to |
Example
The response includes the generated slug. Your proxy URL will be https://mcp.hookwatch.dev/p/slug.
List Servers
Retrieve all MCP servers for the active team.
GET /v1/mcp/serversResponse
Get Server
Retrieve a specific MCP server by ID.
GET /v1/mcp/servers/:idPath Parameters
| Field | Type | Description |
|---|---|---|
id | string | The MCP server UUID |
Update Server
Update an MCP server's name, target URL, or active status.
PUT /v1/mcp/servers/:idRequest Body
| Field | Type | Description |
|---|---|---|
name | string | New display name |
target_url | string | New upstream MCP server URL |
is_active | boolean | Enable or disable the proxy for this server |
Example
Disabling a server
Setting is_active to false will cause the proxy to
return 404 for all incoming requests
to this server's slug. Existing call logs are preserved.
Delete Server
Permanently delete an MCP server.
DELETE /v1/mcp/servers/:idExample
Warning
This action is irreversible. All call logs associated with this server will be permanently deleted.
Error Codes
| Status | Error | Description |
|---|---|---|
400 | Bad Request | Invalid request body or missing required fields |
401 | Unauthorized | Invalid or missing access token |
403 | Forbidden | MCP server limit reached for your plan |
404 | Not Found | MCP server not found |