Skip to main content

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.

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

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.

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.

Metadata

Release files for us-eli-mcp 0.5.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for us-eli-mcp 0.5.1
File Size Uploaded
us_eli_mcp-0.5.1.tar.gz 43.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for us-eli-mcp 0.5.1
File Interpreter ABI Platform
us_eli_mcp-0.5.1-py3-none-any.whl Python 3 none any Details

Total release size: 79.8 kB

Release files / us_eli_mcp-0.5.1.tar.gz

Download URL us_eli_mcp-0.5.1.tar.gz
Size 43.5 kB
Tags Source
SHA-256 checksum
How to use checksums
61b5d1fe4b8093be19dc7c388d2a7f3b21c44ae2b0194c897663c43f2c2e7801
BLAKE2b-256 checksum
How to use checksums
ae59028601b31b23c3b9badc8e6e54f43da32e8a53989d26f16a95f9660aaccc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / us_eli_mcp-0.5.1-py3-none-any.whl

Download URL us_eli_mcp-0.5.1-py3-none-any.whl
Size 36.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fb27b2c30572a5ac06a706223af6674d7d964c0652db08893199b793d9deff5e
BLAKE2b-256 checksum
How to use checksums
f6425c0e91b0748a83b95abb334ca441aa5a2ac4c02e25b9b6496a2a57d7bff5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release history Release notifications | RSS feed

0.5.3

2 release files

0.5.2

2 release files

This release

0.5.1 This release

2 release files

0.5.0

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page