@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.

Related MCP server: Hookbase MCP Server

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.

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