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)

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 ze Smart App Control

Smart App Control blokuje niepodpisane pliki wykonywalne, a uvx.exe, pip.exe i generowany przy instalacji us-eli-mcp.exe podpisane nie sa. python.exe z python.org jest podpisany przez Python Software Foundation, wiec uruchomienie przez modul omija blokade:

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

Nie wylaczaj Smart App Control, zeby to obejsc - wylaczenia nie da sie cofnac bez ponownej instalacji systemu.

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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

us_eli_mcp-0.4.1.tar.gz (40.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

us_eli_mcp-0.4.1-py3-none-any.whl (33.9 kB view details)

Uploaded Python 3

File details

Details for the file us_eli_mcp-0.4.1.tar.gz.

File metadata

  • Download URL: us_eli_mcp-0.4.1.tar.gz
  • Upload date:
  • Size: 40.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for us_eli_mcp-0.4.1.tar.gz
Algorithm Hash digest
SHA256 d5c0e931a326f97c473976077e57d798ab25b859c3aac291cd9b692cd5db6f95
MD5 7ce17de86b425f0502eb91de0e5c1a5c
BLAKE2b-256 28ff6f0c8a4fab409ae510338e278ace0ed4089cc2f300640a181c5f01d250f9

See more details on using hashes here.

File details

Details for the file us_eli_mcp-0.4.1-py3-none-any.whl.

File metadata

  • Download URL: us_eli_mcp-0.4.1-py3-none-any.whl
  • Upload date:
  • Size: 33.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for us_eli_mcp-0.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 db88d4d95f840b24a4977dfe3f313c830e339b06adf64213e7dae2c127c3d342
MD5 d54144af23116c697886f24f4e09a46f
BLAKE2b-256 9c2b4ae2195f0a35ce718dffcf6eca81d591a5238519e77a8e8962c17ff3b6c7

See more details on using hashes here.

Release history Release notifications | RSS feed

0.4.2

2 files

This release

0.4.1 This release

2 files

0.4.0

2 files

0.3.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page