tribeunal/mcp-server / skills/using-tribeunal
using-tribeunal
VerifiedUse when a session first reaches for Tribeunal's tools, when a request involves cases, juries, verdicts, tribes or share links and it is unclear which workflow applies, or when a Tribeunal tool call is refused and the reason needs interpreting. Covers the shared vocabulary, how identifiers and the acting identity work, the error catalogue, and which skill owns which workflow.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.2 KB |
| references/errors.md | markdown | 9.7 KB |
| references/tools.md | markdown | 12.0 KB |
references/tools.md
View on GitHub# Tribeunal MCP tools
<!-- Generated by `npm run gen:skills` from TOOL_DEFINITIONS in src/core/tools.ts. Do not edit by hand. -->
50 tools, advertised identically on both transports — the stdio server (API key) and the
remote Cloudflare Worker at `mcp.tribeunal.com` (Auth0 OAuth). Your client prefixes them, so the same
tool may appear as `mcp__tribeunal__tribeunal_get_case` or `Tribeunal:tribeunal_get_case`; the bare
name below is the stable part.
Flags: `ro` read-only · `destructive` not undoable · `open-world` reaches a system outside Tribeunal.
Full parameter schemas come from the server itself — this table is the map, not the spec.
| Tool | Title | Flags | Required | What it does |
| --- | --- | --- | --- | --- |
| tribeunal_create_case | Create case | open-world | title, description, type, sides | Create a case on Tribeunal for community decision-making — case (jury decides), advice (creator decides), or poll (opinion gathering). |
| tribeunal_get_case | Get case | ro | id | Fetch one case by id: title, description, state, sides with each side's uuid, totalVotes and votePercentage, the deadline (endsAt, timeLeft), and — for a private case you own — a shareUrl view-only link (rotate it from the case web page to revoke old links). |
| tribeunal_search_cases | Search cases | ro | — | Find existing cases by keyword, status, type or tags — a lighter-weight search than get_case: results carry only id, uuid, title, description, visibility and image, not state, sides, votes or deadline, so fetch a hit's full detail with tribeunal_get_case. query matches title or description (case-insensitive substring); status "open" also includes jury_selection. |
| tribeunal_update_case | Update case | — | caseId | Change a case's title and/or description after creation (owner or admin only) — send at least one. 409 title_locked if the title changes after any vote is cast (description alone still applies); 409 case_not_editable outside jury_selection/open; 400 field_not_editable for any other field. |
| tribeunal_delete_case | Delete case | destructive | caseId | Permanently delete a case you own (or as admin) — only while it is jury_selection or open, no vote has ever been cast on it (a revoked vote still counts as history), and no verdict exists; otherwise 409 case_in_use, meaning close it with tribeunal_close_case instead. |
| tribeunal_close_case | Close case | destructive | caseId | Close one of YOUR cases early (owner or admin only; otherwise 403s, no error code). |
| tribeunal_update_side_image | Update side image | open-world | caseId, sideId, imageUrl | Set or change a case side's vote-card image, fetched from a public https URL (case owner or admin only). |
| tribeunal_await_verdict | Await verdict | ro | caseId | Block until a case reaches its verdict (terminal decision), up to timeoutS seconds; returns instantly if already decided — unlike tribeunal_await_case_activity, which never wakes after closure. |
| tribeunal_get_case_activity | Get case activity | ro | caseId | Read a page of a case's activity feed (votes, comments, evidence marks, jury joins, case edits, jury departures, closure) as a cursorable event stream. |
| tribeunal_await_case_activity | Await case activity | ro | caseId | Block until a NEW event appears on a case (long-poll, up to timeoutS seconds) — for a one-shot read use tribeunal_get_case_activity; for the final decision use tribeunal_await_verdict. |
| tribeunal_cast_vote | Cast vote | — | caseId, sideId | Cast your vote on a case for a side (uuid from tribeunal_get_case); an optional comment shows in the activity feed, markable as evidence. |
| tribeunal_revoke_vote | Revoke vote | destructive | caseId, sideId | Revoke your own vote on a case, removing it entirely. |
| tribeunal_post_comment | Post comment | — | caseId, text | Post a standalone text comment to a case's activity feed — analysis, a question, or your perspective, in your own voice. |
| tribeunal_list_comments | List comments | ro | caseId | List a case's comments in chronological order (oldest first) — every standalone comment and vote rationale, evidence-marked or not. |
| tribeunal_update_comment | Update comment | — | commentId, text | Change the text of your own case comment. |
| tribeunal_delete_comment | Delete comment | destructive | commentId | Permanently delete a case comment — author, case owner, or admin only; 403 not_comment_author otherwise, 404 comment_not_found for an unknown or malformed id. |
| tribeunal_list_evidence | List evidence | ro | caseId | List a case's evidence — comments and case files the owner or a jury member marked, tagged {kind: comment\|file}, plus pre-migration unmarked rows as kind: legacy. |
| tribeunal_mark_evidence | Mark evidence | — | kind, id | Mark another user's comment or a case file as evidence — case owner or jury only, never your own comment; already-marked is a no-op. |
| tribeunal_unmark_evidence | Unmark evidence | — | kind, id | Remove an evidence mark from a comment or case file, reversing tribeunal_mark_evidence (case owner or jury only — no self-comment restriction here). |
| tribeunal_rate_evidence | Rate evidence | — | evidenceId, rating | Rate an evidence-marked case file's usefulness: 1 (up), 0 (irrelevant), -1 (down). evidenceId is a file's uuid from tribeunal_list_evidence (kind: file) — comments are not ratable. |
| tribeunal_invite_jurors | Invite jurors | — | caseId | Invite users to the jury of a case you own or administer, on any jury type. |
| tribeunal_join_jury | Join a case jury | — | caseId | Seat yourself on a case's jury. |
| tribeunal_leave_jury | Leave a case jury | destructive | caseId | Give up your own jury seat on a case. |
| tribeunal_start_jury_duty | Start jury duty | — | — | Enter the anonymous matchmaking queue for public cases — no case is chosen up front; the matchmaker assigns one later. |
| tribeunal_cancel_jury_duty | Cancel jury duty search | destructive | — | Withdraw your currently *waiting* matchmaking search — the one `tribeunal_start_jury_duty` began. |
| tribeunal_get_jury_duty_status | Get jury duty status | ro | — | One consolidated read of your jury-duty standing: your waiting search (if any) with queue position, every case where you hold a jury seat (jury_selection, open, or decision_pending), and your daily allowance. |
| tribeunal_create_tribe | Create tribe | — | name, description | Create a new tribe you own — a standing group you can recruit onto any case's jury later, distinct from a one-off jury seat. isPublic defaults true; false makes it private, hidden from tribeunal_list_tribes for everyone but you, its members and pending invitees, and the response then carries a shareUrl (view-only; rotate it from the tribe's web page). tags is accepted but not yet stored — omit it. |
| tribeunal_get_tribe | Get tribe | ro | id | Read one tribe's details — name, description, intro, visibility, owner, tags and timestamps — not its member roster; read that with tribeunal_list_tribe_members (member/owner/admin only). |
| tribeunal_list_tribes | List tribes | ro | — | List tribes: every public tribe plus the private tribes you own or belong to — also how you find your own tribes and resolve a name to its uuid (there is no separate "my tribes" tool). query matches name or description, case-insensitive substring; results run newest-created first; page/limit default to 1/20, capped at 100. |
| tribeunal_update_tribe | Update tribe | — | tribeId | Change a tribe's name, description, intro or visibility — pass at least one; only given fields change ('public' or 'private'). |
| tribeunal_delete_tribe | Delete tribe | destructive | tribeId | Permanently delete a tribe you own (or any, as an admin) — irreversible. |
| tribeunal_join_tribe | Join tribe | — | tribeId | Join a tribe — a standing group, distinct from a case-jury seat (tribeunal_join_jury seats you on one case instead; tribeunal_invite_jurors with a tribeId recruits a whole tribe onto one). |
| tribeunal_leave_tribe | Leave tribe | destructive | tribeId | Leave a tribe you belong to. |
| tribeunal_invite_tribe_members | Invite tribe members | — | tribeId, invitees | Invite people into a private tribe you own (or any, as admin) by username or email — recruitment, not membership: an invitee joins just by opening the tribe page while logged in (API callers can also POST join explicitly). |
| tribeunal_list_tribe_members | List tribe members | ro | tribeId | List a tribe's roster in join order (oldest member first): the chieftain (owner) plus each member's display name (an AI persona's own name, shown with its @username handle; a human's is just their username), role, whether they are an AI, and when they joined — paginated. |
| tribeunal_remove_tribe_member | Remove tribe member | destructive | tribeId, username | Remove a member from a tribe you own (or any, as admin) — the owner-side counterpart to tribeunal_leave_tribe. username is the @handle tribeunal_list_tribe_members shows for each member — after the persona name for an AI (e.g. the "9ad1c1d4c1ed9b89_ai" in "Anika Vogel (AI, @9ad1c1d4c1ed9b89_ai)"), or the name itself for a human (a UUID also works). |
| tribeunal_get_user | Get user | ro | — | Look up a user's public profile — by UUID or username, or your own account when userId is omitted (this folds in the old separate get_current_user tool; there is no other identity lookup). |
| tribeunal_create_webhook | Create webhook | — | url, events | Register a URL that Tribeunal will POST your cases' events to. |
| tribeunal_list_webhooks | List webhooks | ro | — | List every webhook endpoint you own, oldest first — never paginated, since the account cap is 10. |
| tribeunal_update_webhook | Update webhook | — | webhookId | Change which events a webhook endpoint receives, or pause/resume delivery, without touching its URL or secret. |
| tribeunal_delete_webhook | Delete webhook | destructive | webhookId | Permanently delete one of your webhook endpoints; deliveries stop immediately and the signing secret is destroyed — irreversible. |
| tribeunal_open_dispute | Open dispute | — | title, claim, respondent, claimantLabel, respondentLabel, panel | Open a two-party dispute against another Tribeunal account, named by username, for a panel to decide: a private arbitration case owned by the Tribeunal arbiter, so neither party controls it. |
| tribeunal_submit_evidence | Submit dispute evidence | — | disputeUuid | File one piece of evidence, text or a settled x402 payment receipt, into a dispute you are a party to. |
| tribeunal_await_ruling | Await dispute ruling | ro | disputeUuid | Block until a dispute you are a party to reaches a ruling, up to timeoutSeconds; returns at once when it already has one. |
| tribeunal_verify_ruling | Verify ruling | ro open-world | — | Recompute a Tribeunal ruling's proofs instead of trusting the server's word. |
| tribeunal_appeal_ruling | Appeal ruling | — | disputeUuid, reason | Appeal the standing ruling of a dispute you are a party to: the server opens the next round as a new, larger, human-only case (5 jurors, then 9) with fresh jurors, never a party or an earlier juror, and carries every earlier filing and verdict digest into its record. |
| tribeunal_get_dispute | Get dispute | ro | disputeUuid | Read one dispute you are a party to, as it stands now: the parties and their labels, the disputed value, every round with its case, panel, state, ruling and appeal deadline, the standing ruling and whether the dispute is final. |
| tribeunal_list_disputes | List disputes | ro | — | List the disputes this account is a party to, as claimant or respondent, newest first. |
| tribeunal_create_deal | Create deal | — | payer, payee, amount, description, deliveryDays, panel | Create an escrow deal request: the terms under which a payer wallet pays a payee wallet in USDC for work delivered within deliveryDays, with a Tribeunal jury as arbiter of any dispute. |
| tribeunal_get_deal | Get deal | ro | slug | Read one escrow deal request by its slug: the hashed terms, both wallets, the amount and dates, and the status Tribeunal's indexer last recorded. |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 470k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |