Skip to content

tribeunal/mcp-server / skills/using-tribeunal

using-tribeunal

Verified

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

FileKindSize
SKILL.mdskill md3.2 KB
references/errors.mdmarkdown9.7 KB
references/tools.mdmarkdown12.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. |
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: 470kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall