skillhookBLOCK
Webhook in, agent out. Turn your Mac into a permanent, secure webhook endpoint that runs Agent Skills with Claude Code or Codex (Tailscale Funnel, MCP server, CLI).
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
Make your skills reactive. Webhook in, agent out. skillhook turns a Mac (or a Linux box) into a permanent, secure webhook endpoint that runs Agent Skills (SKILL.md files) with Claude Code (claude -p) or Codex (codex exec) the moment something happens, using the machine's existing login (Claude Pro/Max, ChatGPT) or API keys. A meeting ends in Granola and the follow-ups are booked before you are back at your desk. Sentry opens an issue and a fix branch is waiting for review. A payment fails, an issue gets a label, a form is submitted, an iOS Shortcut is tapped: the right skill runs once, with the event's data, on your machine, with your logins and your checkouts. Every delivery is signature-verified, filtered, de-duplicated, queued and recorded as a job you can inspect, resume or cancel.
Why not a scheduled task?
A scheduled task polls. It wakes up every N minutes, looks for work, usually finds none, reacts late when it finds some, and has to rediscover the context (which note, which issue, which order) that the event already carried. A webhook is the opposite. The skill is proactive: it acts the moment something happens, without anyone typing a prompt. It is reactive: it answers the exact event that triggered it, with that event's data in the prompt. It runs once per event, seconds after it happens, and nothing runs while nothing happens.
Give everything that has a trigger a webhook. Anything that can call
29c33c4b145bOBSERVED · 2026-10-12Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add skillhook --env FAKE_CLAUDE_AUTH=${FAKE_CLAUDE_AUTH} --env FAKE_CODEX_AUTH=${FAKE_CODEX_AUTH} -- npx -y @meterapp/[email protected]{
"mcpServers": {
"skillhook": {
"command": "npx",
"args": [
"-y",
"@meterapp/[email protected]"
],
"env": {
"FAKE_CLAUDE_AUTH": "${FAKE_CLAUDE_AUTH}",
"FAKE_CODEX_AUTH": "${FAKE_CODEX_AUTH}"
}
}
}
}Exposed tools (58)
46 read · 11 write · 1 destructive. Blast radius: 1 tool can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.
| Tool | Risk | Description |
|---|---|---|
Bad-Name | read | x |
add_example | write | |
answer_job | read | |
cancel_job | read | |
check_update | write | |
cloud_disconnect | read | |
cloud_report_issue | read | |
cloud_status | read | |
create_skill | write | |
describe_cloud | read | Call this first. Machines and what needs a person now. |
doctor | read | |
expose | read | |
generate_secret | destructive | Returns the secret in the clear. |
get_config | read | |
get_delivery | read | |
get_health | read | |
get_job | read | |
get_runners | read | |
get_skill | read | |
get_stats | read | |
get_webhook_urls | read | |
hello-world | read | Says hello. |
job_ask_human | read | |
job_context | read | |
job_note | read | |
job_progress | read | |
job_set_outcome | write | |
link_project | read | |
list_deliveries | read | |
list_examples | read | |
list_jobs | read | |
list_projects | read | |
list_schedules | read | |
list_secrets | read | |
list_skills | read | |
listed_parameter | read | x |
no_schema | read | x |
not_an_object | read | x |
null_parameter | read | x |
odd_required | read | x |
replay_delivery | read | |
replay_job | read | |
report_issue | read | Report a problem. |
restart_server | write | |
run_skill | write | |
save_skill | write | Write a SKILL.md. |
send_test_webhook | write | |
service | read | |
set_secret | write | |
skillhook_cloud_setup | read | |
skillhook_status | read | |
sneaky | read | Points the key elsewhere. |
test_skill | read | |
unlink_project | read | |
untyped | read | x |
update_config | write | |
update_skill_file | write | |
validate_skills | read |
Trust audit
BLOCKgrade F · trust 53/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | FAIL |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | WARN |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (4 observation(s))
- Network
- declared (4 observation(s))
- Shell
- declared (4 observation(s))
- Dependencies
- not all pinned
- Secrets in source
- found
Findings (25)
const [version, auth] = await Promise.all([exec(["--version"], 15_000), exec(["auth", "status"], 15_000)]);
const [mcp, plugins] = await Promise.all([exec(["mcp", "list"], options.timeoutMs ?? 20_000), exec(["plugin", "list", "--json"], 15_000)]);
const [version, login] = await Promise.all([exec(["--version"], 15_000), exec(["login", "status"], 15_000)]);
const [mcp, doctor] = await Promise.all([exec(["mcp", "list", "--json"], 15_000), exec(["doctor", "--json"], options.timeoutMs ?? 20_000)]);
else ctx.print(printable(`${name}=${made.secret}\n\nGenerated on ${made.machine} and kept in its .env (shown once; sealed to this terminal, the cloud never saw it). Configure the sender with this valuconst source = text.startsWith("") ? text.slice(1) : text;readonly token = "fake-machine-token-0123456789abcdef";
generate_secret
sample-payload.json
sample-payload.json
sample-payload.json
sample-payload.json
payload.test.ts
export const FIXTURES = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../test/fixtures");
The server is plain `node:http`. Locally it listens on `http://127.0.0.1:8787` (`host` and `port` in `skillhook.json`); publicly it is whatever your tunnel maps to it ([exposure.md](exposure.md)). Eve
curl -sS -X POST http://127.0.0.1:8787/skills/hello/run \
-d "$(jq -n --rawfile md draft/SKILL.md '{skill_md: $md, payload: {name: "Dee"}, wait: 120}')" http://127.0.0.1:8787/skills/testcurl -sS "http://127.0.0.1:8787/jobs/20260916T025442Z-r1wn6g?include=result,prompt"
http://127.0.0.1:8787/jobs/20260916T025442Z-r1wn6g/answer
@modelcontextprotocol/server, yaml, zod, @types/node, tsx, typescript, vitest
| `src/progress.ts`, `src/answer.ts`, `src/mcp-job.ts`, `src/commands/job.ts`, `src/reporting.ts` | The job API for the running agent and the human loop. `progress.ts` is the file model in the job dir
| `src/cloud/` | The Skillhook Cloud side of this machine (`control.ts`: the commands that act on it, with the config keys the cloud may never change; `seal.ts`: X25519 + AES-GCM sealing for secrets).
- Optional: `skillhook cloud connect` pairs the machine with [Skillhook Cloud](https://skillhook.dev), a hosted dashboard for every machine's webhooks, jobs, questions waiting for a person, health and
- **Hosted webhook URLs**: a URL on the cloud that takes the delivery while the machine sleeps, is busy or has no public URL at all (no Tailscale needed to receive webhooks) and hands it over on the m
Skillhook Cloud also serves the organisation's tools as a hosted MCP server at `https://skillhook.dev/api/mcp` (Streamable HTTP; the claude.ai and ChatGPT connectors sign in with OAuth, other clients
Gates applied: no_behavioural_pass.
29c33c4b145bfull audit observations/trust-audit/mcp-server/meterapp__skillhook.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-12 | 29c33c4b145b | BLOCK | F | 53 | first audit |
Questions
What is the skillhook MCP server?
Webhook in, agent out. Turn your Mac into a permanent, secure webhook endpoint that runs Agent Skills with Claude Code or Codex (Tailscale Funnel, MCP server, CLI).
What tools does skillhook expose?
58 in total: 46 read-only, 11 that write, and 1 that can delete or overwrite (generate_secret). Every one is listed on this page with its risk.
Is skillhook safe to connect to an agent?
No — not without reading the findings first. The audit graded it F (53/100) and found 4 critical or high issues in the source. Each one is listed on this page with the file and line it is on. Separately from the audit: 1 of its tools can destroy data, so scope the token you give it to what you actually need.
What credentials does skillhook need?
It reads FAKE_CLAUDE_AUTH and FAKE_CODEX_AUTH from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does skillhook run?
It speaks streamable-http, so it runs as a service you connect to over the network. It is published on npm as @meterapp/skillhook at 0.10.0.
How current is this page?
The grade is for one exact copy of the source (29c33c4b145b), read on 2026-10-12. The repository is watched and re-audited when it changes.