Cases tools (paid)

These tools expose the Cases Workspace to external agents (Cursor, Claude, ChatGPT, etc.) over MCP. They require either a paid web session or a valid fam_live_… bearer key minted at Account → MCP keys.

Paid unlock is Agent Pro (same gate as market tools). Exam Academy does not unlock Cases MCP.

Indicative only — never invent FIFA articles

Always cite the source URL for any jurisprudence reference. If retrieval returns nothing, say so. Never re-host full FIFA decision PDFs.

Tools

Tool	Description
list_cases	List the caller's cases (id, title, status, tags, updated_at). Optional status only.
get_case	Full case detail — metadata, dossier items, last messages, research jobs, sources, findings.
build_case_source_pack	Build the case source pack: dossier, links, briefs, curated matches, sources, findings, negative searches.
list_case_sources	List structured sources with source_type and authority_level.
get_case_findings	List legal issues, facts, risks, arguments, negative searches, and next steps.
attach_case_source	Attach a verified source URL/title directly to the case source matrix.
search_case	Stateless retrieval over the case dossier + curated library + structured sources/findings (does not append chat history).
add_case_note	Append a free-text note/excerpt. Not auto-indexed into the case vector store in v1.
add_case_link	Attach an external URL (+ optional title / excerpt) as a dossier link.
request_case_research	Queue CaseResearchAgent research (quick / deep / exhaustive). Primary: xAI Grok; deep/exhaustive also Browser Run (Kitesurf) on allowlisted seed_urls.
search_juris_library	Read-only search over the curated jurisprudence index.

Argument shapes

// list_cases — status filter only (no limit)
{ "status": "open" }

// get_case
{ "case_id": "uuid" }

// search_case
{
  "case_id": "uuid",
  "question": "Summarise the key Article 17 issues in my dossier",
  "include_sources": true,
  "include_findings": true
}

// build_case_source_pack
{
  "case_id": "uuid",
  "depth": "deep",
  "query": "Comparable Article 17 cases for early termination"
}

// list_case_sources
{
  "case_id": "uuid",
  "authority_level": "official",
  "source_type": "fifa_portal"
}

// get_case_findings
{
  "case_id": "uuid",
  "finding_type": "negative_search"
}

// attach_case_source
{
  "case_id": "uuid",
  "url": "https://jurisprudence.fifa.com/...",
  "title": "Official FIFA portal source",
  "source_type": "fifa_portal",
  "authority_level": "official",
  "excerpt": "Short excerpt only",
  "fetch_official_pdf": true
}

// add_case_note
{
  "case_id": "uuid",
  "title": "Player meeting 2026-05-04",
  "body_markdown": "Player confirmed unilateral termination...",
  "kind": "note"   // note | excerpt
}

// add_case_link
{
  "case_id": "uuid",
  "source_url": "https://jurisprudence.fifa.com/...",
  "title": "DRC decision 12345",
  "excerpt": "Short summary..."
}

// request_case_research
{
  "case_id": "uuid",
  "query": "Comparable Article 17 cases for early termination",
  "depth": "deep",          // quick | deep | exhaustive
  "seed_urls": [
    "https://jurisprudence.fifa.com/home",
    "https://inside.fifa.com/legal/football-tribunal"
  ],
  "use_browser": true       // default true for deep/exhaustive; ignored for quick
}

// search_juris_library
{
  "q": "training compensation calculation",
  "forum": "drc",
  "year": 2025
}

Citation contract

Every chat answer or brief must include citations with at least:

• url — official source URL (FIFA portal, chamber page, etc.).
• title — short label.
• excerpt — optional short snippet (no full reproduction).

If the model cannot find a grounded source it must respond with "No source on file." and recommend a follow-up request_case_research job.

Research backend (v1.3)

Depth	What runs
quick	xAI Grok (web_search / x_search) only
deep	Grok source collector → Browser Run (Kitesurf) markdown on allowlisted seeds → Grok synthesis brief
exhaustive	Same as deep, wider budget (+ optional screenshots on allowlisted pages)

Allowlisted browser hosts: jurisprudence.fifa.com, inside.fifa.com, fifa.com, tas-cas.org.
source_urls is an alias of seed_urls. Cursor Cloud / GitHub Actions is fallback only when xAI is unavailable.

Source-first outputs

Deep/exhaustive runs populate:

• case_sources — official FIFA/CAS/court/press/internal source matrix (browser extracts tagged collector: kitesurf_browser_pass).
• case_findings — legal issues, facts, risks, arguments, negative searches, and next steps.
• law_lab_briefs + case_documents — the full briefing is indexed back into case chat.

Negative searches are not failures. They are diligence artifacts showing what portals and terms were checked and what still needs manual verification.

Compliance — always

1. Never invent FIFA article numbers, case IDs, dates, or holdings.
2. Always cite the source URL. No URL → not a citation.
3. Never re-host full FIFA decision PDFs in dossiers, the library, or briefs.
4. Mark output indicative — not legal advice, not a substitute for a licensed agent.

Next — Cases workspace overview → · Paid market tools → · Orchestration skill →