@zhook/mcp-server

The official Model Context Protocol (MCP) server for zhook, enabling AI agents to interact with your Zhook webhooks, events, and metrics.

Features

• Create Hooks: Create new webhooks or MQTT hooks directly from your agent.
• List Hooks: Retrieve a list of your configured webhooks.
• Inspect Events: View recent events for a specific hook.
• Wait for Event: Pause execution and wait for a specific event to occur.
• Metrics: Access detailed metrics about your webhook performance.

Installation

You can run this server using npx or install it globally.

Using npx (Recommended for Claude Desktop)

Add the following to your MCP configuration (e.g., claude_desktop_config.json):

{
  "mcpServers": {
    "zhook": {
      "command": "npx",
      "args": [
        "-y",
        "@zhook/mcp-server"
      ],
      "env": {
        "ZHOOK_API_KEY": "your_api_key_here"
      }
    }
  }
}

Manual Installation

npm install -g @zhook/mcp-server

Then run it:

zhook-mcp

Configuration

The server requires a Zhook API key to authenticate requests. You can obtain this key from your Zhook dashboard in the user settings page.

Environment Variable	Description	Required
ZHOOK_API_KEY	Your Zhook API Key	Yes

Tools

Hooks

• zhook_list_hooks: List all webhooks configured in the Zhook account.
• zhook_get_hook: Get detailed configuration for a specific webhook.
• zhook_create_hook: Create a new webhook or MQTT hook.
• zhook_trigger_webhook: Send a test webhook event to a specific Hook.

Events

• zhook_list_events: List recent events received by a specific hook.
• zhook_get_event: Get the full JSON payload and details of a specific event.
• zhook_wait_for_event: Connects to the Zhook WebSocket and waits for the NEXT event to arrive.

Destinations

• zhook_list_destinations: List all destinations configured for a specific webhook.
• zhook_get_destination: Get detailed configuration for a specific destination.
• zhook_create_destination: Add a new destination to a hook.
• zhook_update_destination: Update an existing destination's configuration.
• zhook_delete_destination: Remove a destination from a hook.

Transformations

• zhook_list_transformations: List all transformations configured for a specific webhook.
• zhook_create_transformation: Create a new JSONata transformation for a hook.
• zhook_update_transformation: Update an existing transformation.
• zhook_delete_transformation: Delete a transformation from a hook.

Metrics

• zhook_get_hook_metrics: Get real-time metrics (request counts, success/failure rates).
• zhook_get_aggregated_hook_metrics: Get historical aggregated metrics with custom date ranges.

Usage in Editors & Tools

VSCode

1. Open the Command Palette (Ctrl+Shift+P).
2. Type and select "MCP Servers" (or configured extension command).
3. Add the server configuration as shown above.

Antigravity (Agent)

1. Click the "..." (More Options) menu in the top-right toolbar.
2. Select "MCP Servers" and then "Manage MCP Servers".
3. Add the server configuration (Name: zhook, Command: npx, Args: -y @zhook/mcp-server, Env: ZHOOK_API_KEY=...).

License

ISC