# io.github.ozers/hooksense (npm · @hooksense/mcp)

Webhook & callback layer for AI agents: create a URL, wait_for_callback, and verify over MCP.

- Trust score: 54/100 (low)
- Change this week: +26
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `@hooksense/mcp`: 54/100 (this document), [markdown](https://verifymcp.io/servers/ozers-hooksense/hooksense-mcp.md), [page](https://verifymcp.io/servers/ozers-hooksense/hooksense-mcp)

## Channel facts

- Registry: `npm`
- Package: `@hooksense/mcp`
- Version: `0.2.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 36/100
  - Malware scan not yet available for this package.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 39 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 77/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 743 tokens (~92/item across 8 items; 8 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add ozers-hooksense -- npx -y @hooksense/mcp
```

### Codex

```bash
codex mcp add ozers-hooksense -- npx -y @hooksense/mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ozers-hooksense": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@hooksense/mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add ozers-hooksense --command npx --arg -y --arg @hooksense/mcp
```

### Hermes

```yaml
mcp_servers:
  ozers-hooksense:
    command: "npx"
    args: ["-y", "@hooksense/mcp"]
```

### Other

```json
{
  "mcpServers": {
    "ozers-hooksense": {
      "command": "npx",
      "args": [
        "-y",
        "@hooksense/mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 54, +4)

- [functional improvement] Stability: unverified → 0.23

### 2026-08-02 (score 50, +45)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Tool coverage: unverified → 100
- [functional] Licence: MIT

### 2026-08-01 (score 5, −23)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 28, +22)

- [functional improvement] Tool coverage: unverified → 100

### 2026-07-28 (score 6, −22)

- [functional regression] Tool coverage: 100 → unverified
- [functional] First check of Schema quality: unverified

### 2026-07-27 (score 28)

First indexed and scored.

## MCP tools (8)

### `list_endpoints` (~29 tokens)

List all webhook endpoints owned by the authenticated user. Returns slug, created_at, and request counts.

### `create_callback_endpoint` (~103 tokens)

Create a callback endpoint and return its URL. Hand this URL to a long-running/async job (or another agent) as its webhook/callback target, then await the result with wait_for_callback. Also works as a plain webhook capture URL for any provider (Stripe, GitHub, …).

Input parameters:

- `slug` (string): Optional human-readable slug (3-32 chars, letters/numbers/hyphens). Requires Hook plan or above. Auto-generated if omitted.

### `list_callbacks` (~105 tokens)

List callbacks received by an endpoint, newest first. Returns a summary (method, status, provider, received_at). Use `get_callback_payload` for the full body. Tip: read the newest `received_at` and pass it as `after` to wait_for_callback to wait only for what comes next.

Input parameters:

- `limit` (number): Max callbacks to return (1-100, default 20)
- `slug` (string, required): Endpoint slug (e.g. 'stripe-prod')

### `get_callback_payload` (~65 tokens)

Fetch a single received callback with full headers, decrypted body, and metadata. Use this to read the result of an async job after wait_for_callback or list_callbacks gives you a callback id.

Input parameters:

- `requestId` (string, required): Callback UUID, from wait_for_callback or list_callbacks

### `verify_signature` (~100 tokens)

Verify the HMAC signature of a received callback against the endpoint's configured secret (Stripe, GitHub, Shopify, or custom), using a timing-safe comparison. Returns whether the callback is authentic and untampered — call this before your agent acts on a payload. Requires the endpoint to have a webhook secret configured and a paid plan.

Input parameters:

- `requestId` (string, required): Callback UUID to verify
- `slug` (string, required): Endpoint slug the callback belongs to

### `replay_callback` (~87 tokens)

Replay a received callback to a target URL. The original headers and body are re-sent unchanged — useful to re-drive your handler against a known payload without re-triggering the upstream event.

Input parameters:

- `requestId` (string, required): Callback UUID to replay
- `targetUrl` (string, required): Where to POST the replayed payload (e.g. http://localhost:3000/webhooks/stripe)

### `get_endpoint` (~37 tokens)

Get details about a specific endpoint — its full URL, signature provider config, and custom response settings.

Input parameters:

- `slug` (string, required): Endpoint slug

### `wait_for_callback` (~217 tokens)

Block until the next webhook (callback) arrives at an endpoint, then return it — instead of polling. Use this for async/long-running work: kick off the job with the endpoint URL as its callback, then call wait_for_callback to receive the result the moment it lands (signature-verified, decrypted). Returns { status: 'received', request } on delivery, or { status: 'pending' } if `timeoutMs` elapses first (just call again to keep waiting). Pass `after` (the receivedAt of the last callback you saw) so a callback that arrived between calls is returned immediately rather than missed.

Input parameters:

- `after` (string): Optional ISO timestamp cursor. Any callback received after this is returned immediately without blocking — pass the previous callback's receivedAt to avoid missing one between calls.
- `slug` (string, required): Endpoint slug to wait on (from create_callback_endpoint)
- `timeoutMs` (number): How long to block before returning 'pending' (1000–60000, default 30000).

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/ozers-hooksense/hooksense-mcp#diagnostics

## Score history

- 2026-08-03: 54
- 2026-08-02: 50
- 2026-08-01: 5
- 2026-07-31: 28
- 2026-07-30: 28
- 2026-07-28: 6
- 2026-07-27: 28

## Links

- npm package: https://www.npmjs.com/package/@hooksense/mcp
- Socket report: https://socket.dev/npm/package/@hooksense/mcp
- Repository: https://github.com/ozers/hooksense-mcp
- Changelog RSS feed: https://verifymcp.io/servers/ozers-hooksense/hooksense-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/ozers-hooksense/hooksense-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/ozers-hooksense/hooksense-mcp