tribeunal/mcp-server / skills/wiring-webhooks
wiring-webhooks
VerifiedUse when a system rather than a person needs to know what a jury decided — releasing an escrow when a case closes, updating a record on each vote, replacing a polling loop, or integrating Tribeunal into a service. Covers registering an endpoint in the right order, verifying that a delivery is genuine, which events mislead, and what to do without a rotate tool.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.7 KB |
| references/events.md | markdown | 2.9 KB |
| scripts/verify-signature.jsexecutable | script | 3.0 KB |
references/events.md
View on GitHub# Tribeunal webhook events
## Headers on every delivery
| Header | Use |
| --- | --- |
| `X-Tribeunal-Event` | The event name, e.g. `case.closed` |
| `X-Tribeunal-Delivery` | Unique per delivery attempt's payload — **deduplicate on this** |
| `X-Tribeunal-Timestamp` | Unix seconds, and half of what the signature covers |
| `X-Tribeunal-Signature` | `v1=<hex>` — see the skill for how it is computed |
Delivery is at-least-once. The same event can arrive twice, so a receiver that acts on every POST
will act twice; one that records the delivery id first will not.
## The events
| Event | Fires when | Notes |
| --- | --- | --- |
| `case.opened` | A case starts accepting votes | Also fires on reopen, so treat it as "open now", not "new" |
| `case.closed` | A case reaches a terminal state | Carries the verdict block, identical to what the await tool returns — including the outcomes that are not rulings |
| `vote.cast` | Someone votes | A vote's rationale rides here as `comment`; it does **not** also raise `comment.created` |
| `vote.revoked` | A voter withdraws | The tally moves down |
| `comment.created` | A standalone comment | Vote rationales are the exception above |
| `evidence.marked` | A comment or file is promoted to evidence | |
| `evidence.unmarked` | A mark is removed | Cannot fire after close — marks freeze |
| `jury.joined` | A juror takes a seat | On a wait-mode case, the one that eventually opens it |
| `ping` | You asked for it | **Delivered regardless of subscriptions** — a successful ping proves reachability and signing, not that your event list is right |
## Two that mislead
**`ping` ignores your subscription list.** It is a connectivity test, so a working ping on an
endpoint subscribed to nothing at all still succeeds. If real events never arrive after a good ping,
the subscription list is the first thing to check.
**`case.closed` does not mean decided.** The verdict block it carries can report no ruling — a
failed quorum, or a failed agreement requirement. A receiver that reads a winning side without
checking whether the case decided anything will act on a case that decided nothing. `acting-on-verdicts`
covers reading it.
## Receiver contract
- Answer **2xx within a few seconds**. Slow receivers are treated as failures and retried.
- Acknowledge first, work afterwards. Verify the signature, record the delivery id, return 200, and
then do the job — a receiver that finishes the work before answering invites a duplicate.
- Failures are retried a few times and then given up on. A receiver that was down for a while has
gaps, so reconcile by reading the case rather than assuming the feed was complete.
## Limits
Ten endpoints per owner; the eleventh is refused. Endpoints are owner-scoped — you only ever see
and target your own. URLs must be https and public: the server refuses private, loopback and
carrier-grade-NAT addresses, so a receiver on your laptop needs a tunnel with a public hostname.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |