Skip to main content
Glama
us-eli-mcp

us-eli-mcp

us-eli-mcp

MCP server for US law with verifiable citations. Five sources behind ten read-only tools:

  • Congress.gov API - the federal legislative process: bills as they move through committees and floor votes.

  • GovInfo API - enacted law text as published packages: US Code, Statutes at Large, CFR annual editions, Federal Register issues.

  • Federal Register API - full-text search over 1,003,504 FR documents (1994-2026, live-verified 2026-07-07), including 8,513 presidential documents (1,550 executive orders). Keyless.

  • CourtListener search API - full-text search over 8,294,123 court opinions (live-verified 2026-07-07). The headline value is STATE case law (California, New York, Texas, ...), which no federal source covers. Keyless, ~5 requests/min anonymous.

  • eCFR API - the CURRENT Code of Federal Regulations: section-level full-text search over 412,846 sections plus per-section amendment history. Keyless.

What this is not

  • State legislation (all 50 states) - see LegiScan, a free-tier aggregator (30,000 queries/month) not wrapped here.

  • A federal case-law workhorse - for heavy federal case-law research the mature MIT-licensed wrappers (blakeox/courtlistener-mcp, john-walkoe/courtlistener_citations_mcp) remain the recommendation; the case-law tools here exist primarily for state courts. See SOURCES.md.

Related MCP server: CongressMCP-full

Tools

Tool

Purpose

us_search_bills

List bills by congress (e.g. 118) and type (hr, s, hres, ...)

us_get_bill

Full detail + latest action for one bill

us_list_code_packages

List GovInfo packages in a collection (USCODE, CFR, FR, STATUTE)

us_get_code_package

Metadata + download links (PDF/XML/TXT) for one package

us_search_federal_register

Full-text search over FR documents; filter rules, notices, executive orders

us_get_federal_register_doc

One FR document with its official citation (e.g. 91 FR 41591)

us_search_case_law

Full-text search over 8M+ opinions; court filter (e.g. cal, ny, scotus)

us_get_case

One opinion cluster by cluster_id

us_search_cfr_sections

Full-text search over the current CFR (eCFR)

us_get_cfr_section_history

Amendment history of one CFR section (e.g. 15 CFR 744.3)

us_coverage

Declare what this connector covers, when each family was captured, and - explicitly - what it does NOT cover. Every gap carries a fallback.

Every response carries lex_uri (a resolvable API URL), human_readable_citation (the official convention: "H.R. 1, 118th Congress", "91 FR 41591", "People v. Miranda-Guerrero, 519 P.3d 1004 (California Supreme Court 2022)", "15 CFR § 744.3") and source_url (the public page). Reporter citations are taken verbatim from the source and never fabricated; when none exists the docket number is used instead.

Install

As a Claude plugin (Claude Code or the desktop app, needs uv); see plugin/README.md for what it sends and stores:

/plugin marketplace add matematicsolutions/us-eli-mcp
/plugin install us-eli-mcp@us-eli-mcp

As a standalone server:

pip install us-eli-mcp

Windows 11 with Smart App Control

Smart App Control blocks unsigned executables, which covers uvx.exe, pip.exe and the us-eli-mcp.exe launcher that pip writes at install time. The python.exe and py.exe from the python.org installer are signed by the Python Software Foundation, so running the module through the interpreter works:

python -m pip install us-eli-mcp
python -m us_eli_mcp

pip.exe is blocked for the same reason, so install with python -m pip, not pip install. If python is not on PATH, use the Windows launcher: py -3 -m us_eli_mcp.

{ "mcpServers": { "us-eli-mcp": { "command": "python", "args": ["-m", "us_eli_mcp"] } } }

Do not turn Smart App Control off to work around this - it cannot be re-enabled without reinstalling Windows.

Configuration

Env var

Default

US_ELI_API_KEY

DEMO_KEY (shared, low rate limit - get your own free key at api.congress.gov/sign-up)

US_ELI_GOVINFO_API_KEY

reuses US_ELI_API_KEY (same api.data.gov key family)

US_ELI_CACHE_DIR

~/.matematic/cache/us-eli

US_ELI_AUDIT_DIR

~/.matematic/audit

US_ELI_BASE_URL

https://api.congress.gov/v3

US_ELI_GOVINFO_BASE_URL

https://api.govinfo.gov

US_ELI_FR_BASE_URL

https://www.federalregister.gov/api/v1 (keyless)

US_ELI_COURTLISTENER_BASE_URL

https://www.courtlistener.com/api/rest/v4 (keyless)

US_ELI_ECFR_BASE_URL

https://www.ecfr.gov/api (keyless)

The Federal Register, CourtListener and eCFR tools need no key at all.

Network: the server talks to the five sources above and the local filesystem. Once, on first use, it also fetches a small configuration file (us-runtime.json.gz, updated source addresses) from this repository's GitHub Releases. That request carries no query content; GitHub's download counter for the file is the only usage signal we see. US_ELI_RUNTIME_URL="" turns it off; the Claude plugin ships with it off. No LLM provider, no other telemetry.

License

Apache-2.0 (code). Congress.gov, GovInfo, Federal Register and eCFR data are US government works (public domain). CourtListener data is provided by the Free Law Project.

Available Tools

11 tools
us_coverageA
Read-onlyIdempotent

Declare what this connector covers, how it is sourced, and what it does NOT cover.

Call this before telling a user that the law "does not contain" something, and whenever a search comes back empty: the absence may be a gap in this connector rather than in the law. Every gap carries a fallback saying where to look instead.

Returns: Coverage with families, an as-of note, and a non-empty list of known gaps.

Inputs: no named parameters. Returns: What this connector covers, how it is sourced, and what it does not cover.

us_get_billA
Read-onlyIdempotent

Fetch full detail (including latest action/status) for one bill.

Inputs: number (required), congress (required), bill_type (required). Returns: object

us_get_caseA
Read-onlyIdempotent

Fetch one opinion cluster by its CourtListener cluster_id.

Uses the keyless search endpoint with a cluster_id:{id} field query (the authenticated /clusters/{id}/ endpoint is deliberately not used).

Inputs: cluster_id (required). Returns: object

us_get_cfr_section_historyA
Read-onlyIdempotent

Fetch the amendment history (point-in-time versions) of one CFR section.

Inputs: part (required), title (required), section (required). Returns: object

us_get_code_packageA
Read-onlyIdempotent

Fetch metadata and content-format download links for one GovInfo package.

Inputs: package_id (required). Returns: object

us_get_federal_register_docA
Read-onlyIdempotent

Fetch full metadata for one Federal Register document.

Inputs: document_number (required). Returns: object

us_list_code_packagesA
Read-onlyIdempotent

List enacted-law packages in a GovInfo collection modified since a given date.

Inputs: collection (required), limit, start_date. Returns: object

us_search_billsA
Read-onlyIdempotent

List US federal bills of a given congress and bill type.

Inputs: congress (required), bill_type (required), limit. Returns: object

us_search_case_lawA
Read-onlyIdempotent

Full-text search over 8M+ US court opinions (CourtListener, keyless).

The headline value is STATE case law - no other tool in this server covers state courts. Federal courts are searchable too, but dedicated CourtListener MCP wrappers exist for heavy federal case-law work.

Inputs: query (required), court, limit. Returns: object

us_search_cfr_sectionsA
Read-onlyIdempotent

Full-text search over the CURRENT Code of Federal Regulations (eCFR, keyless).

Unlike the GovInfo CFR collection (annual-edition snapshots), the eCFR is amended through days ago and every hit carries the exact CFR hierarchy (title/part/section) plus an excerpt.

Inputs: query (required), limit. Returns: object

us_search_federal_registerA
Read-onlyIdempotent

Full-text search over Federal Register documents (1994-present, keyless).

Inputs: term (required), limit, doc_type, presidential_document_type. Returns: object

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool targets a distinct legal source and action: bills, code packages, Federal Register, case law, CFR sections, and a coverage tool. The search/get pairs are clearly separated by resource type, and even similar regulatory sources (Federal Register vs CFR) are distinct.

    Naming Consistency4/5

    All tools follow the 'us_' prefix with a verb_noun pattern (search_, get_, list_). The only outlier is 'us_coverage', which uses a noun instead of verb_noun, and 'get_case' is shorter than 'get_federal_register_doc', but overall the pattern is consistent and predictable.

    Tool Count5/5

    11 tools is well-scoped for a legal research connector covering multiple sources. Each tool serves a clear purpose, and the count is within the ideal 3-15 range, not feeling bloated or sparse.

    Completeness4/5

    The server provides search and retrieval for each major legal source: bills, code packages, Federal Register, case law, and CFR. The coverage tool explicitly identifies gaps and fallbacks, which mitigates incompleteness. Minor missing operations like a direct 'get CFR section' tool are workable through search and history tools.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      An MCP server for the Congress.gov API that consolidates 91 operations into 6 comprehensive legislative tools that can be used by any MCP client (i.e. Claude Desktop), or MCP-compatible AI agent, to query and reason about congressional data.
      12 npm
      1
      JavaScript
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      The open Congress.gov MCP server. Provides comprehensive access to the Congress.gov API through 6 organized toolsets, enabling AI systems to retrieve and interact with legislative data from the United States Congress with a clean, unified interface.
      24
      39 PyPI
      36
      Sustainable Use v1.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables querying U.S. legislative data from Congress.gov API using MCP resources for direct lookups and tools for searching and retrieving related data.
      8
      MIT