Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

io.github.cyanheads/congressgov-mcp-server

REMOTE · CONGRESSGOV.CASEYJHAND.COM · 2 COMPONENTS · SCANNED AUG 3

Access U.S. congressional data - bills, votes, members, committees - via MCP.

+5 this week 71 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →

Endpoint Security66
  • The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
  • Authorisation not fully verified: no authorisation is required to call this server, and 10 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe. See how to fix → View diagnostics → Unverified
  • HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
  • The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
  • DNSSEC is configured correctly; the domain's records validate against the full chain to the root. View diagnostics → Pass
Transport & Reachability100
Schema Quality & AI Usability76
  • 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 2860 tokens (~238/item across 12 items; 10 tools + 2 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
  • Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
  • Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

remote · congressgov.caseyjhand.com

# add to Claude Code
claude mcp add --transport http cyanheads-congressgov-mcp-server https://congressgov.caseyjhand.com/mcp
# ~/.codex/config.toml
[mcp_servers.cyanheads-congressgov-mcp-server]
url = "https://congressgov.caseyjhand.com/mcp"
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cyanheads-congressgov-mcp-server": {
      "type": "remote",
      "url": "https://congressgov.caseyjhand.com/mcp",
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add cyanheads-congressgov-mcp-server --url https://congressgov.caseyjhand.com/mcp --transport streamable-http
# ~/.hermes/config.yaml
mcp_servers:
  cyanheads-congressgov-mcp-server:
    url: "https://congressgov.caseyjhand.com/mcp"
// mcp.json
{
  "mcpServers": {
    "cyanheads-congressgov-mcp-server": {
      "type": "http",
      "url": "https://congressgov.caseyjhand.com/mcp"
    }
  }
}

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 3 Aug 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

  • 1 Aug 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.

  • 31 Jul 26 +1
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 30 Jul 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 29 Jul 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

  • 28 Jul 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

  • 27 Jul 26 0
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 26 Jul 26 66

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Probed https://congressgov.caseyjhand.com/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject Issuer Valid from Valid until Key Signature Serial
CN=caseyjhand.com CN=WE1,O=Google Trust Services,C=US 7 Jul 2026 5 Oct 2026 ECDSA 256 ECDSA-SHA256 5aad900eb2055a0b0ea55912ec19680c
SANs: caseyjhand.com, *.caseyjhand.com
CN=WE1,O=Google Trust Services,C=US (CA) CN=GTS Root R4,O=Google Trust Services LLC,C=US 13 Dec 2023 20 Feb 2029 ECDSA 256 ECDSA-SHA384 7ff31977972c224a76155d13b6d685e3
CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE 15 Nov 2023 28 Jan 2028 ECDSA 384 SHA256-RSA 7fe530bf331343bedd821610493d8a1b
DNSSEC secure

Validation of congressgov.caseyjhand.com. Secure

Zone DS Keys Algorithms Outcome
. trust_anchor 20326, 38696 8, 8 Verified
com. present 19718 13 Verified
caseyjhand.com. present 2371 13 Verified
congressgov.caseyjhand.com. Verified address RRset verified with the apex keys
Authentication No authorisation required

The endpoint answered without asking for a token. Anyone who knows the URL can reach it.

Result No authorisation required
HTTP status 200
Header Value
strict-transport-security max-age=63072000; includeSubDomains; preload
x-content-type-options nosniff
Transports 2 probes
Transport URL Outcome Status Location
streamable-http https://congressgov.caseyjhand.com/mcp Verified 200
http (plaintext) http://congressgov.caseyjhand.com/mcp HTTPS enforced 301 https://congressgov.caseyjhand.com/mcp
MCP tools — 10 exposed · ~2,622 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
congressgov_bill_lookup ~338

Browse and retrieve U.S. legislative bill data from Congress.gov. Discover bills by filtering on congress, bill type, and date range — there is no keyword search. Use 'list' to browse (requires congress, defaults to most-recently-updated first), 'get' for full bill detail (sponsor, policy area, CBO estimates, law info), or drill into a specific bill with 'actions', 'amendments', 'cosponsors', 'committees', 'subjects', 'summaries', 'text', 'titles', or 'related' (each requires congress + billType + billNumber).

NameTypeReqDescription
billNumberintegerBill number. Required for get and sub-resource operations.
billTypestringBill type code. Required for get and sub-resource operations.
congressintegeryesCongress number (e.g., 118, 119).
fromDateTimestringStart of date range filter (ISO 8601). Filters by the bill's update date — when Congress.gov last touched the record — not by the bill's latest legislative action.
limitintegerResults per page (1-250).
offsetintegerPagination offset.
operationstringyesWhich data to retrieve.
orderstringSort order for 'list' (sorts by update date). 'recent' (default) is newest first; 'oldest' is ascending. Ignored by other operations.
toDateTimestringEnd of date range filter (ISO 8601). Same field semantics as fromDateTime.
NameTypeReqDescription
dataarrayResult rows. Per-tool item shape is rendered in the markdown body.
effectiveQuerystringyesThe browse scope and applied filters.
noticestringGuidance when results are empty, a page is past the end, or a caveat applies.
paginationobjectPagination metadata: total count and next offset.
totalCountnumberyesTotal results across all pages.

No examples provided.

congressgov_bill_summaries ~248

Browse recent CRS (Congressional Research Service) bill summaries — plain-language summaries of bills at each legislative stage, useful for answering "what's happening in Congress?". The fromDateTime/toDateTime filters apply to the summary's update time, not the bill's action date, so results include recently rewritten summaries of older bills. Defaults to summaries updated in the last 7 days. Each item shows both the bill's action date and the summary update date. For summaries of one specific bill, use congressgov_bill_lookup with operation='summaries' instead.

NameTypeReqDescription
billTypestringBill type filter. Requires 'congress'.
congressintegerCongress number. Optional — omit for summaries across all congresses.
fromDateTimestringStart of date range (ISO 8601), filtered on the summary update time. Defaults to 7 days ago if neither date param is set.
limitintegerResults per page (1-250).
offsetintegerPagination offset.
toDateTimestringEnd of date range (ISO 8601), filtered on the summary update time. Defaults to now.
NameTypeReqDescription
dataarrayyesResult rows. Per-tool item shape is rendered in the markdown body.
effectiveQuerystringyesThe browse scope and applied filters.
noticestringGuidance when results are empty, a page is past the end, or a caveat applies.
paginationobjectyesPagination metadata: total count and next offset.
totalCountnumberyesTotal results across all pages.

No examples provided.

congressgov_committee_lookup ~434

Browse congressional committees and their legislation, reports, and nominations. Committee codes follow the pattern chamber-prefix (h/s/j) + abbreviation + 2-digit number — use 'list' (with optional 'filter' for name→code resolution) to discover codes, then 'get' or drill into 'bills', 'reports', or 'nominations' ('nominations' is Senate-only). 'get' and sub-resources only need committeeCode (chamber is inferred from the prefix); pass chamber explicitly to override. The 'bills' sub-resource defaults to 'recent' order (newest update-date first); pass order='oldest' for ascending update-date order. Upstream omits bill titles from the 'bills' sub-resource — rows carry only {congress, billType, billNumber, actionDate, relationshipType, url}; chain 'congressgov_bill_lookup get' per row to retrieve titles and policy area.

NameTypeReqDescription
chamberstringChamber filter for 'list', or override for 'get' and sub-resources (otherwise inferred from committeeCode prefix).
committeeCodestringCommittee system code, e.g. 'hsju00'. Required for 'get' and sub-resources. Codes are lowercase letters + 2-digit suffix. Pass a committee name here and the tool will attempt to resolve it automatica…
congressintegerCongress number.
filterstringFilter committee list results by name (e.g., 'transportation', 'armed services'). Only meaningful for 'list'. Fetches the full chamber set and matches client-side; fuzzy-matched rows are labeled appr…
limitintegerResults per page (1-250).
offsetintegerPagination offset.
operationstringyesWhich data to retrieve.
orderstringSort order for the 'bills' sub-resource. 'recent' (default) returns newest update-date first; 'oldest' returns ascending update-date order. Ignored by other operations.
NameTypeReqDescription
dataarrayResult rows. Per-tool item shape is rendered in the markdown body.
effectiveQuerystringyesThe browse scope and applied filters.
noticestringGuidance when results are empty, a page is past the end, or a caveat applies.
paginationobjectPagination metadata: total count and next offset.
totalCountnumberyesTotal results across all pages.

No examples provided.

congressgov_committee_reports ~150

Browse and retrieve committee reports from Congress.gov — reports accompany legislation reported out of committee and explain the bill's purpose, committee amendments, dissenting views, and the committee vote. Report types are 'hrpt' (House), 'srpt' (Senate), and 'erpt' (Executive).

NameTypeReqDescription
congressintegeryesCongress number.
limitintegerResults per page (1-250).
offsetintegerPagination offset.
operationstringyesWhich data to retrieve.
reportNumberintegerCommittee report number. Required for get and text operations.
reportTypestringReport type. Required for get and text operations.
NameTypeReqDescription
dataarrayResult rows. Per-tool item shape is rendered in the markdown body.
effectiveQuerystringyesThe browse scope and applied filters.
noticestringGuidance when results are empty, a page is past the end, or a caveat applies.
paginationobjectPagination metadata: total count and next offset.
totalCountnumberyesTotal results across all pages.

No examples provided.

congressgov_crs_reports ~155

Browse and retrieve CRS (Congressional Research Service) reports — nonpartisan policy analyses by subject-matter experts at the Library of Congress, covering policy areas, legislative proposals, and legal questions. Report IDs use letter-number codes (e.g., R40097, RL33612, IF12345). Use 'list' to browse available reports or 'get' for full detail (authors, topics, summary, download formats).

NameTypeReqDescription
limitintegerResults per page (1-250).
offsetintegerPagination offset.
operationstringyesWhich data to retrieve.
reportNumberstringCRS report ID (e.g., 'R40097'). Required for 'get'.
NameTypeReqDescription
dataarrayResult rows. Per-tool item shape is rendered in the markdown body.
effectiveQuerystringyesThe browse scope and applied filters.
noticestringGuidance when results are empty, a page is past the end, or a caveat applies.
paginationobjectPagination metadata: total count and next offset.
totalCountnumberyesTotal results across all pages.

No examples provided.

congressgov_daily_record ~158

Browse the daily Congressional Record — floor speeches, debates, and legislative text published each day Congress is in session. Navigation is hierarchical: volumes (via 'list') → issues (via 'issues') → articles (via 'articles'). Use 'list' to find recent volumes, 'issues' to see what's in a volume, and 'articles' to access individual speeches and debate sections.

NameTypeReqDescription
issueNumberintegerIssue number within a volume. Required for 'articles'.
limitintegerResults per page (1-250).
offsetintegerPagination offset.
operationstringyesWhich data to retrieve.
volumeNumberintegerVolume number. Required for 'issues' and 'articles'.
NameTypeReqDescription
dataarrayyesResult rows. Per-tool item shape is rendered in the markdown body.
effectiveQuerystringyesThe browse scope and applied filters.
noticestringGuidance when results are empty, a page is past the end, or a caveat applies.
paginationobjectyesPagination metadata: total count and next offset.
totalCountnumberyesTotal results across all pages.

No examples provided.

congressgov_enacted_laws ~210

Browse enacted public and private laws from Congress.gov by congress and law type ('pub' for public laws, 'priv' for private). 'list' filters by enactment status and law type — the discovery path 'bill_lookup' does not offer. 'get' returns the origin bill record (sponsor, actions, summaries, text), with the public/private law citation on the bill's 'laws' array (e.g. {"number":"118-2","type":"Public Law"}).

NameTypeReqDescription
congressintegeryesCongress number.
lawNumberintegerLaw number. Required for 'get'.
lawTypestringLaw type — 'pub' (public laws, general application, most common) or 'priv' (private laws, specific individuals or entities). Required for 'get'.
limitintegerResults per page (1-250).
offsetintegerPagination offset.
operationstringyesWhich data to retrieve.
NameTypeReqDescription
dataarrayResult rows. Per-tool item shape is rendered in the markdown body.
effectiveQuerystringyesThe browse scope and applied filters.
noticestringGuidance when results are empty, a page is past the end, or a caveat applies.
paginationobjectPagination metadata: total count and next offset.
totalCountnumberyesTotal results across all pages.

No examples provided.

congressgov_member_lookup ~247

Discover congressional members and their legislative activity. No name search. For 'list', filter by stateCode (optionally with district), by congress, or by both together (e.g., 118th Congress + CA, or CA district 12 in the 118th). Add currentMember=true to restrict to currently serving members. Once you have a bioguideId, use 'get' for full profile or 'sponsored'/'cosponsored' for their legislative portfolio.

NameTypeReqDescription
bioguideIdstringUnique member identifier (e.g., 'P000197'). Required for get/sponsored/cosponsored.
congressintegerCongress number to filter by.
currentMemberbooleanFilter to currently serving members. Omit to include both current and former members.
districtintegerCongressional district number. Requires stateCode. Use 0 for at-large.
limitintegerResults per page (1-250).
offsetintegerPagination offset.
operationstringyesWhich data to retrieve.
stateCodestringTwo-letter state code (e.g., 'CA', 'TX').
NameTypeReqDescription
dataarrayResult rows. Per-tool item shape is rendered in the markdown body.
effectiveQuerystringyesThe browse scope and applied filters.
noticestringGuidance when results are empty, a page is past the end, or a caveat applies.
paginationobjectPagination metadata: total count and next offset.
totalCountnumberyesTotal results across all pages.

No examples provided.

congressgov_roll_votes ~324

Retrieve U.S. congressional roll call votes and individual member voting positions for either chamber. Set 'chamber' to 'house' (default, from the Congress.gov API) or 'senate' (from the Senate's official LIS feed). Use 'list' to find votes by congress and session (newest first by default), 'get' for vote details (question, result, tallies, party breakdown, associated bill/nomination/amendment), or 'members' for how each member voted.

NameTypeReqDescription
chamberstringChamber whose votes to query. 'house' (default) draws from the Congress.gov API; 'senate' draws from the Senate's official LIS roll-call feed. Roll call numbers reset each session and are specific to…
congressintegeryesCongress number.
limitintegerResults per page (1-250).
offsetintegerPagination offset.
operationstringyesWhich data to retrieve.
orderstringSort order for 'list'. 'recent' (default) returns newest first; 'oldest' returns ascending. House sorts by vote update date (with 'recent', offset=0 always returns the strictly newest page); Senate s…
sessionintegeryesSession number (1 or 2). Odd years are session 1, even years session 2.
voteNumberintegerRoll call vote number. Required for 'get' and 'members'.
NameTypeReqDescription
dataarrayResult rows. Per-tool item shape is rendered in the markdown body.
effectiveQuerystringyesThe browse scope and applied filters.
noticestringGuidance when results are empty, a page is past the end, or a caveat applies.
paginationobjectPagination metadata: total count and next offset.
totalCountnumberyesTotal results across all pages.

No examples provided.

congressgov_senate_nominations ~358

Browse presidential nominations to federal positions and track the Senate confirmation process. Use 'list' to browse, 'get' for nomination detail, 'actions'/'committees'/'hearings' for confirmation pipeline data, or 'nominees' to retrieve individual appointees in a multi-nominee batch. Nominations use 'PN' (Presidential Nomination) numbering. Most nominations carry confirmation activity on the parent (e.g., PN1000); multi-part parents (e.g., PN851) carry no activity of their own — their actions, committees, hearings, and nominees live on partitioned children (PN851-1, PN851-2, …). 'get' on a parent that has no `nominees` array signals the partitioned form is needed for everything below it.

NameTypeReqDescription
congressintegeryesCongress number.
limitintegerResults per page (1-250).
nominationNumberstringNomination number. Use the bare form (e.g. '1000') for nominations whose activity sits on the parent; use the partitioned form (e.g. '851-1') for sub-resources of a multi-part nomination. Required fo…
offsetintegerPagination offset.
operationstringyesWhich data to retrieve.
ordinalintegerBatch ordinal within a multi-nominee nomination. Each ordinal addresses a group of nominees; the 'nominees' operation returns every individual in that batch. Use 'get' first to see available ordinals…
NameTypeReqDescription
dataarrayResult rows. Per-tool item shape is rendered in the markdown body.
effectiveQuerystringyesThe browse scope and applied filters.
noticestringGuidance when results are empty, a page is past the end, or a caveat applies.
paginationobjectPagination metadata: total count and next offset.
totalCountnumberyesTotal results across all pages.

No examples provided.