Skip to main content
Glama
Workers' compensation MCP

Workers' compensation MCP

by matanitah

Workers' compensation MCP

A FastMCP server over the OKF wiki in state-by-state-research. It returns each jurisdiction's reimbursement JSON and, when a publisher URL is cataloged, the text of that official page.

Tools

  • list_jurisdictions lists the 50 states and the District of Columbia. regulation_coverage is act, chapter, section, or rules. regulation_retrieval is live or stored.

  • get_jurisdiction returns the agency, the primary-law citation, and the regulation catalog. Each catalog entry includes coverage and retrieval.

  • get_reimbursement returns the stored JSON. benefits holds the weekly maximum, weekly minimum, wage-replacement rate, and temporary-total week cap. claimcalc holds ClaimCalc's injury-level settlement. figures_from becomes official only when a rate notice states all four benefit fields.

  • get_regulations fetches one cataloged official URL and returns its text. The default document is the statute when rules are also cataloged. section returns the passage that starts at a citation. Some jurisdictions return text saved from the official page when that host blocks the server. A failed live fetch returns fetch_error. A state with no cataloged URL returns status: uncatalogued.

benefits holds weekly benefit limits from ClaimCalc. A field is replaced only when an official rate notice states a different number, and figures_from becomes official only when that notice states all four benefit fields. claimcalc holds that source's injury-level settlement amount.

Related MCP server: rival-regulatory

Run locally

uv sync
uv run fastmcp run server.py:mcp

That uses stdio. For HTTP, the endpoint is http://localhost:8000/mcp:

uv run fastmcp run server.py:mcp --transport http --host 0.0.0.0 --port 8000

Docker

docker build -t workers-comp-mcp .
docker run --rm -p 8000:8000 workers-comp-mcp

Chat dashboard

A Streamlit chat drives the MCP server with the local Ollama model gemma4. The model calls list_jurisdictions, get_jurisdiction, get_reimbursement, and get_regulations through the FastMCP client.

uv sync --group dashboard
uv run --group dashboard streamlit run dashboard.py

Ollama must already be running and gemma4 must appear in ollama list. The dashboard is at http://localhost:8501.

Tests

uv run pytest

Available Tools

4 tools
get_jurisdictionGet JurisdictionA

Return the agency, primary-law citation, and regulation catalog for a state.

state is a postal code or jurisdiction name, such as CA or California. Each catalog entry includes coverage (act, chapter, section, or rules) and retrieval (live or stored).

Inputs: state (required). Returns: object

get_regulationsGet RegulationsA

Fetch one cataloged official regulation and return its text.

The URL comes from that jurisdiction's catalog. This tool does not accept an arbitrary URL and does not summarize the document. When several documents are cataloged, the default is primary-statute; pass source_id for another, such as agency-rules. A catalog entry that names a saved text file returns that file. section returns the passage that starts at that citation. A failed live fetch returns status fetch_error. When no official URL is cataloged, the result is status uncatalogued with the citation and agency link already recorded in the wiki.

Inputs: state (required), section, source_id. Returns: object

get_reimbursementGet ReimbursementB

Return the stored reimbursement JSON for a state.

benefits holds the weekly maximum, weekly minimum, wage-replacement rate, and temporary-total week cap. claimcalc is ClaimCalc's injury-level settlement figure. state is a postal code or name.

Inputs: state (required). Returns: object

list_jurisdictionsList JurisdictionsA

List the 50 states and the District of Columbia in the research wiki.

Each row includes the postal code, the jurisdiction name, whether a cataloged official regulation URL is on file, whether that document is the act, a chapter, a section, or agency rules, whether the text is fetched live or read from a saved file, and whether a medical fee schedule object is stored.

Inputs: no named parameters. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 4 tools

    Disambiguation4/5

    Each tool has a distinct role: listing jurisdictions, retrieving jurisdiction metadata, retrieving reimbursement data, and fetching regulation text. The only mild overlap is between get_jurisdiction's regulation catalog and get_regulations, but their descriptions clearly separate metadata lookup from document retrieval.

    Naming Consistency5/5

    All tool names follow a consistent snake_case verb_noun pattern: list_jurisdictions, get_jurisdiction, get_reimbursement, get_regulations. The convention is predictable and easy to scan.

    Tool Count4/5

    Four tools are reasonable for a focused read-only research wiki covering jurisdictions, metadata, reimbursement, and regulation text. The surface is lean, though it leaves little room for additional lookup modes.

    Completeness4/5

    The tool set covers the core lifecycle of listing jurisdictions, inspecting a jurisdiction's catalog, retrieving reimbursement data, and fetching regulation text. Minor gaps exist, such as no search or bulk catalog browsing, but the main read-only workflows are covered.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables AI assistants to search and analyze legal documents from multiple jurisdictions including US federal and state law, case law, EU regulations, UK legislation, Canadian law, Congress bills, SEC filings, and FDA data through free government APIs.
      6
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables agent clients to perform read-only regulatory retrieval through tools for searching the corpus, retrieving source text, tracing citations, listing authorities, and inspecting recent filings. It is designed to keep regulated actions and workspace changes behind human review gates.
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Connects AI hosts to a deterministic, cited regulatory-compliance reference so agents can look up laws, search regulations, compute which requirements a product triggers, and find related Controls, vendors, enforcement actions, and counsel with primary-source links. It also exposes the accepted feature/market/audience catalog and a token verifier for grounding what was served.
      46 npm
      MIT