io.github.cyanheads/congressgov-mcp-server

Official10 toolsLive

by cyanheads · TypeScript

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

This MCP server provides access to U.S. congressional data—specifically bills, votes, members, and committees—via Model Context Protocol. It exposes functionality over STDIO and Streamable HTTP and is implemented as a TypeScript MCP server for integration with tools and resources.

🛠️ Key Features

Access U.S. congressional data (bills, votes, members, committees)
MCP server with 10 tools
Uses STDIO and Streamable HTTP for communication

🚀 Use Cases

Query and work with congressional legislative data (bills and votes)
Retrieve information related to members and committees through MCP

⚡ Developer Benefits

Built for MCP-based workflows (Model Context Protocol)
TypeScript-based implementation
Repository includes 5 resources and 2 prompts (as indicated in the excerpt)

⚠️ Limitations

Scope is limited to U.S. congressional data (bills, votes, members, committees); other data categories are not described.

Topics

congresslegislationlegislative-datamcpmcp-servermodel-context-protocoltypescriptcongress-govbillsus-governmentcyanheads

Captured live from the server via tools/list.

congressgov_bill_lookup

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). 'text' lists the published versions and their format URLs; 'content' then reads one version's actual text, a bounded character window at a time. 'summaries' takes an optional versionCode selector and returns each row's text a bounded character window at a time — a row past the window carries textTotalCharacters/textTruncated/textNextOffset, and characterOffset reads on from there.

Parameters14

operation	string	required	Which data to retrieve.
congress	integer	required	Congress number (e.g., 118, 119).
billType	string	optional	Bill type code. Required for get and sub-resource operations.
billNumber	any	optional	Bill number. Required for get and sub-resource operations. Accepts the digit-string form list rows carry (e.g. "9479") as well as a number.
fromDateTime	string	optional	Start 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.
toDateTime	string	optional	End of date range filter (ISO 8601). Same field semantics as fromDateTime.
order	string	optional	Sort order for 'list' (sorts by update date). 'recent' (default) is newest first; 'oldest' is ascending. Ignored by other operations.
limit	integer	optional	Results per page (1-250).
offset	integer	optional	Pagination offset.
textVersionIndex	integer	optional	Which text version 'content' reads, 0-based against the same order 'text' returns — 0 is the most recent version. Ignored by other operations.
versionCode	string	optional	Which summary version 'summaries' returns — the versionCode a summary row carries ('00' introduced, '49' public law). Selection runs over the bill's whole summary list, which Congress.gov publishes no filter for, and limit/offset then page the matching rows. Omit to return every version. Ignored by other operations.
format	string	optional	Document format for 'content'. 'text' is GPO's Formatted Text — plain, pre-formatted print output, published for every document checked. 'xml' prefers United States Legislative Markup and falls back to Formatted XML; it exists on some bill text versions and on no committee report or Congressional Record article. PDF is not retrieved — read one at the format URLs 'text'/'articles' return.
characterOffset	integer	optional	First character to return, 0-based — of the document on 'content', and of every returned row's summary text on 'summaries'. Offsets are exact and are never snapped to a section or paragraph break, so feeding back the response's nextOffset (or a summary row's textNextOffset) walks the whole text with every character returned exactly once.
characterLimit	integer	optional	Maximum characters to return (1-100000) — for the document window on 'content', and for each row's summary text on 'summaries'. Legislative documents run past a million characters and an enacted bill's summary past two hundred thousand, so either takes several windows.

Raw schema

{
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "list",
        "get",
        "actions",
        "amendments",
        "cosponsors",
        "committees",
        "subjects",
        "summaries",
        "text",
        "titles",
        "related",
        "content"
      ],
      "description": "Which data to retrieve."
    },
    "congress": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Congress number (e.g., 118, 119)."
    },
    "billType": {
      "description": "Bill type code. Required for get and sub-resource operations.",
      "type": "string",
      "enum": [
        "hr",
        "s",
        "hjres",
        "sjres",
        "hconres",
        "sconres",
        "hres",
        "sres"
      ]
    },
    "billNumber": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991,
          "description": "Positive integer form."
        },
        {
          "type": "string",
          "pattern": "^0*[1-9]\\d*$",
          "description": "Digit-string form, as list rows carry it."
        }
      ],
      "description": "Bill number. Required for get and sub-resource operations. Accepts the digit-string form list rows carry (e.g. \"9479\") as well as a number."
    },
    "fromDateTime": {
      "description": "Start 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.",
      "type": "string"
    },
    "toDateTime": {
      "description": "End of date range filter (ISO 8601). Same field semantics as fromDateTime.",
      "type": "string"
    },
    "order": {
      "default": "recent",
      "description": "Sort order for 'list' (sorts by update date). 'recent' (default) is newest first; 'oldest' is ascending. Ignored by other operations.",
      "type": "string",
      "enum": [
        "recent",
        "oldest"
      ]
    },
    "limit": {
      "default": 20,
      "description": "Results per page (1-250).",
      "type": "integer",
      "minimum": 1,
      "maximum": 250
    },
    "offset": {
      "default": 0,
      "description": "Pagination offset.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "textVersionIndex": {
      "default": 0,
      "description": "Which text version 'content' reads, 0-based against the same order 'text' returns — 0 is the most recent version. Ignored by other operations.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "versionCode": {
      "description": "Which summary version 'summaries' returns — the versionCode a summary row carries ('00' introduced, '49' public law). Selection runs over the bill's whole summary list, which Congress.gov publishes no filter for, and limit/offset then page the matching rows. Omit to return every version. Ignored by other operations.",
      "type": "string"
    },
    "format": {
      "default": "text",
      "description": "Document format for 'content'. 'text' is GPO's Formatted Text — plain, pre-formatted print output, published for every document checked. 'xml' prefers United States Legislative Markup and falls back to Formatted XML; it exists on some bill text versions and on no committee report or Congressional Record article. PDF is not retrieved — read one at the format URLs 'text'/'articles' return.",
      "type": "string",
      "enum": [
        "text",
        "xml"
      ]
    },
    "characterOffset": {
      "default": 0,
      "description": "First character to return, 0-based — of the document on 'content', and of every returned row's summary text on 'summaries'. Offsets are exact and are never snapped to a section or paragraph break, so feeding back the response's nextOffset (or a summary row's textNextOffset) walks the whole text with every character returned exactly once.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "characterLimit": {
      "default": 25000,
      "description": "Maximum characters to return (1-100000) — for the document window on 'content', and for each row's summary text on 'summaries'. Legislative documents run past a million characters and an enacted bill's summary past two hundred thousand, so either takes several windows.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100000
    }
  },
  "required": [
    "operation",
    "congress"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

congressgov_enacted_laws

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"}).

Parameters6

operation	string	required	Which data to retrieve.
congress	integer	required	Congress number.
lawType	string	optional	Law type — 'pub' (public laws, general application, most common) or 'priv' (private laws, specific individuals or entities). Required for 'get'.
lawNumber	any	optional	Law number, as carried by a 'list' row's `laws[].number` — either the full citation ('118-90', rendered as 'Public Law 118-90') or the portion after the hyphen ('90'); the prefix is the congress and must match `congress`. Not the row's own `number`, which is the origin bill. Required for 'get'.
limit	integer	optional	Results per page (1-250).
offset	integer	optional	Pagination offset.

Raw schema

{
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "list",
        "get"
      ],
      "description": "Which data to retrieve."
    },
    "congress": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Congress number."
    },
    "lawType": {
      "description": "Law type — 'pub' (public laws, general application, most common) or 'priv' (private laws, specific individuals or entities). Required for 'get'.",
      "type": "string",
      "enum": [
        "pub",
        "priv"
      ]
    },
    "lawNumber": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991,
          "description": "Positive integer form (e.g. 90)."
        },
        {
          "type": "string",
          "pattern": "^(?:\\d+-)?0*[1-9]\\d*$",
          "description": "String form — the law number (\"90\") or the full citation (\"118-90\")."
        }
      ],
      "description": "Law number, as carried by a 'list' row's `laws[].number` — either the full citation ('118-90', rendered as 'Public Law 118-90') or the portion after the hyphen ('90'); the prefix is the congress and must match `congress`. Not the row's own `number`, which is the origin bill. Required for 'get'."
    },
    "limit": {
      "default": 20,
      "description": "Results per page (1-250).",
      "type": "integer",
      "minimum": 1,
      "maximum": 250
    },
    "offset": {
      "default": 0,
      "description": "Pagination offset.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "operation",
    "congress"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

congressgov_member_lookup

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.

Parameters8

operation	string	required	Which data to retrieve.
bioguideId	string	optional	Unique member identifier (e.g., 'P000197'). Required for get/sponsored/cosponsored.
congress	integer	optional	Congress number to filter by.
stateCode	string	optional	Two-letter state code (e.g., 'CA', 'TX').
district	integer	optional	Congressional district number. Requires stateCode. Use 0 for at-large.
currentMember	boolean	optional	Filter to currently serving members. Omit to include both current and former members.
limit	integer	optional	Results per page (1-250).
offset	integer	optional	Pagination offset.

Raw schema

{
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "list",
        "get",
        "sponsored",
        "cosponsored"
      ],
      "description": "Which data to retrieve."
    },
    "bioguideId": {
      "description": "Unique member identifier (e.g., 'P000197'). Required for get/sponsored/cosponsored.",
      "type": "string",
      "pattern": "^[A-Za-z]\\d{6}$"
    },
    "congress": {
      "description": "Congress number to filter by.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "stateCode": {
      "description": "Two-letter state code (e.g., 'CA', 'TX').",
      "type": "string",
      "pattern": "^[A-Za-z]{2}$"
    },
    "district": {
      "description": "Congressional district number. Requires stateCode. Use 0 for at-large.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "currentMember": {
      "description": "Filter to currently serving members. Omit to include both current and former members.",
      "type": "boolean"
    },
    "limit": {
      "default": 20,
      "description": "Results per page (1-250).",
      "type": "integer",
      "minimum": 1,
      "maximum": 250
    },
    "offset": {
      "default": 0,
      "description": "Pagination offset.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "operation"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

congressgov_committee_lookup

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.

Parameters8

operation	string	required	Which data to retrieve.
congress	integer	optional	Congress number.
chamber	string	optional	Chamber filter for 'list', or override for 'get' and sub-resources (otherwise inferred from committeeCode prefix).
committeeCode	string	optional	Committee system code, e.g. 'hsju00'. Required for 'get' and sub-resources. Codes are letters + a 2-digit suffix and are matched case-insensitively. Any other non-blank value is treated as a committee name and resolved automatically — single-word names ('Judiciary') included — or use operation:'list' with filter to browse.
filter	string	optional	Filter committee-list results by name (e.g., 'transportation', 'armed services'). Only meaningful for 'list'; fuzzy-matched rows are labeled approximate.
limit	integer	optional	Results per page (1-250).
offset	integer	optional	Pagination offset.
order	string	optional	Sort order for the 'bills' sub-resource. 'recent' (default) returns newest update-date first; 'oldest' returns ascending update-date order. Ignored by other operations.

Raw schema

{
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "list",
        "get",
        "bills",
        "reports",
        "nominations"
      ],
      "description": "Which data to retrieve."
    },
    "congress": {
      "description": "Congress number.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "chamber": {
      "description": "Chamber filter for 'list', or override for 'get' and sub-resources (otherwise inferred from committeeCode prefix).",
      "type": "string",
      "enum": [
        "house",
        "senate",
        "joint"
      ]
    },
    "committeeCode": {
      "description": "Committee system code, e.g. 'hsju00'. Required for 'get' and sub-resources. Codes are letters + a 2-digit suffix and are matched case-insensitively. Any other non-blank value is treated as a committee name and resolved automatically — single-word names ('Judiciary') included — or use operation:'list' with filter to browse.",
      "type": "string",
      "pattern": "\\S"
    },
    "filter": {
      "description": "Filter committee-list results by name (e.g., 'transportation', 'armed services'). Only meaningful for 'list'; fuzzy-matched rows are labeled approximate.",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Results per page (1-250).",
      "type": "integer",
      "minimum": 1,
      "maximum": 250
    },
    "offset": {
      "default": 0,
      "description": "Pagination offset.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "order": {
      "default": "recent",
      "description": "Sort order for the 'bills' sub-resource. 'recent' (default) returns newest update-date first; 'oldest' returns ascending update-date order. Ignored by other operations.",
      "type": "string",
      "enum": [
        "recent",
        "oldest"
      ]
    }
  },
  "required": [
    "operation"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

congressgov_roll_votes

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.

Parameters8

operation	string	required	Which data to retrieve.
chamber	string	optional	Chamber 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 one chamber.
congress	integer	required	Congress number.
session	integer	required	Session number (1 or 2). Odd years are session 1, even years session 2.
voteNumber	integer	optional	Roll call vote number. Required for 'get' and 'members'.
order	string	optional	Sort 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 sorts by roll call number. Ignored by 'get' and 'members'.
limit	integer	optional	Results per page (1-250).
offset	integer	optional	Pagination offset.

Raw schema

{
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "list",
        "get",
        "members"
      ],
      "description": "Which data to retrieve."
    },
    "chamber": {
      "default": "house",
      "description": "Chamber 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 one chamber.",
      "type": "string",
      "enum": [
        "house",
        "senate"
      ]
    },
    "congress": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Congress number."
    },
    "session": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2,
      "description": "Session number (1 or 2). Odd years are session 1, even years session 2."
    },
    "voteNumber": {
      "description": "Roll call vote number. Required for 'get' and 'members'.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "order": {
      "default": "recent",
      "description": "Sort 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 sorts by roll call number. Ignored by 'get' and 'members'.",
      "type": "string",
      "enum": [
        "recent",
        "oldest"
      ]
    },
    "limit": {
      "default": 20,
      "description": "Results per page (1-250).",
      "type": "integer",
      "minimum": 1,
      "maximum": 250
    },
    "offset": {
      "default": 0,
      "description": "Pagination offset.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "operation",
    "congress",
    "session"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

congressgov_senate_nominations

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.

Parameters6

operation	string	required	Which data to retrieve.
congress	integer	required	Congress number.
nominationNumber	string	optional	Nomination 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 for detail operations.
ordinal	integer	optional	Batch 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 on the nomination's `nominees` array (multi-part parents have no nominees array — use a partitioned form like '851-1' instead).
limit	integer	optional	Results per page (1-250).
offset	integer	optional	Pagination offset.

Raw schema

{
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "list",
        "get",
        "nominees",
        "actions",
        "committees",
        "hearings"
      ],
      "description": "Which data to retrieve."
    },
    "congress": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Congress number."
    },
    "nominationNumber": {
      "description": "Nomination 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 for detail operations.",
      "type": "string"
    },
    "ordinal": {
      "description": "Batch 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 on the nomination's `nominees` array (multi-part parents have no nominees array — use a partitioned form like '851-1' instead).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "description": "Results per page (1-250).",
      "type": "integer",
      "minimum": 1,
      "maximum": 250
    },
    "offset": {
      "default": 0,
      "description": "Pagination offset.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "operation",
    "congress"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

congressgov_bill_summaries

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. A page stops adding rows once it reaches a fixed response-character budget, and a summary longer than the per-row window arrives as an exact character window carrying textTotalCharacters/textTruncated/textNextOffset; pagination.nextOffset continues the page and a row's textNextOffset continues its text. For summaries of one specific bill — and to read a windowed summary to the end — use congressgov_bill_lookup with operation='summaries' instead.

Parameters6

congress	integer	optional	Congress number. Optional — omit for summaries across all congresses.
billType	string	optional	Bill type filter. Requires 'congress'.
fromDateTime	string	optional	Start of date range (ISO 8601), filtered on the summary update time. Defaults to 7 days ago if neither date param is set.
toDateTime	string	optional	End of date range (ISO 8601), filtered on the summary update time. Defaults to now.
limit	integer	optional	Results per page (1-250).
offset	integer	optional	Pagination offset.

Raw schema

{
  "type": "object",
  "properties": {
    "congress": {
      "description": "Congress number. Optional — omit for summaries across all congresses.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "billType": {
      "description": "Bill type filter. Requires 'congress'.",
      "type": "string",
      "enum": [
        "hr",
        "s",
        "hjres",
        "sjres",
        "hconres",
        "sconres",
        "hres",
        "sres"
      ]
    },
    "fromDateTime": {
      "description": "Start of date range (ISO 8601), filtered on the summary update time. Defaults to 7 days ago if neither date param is set.",
      "type": "string"
    },
    "toDateTime": {
      "description": "End of date range (ISO 8601), filtered on the summary update time. Defaults to now.",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Results per page (1-250).",
      "type": "integer",
      "minimum": 1,
      "maximum": 250
    },
    "offset": {
      "default": 0,
      "description": "Pagination offset.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

congressgov_crs_reports

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).

Parameters4

operation	string	required	Which data to retrieve.
reportNumber	string	optional	CRS report ID (e.g., 'R40097'). Required for 'get'.
limit	integer	optional	Results per page (1-250).
offset	integer	optional	Pagination offset.

Raw schema

{
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "list",
        "get"
      ],
      "description": "Which data to retrieve."
    },
    "reportNumber": {
      "description": "CRS report ID (e.g., 'R40097'). Required for 'get'.",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Results per page (1-250).",
      "type": "integer",
      "minimum": 1,
      "maximum": 250
    },
    "offset": {
      "default": 0,
      "description": "Pagination offset.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "operation"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

congressgov_committee_reports

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). 'text' lists the published format URLs; 'content' then reads the report's actual text, a bounded character window at a time.

Parameters9

operation	string	required	Which data to retrieve.
congress	integer	required	Congress number.
reportType	string	optional	Report type. Required for get, text, and content operations.
reportNumber	integer	optional	Committee report number. Required for get, text, and content operations.
limit	integer	optional	Results per page (1-250).
offset	integer	optional	Pagination offset.
format	string	optional	Document format for 'content'. 'text' is GPO's Formatted Text — plain, pre-formatted print output, published for every document checked. 'xml' prefers United States Legislative Markup and falls back to Formatted XML; it exists on some bill text versions and on no committee report or Congressional Record article. PDF is not retrieved — read one at the format URLs 'text'/'articles' return.
characterOffset	integer	optional	First character to return for 'content', 0-based. Offsets are exact and are never snapped to a section or paragraph break, so feeding the response's nextOffset back walks the whole document with every character returned exactly once.
characterLimit	integer	optional	Maximum characters to return for 'content' (1-100000). Legislative documents run past a million characters, so a full bill takes several windows.

Raw schema

{
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "list",
        "get",
        "text",
        "content"
      ],
      "description": "Which data to retrieve."
    },
    "congress": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Congress number."
    },
    "reportType": {
      "description": "Report type. Required for get, text, and content operations.",
      "type": "string",
      "enum": [
        "hrpt",
        "srpt",
        "erpt"
      ]
    },
    "reportNumber": {
      "description": "Committee report number. Required for get, text, and content operations.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "description": "Results per page (1-250).",
      "type": "integer",
      "minimum": 1,
      "maximum": 250
    },
    "offset": {
      "default": 0,
      "description": "Pagination offset.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "format": {
      "default": "text",
      "description": "Document format for 'content'. 'text' is GPO's Formatted Text — plain, pre-formatted print output, published for every document checked. 'xml' prefers United States Legislative Markup and falls back to Formatted XML; it exists on some bill text versions and on no committee report or Congressional Record article. PDF is not retrieved — read one at the format URLs 'text'/'articles' return.",
      "type": "string",
      "enum": [
        "text",
        "xml"
      ]
    },
    "characterOffset": {
      "default": 0,
      "description": "First character to return for 'content', 0-based. Offsets are exact and are never snapped to a section or paragraph break, so feeding the response's nextOffset back walks the whole document with every character returned exactly once.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "characterLimit": {
      "default": 25000,
      "description": "Maximum characters to return for 'content' (1-100000). Legislative documents run past a million characters, so a full bill takes several windows.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100000
    }
  },
  "required": [
    "operation",
    "congress"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

congressgov_daily_record

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. 'articles' lists each article and its format URLs; 'content' then reads one article's actual text, a bounded character window at a time.

Parameters9

operation	string	required	Which data to retrieve.
volumeNumber	any	optional	Volume number. Required for 'issues', 'articles', and 'content'. Accepts a number or the digit-string form list rows carry.
issueNumber	any	optional	Issue number within a volume. Required for 'articles' and 'content'. List rows carry this as a string (e.g. "109") — both forms are accepted.
limit	integer	optional	Results per page (1-250).
offset	integer	optional	Pagination offset.
articleIndex	integer	optional	Which article 'content' reads, 0-based against the issue's whole article sequence — the same absolute position 'articles' pages through with offset. Ignored by other operations.
format	string	optional	Document format for 'content'. 'text' is GPO's Formatted Text — plain, pre-formatted print output, published for every document checked. 'xml' prefers United States Legislative Markup and falls back to Formatted XML; it exists on some bill text versions and on no committee report or Congressional Record article. PDF is not retrieved — read one at the format URLs 'text'/'articles' return.
characterOffset	integer	optional	First character to return for 'content', 0-based. Offsets are exact and are never snapped to a section or paragraph break, so feeding the response's nextOffset back walks the whole document with every character returned exactly once.
characterLimit	integer	optional	Maximum characters to return for 'content' (1-100000). Legislative documents run past a million characters, so a full bill takes several windows.

Raw schema

{
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "list",
        "issues",
        "articles",
        "content"
      ],
      "description": "Which data to retrieve."
    },
    "volumeNumber": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991,
          "description": "Positive integer form."
        },
        {
          "type": "string",
          "pattern": "^0*[1-9]\\d*$",
          "description": "Digit-string form, as list rows carry it."
        }
      ],
      "description": "Volume number. Required for 'issues', 'articles', and 'content'. Accepts a number or the digit-string form list rows carry."
    },
    "issueNumber": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991,
          "description": "Positive integer form."
        },
        {
          "type": "string",
          "pattern": "^0*[1-9]\\d*$",
          "description": "Digit-string form, as list rows carry it."
        }
      ],
      "description": "Issue number within a volume. Required for 'articles' and 'content'. List rows carry this as a string (e.g. \"109\") — both forms are accepted."
    },
    "limit": {
      "default": 20,
      "description": "Results per page (1-250).",
      "type": "integer",
      "minimum": 1,
      "maximum": 250
    },
    "offset": {
      "default": 0,
      "description": "Pagination offset.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "articleIndex": {
      "default": 0,
      "description": "Which article 'content' reads, 0-based against the issue's whole article sequence — the same absolute position 'articles' pages through with offset. Ignored by other operations.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "format": {
      "default": "text",
      "description": "Document format for 'content'. 'text' is GPO's Formatted Text — plain, pre-formatted print output, published for every document checked. 'xml' prefers United States Legislative Markup and falls back to Formatted XML; it exists on some bill text versions and on no committee report or Congressional Record article. PDF is not retrieved — read one at the format URLs 'text'/'articles' return.",
      "type": "string",
      "enum": [
        "text",
        "xml"
      ]
    },
    "characterOffset": {
      "default": 0,
      "description": "First character to return for 'content', 0-based. Offsets are exact and are never snapped to a section or paragraph break, so feeding the response's nextOffset back walks the whole document with every character returned exactly once.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "characterLimit": {
      "default": 25000,
      "description": "Maximum characters to return for 'content' (1-100000). Legislative documents run past a million characters, so a full bill takes several windows.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100000
    }
  },
  "required": [
    "operation"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

README.md21 KBView on GitHub

@cyanheads/congressgov-mcp-server

Access U.S. congressional data - bills, votes, members, committees - through MCP. STDIO & Streamable HTTP.

11 Tools • 5 Resources • 2 Prompts

MCP SDK TypeScript

Public Hosted Server: https://congressgov.caseyjhand.com/mcp

Overview

U.S. congressional data from the Congress.gov API v3 and the Senate's official vote feed: bills, enacted laws, members, committees, roll call votes, nominations, CRS and committee reports, and the Congressional Record. Browse legislative activity, read bill and report text, and follow the Senate confirmation pipeline from any MCP client. Runs as a stdio process, a local Streamable HTTP server, or the public hosted endpoint above.

Tools

Tool	Description
`congressgov_bill_lookup`	Browse and retrieve bills: actions, sponsors, summaries, text, related bills
`congressgov_enacted_laws`	Browse enacted public and private laws by congress
`congressgov_member_lookup`	Find members by state, district, or congress, and retrieve their legislative portfolios
`congressgov_committee_lookup`	Browse committees and their legislation, reports, and nominations
`congressgov_roll_votes`	Retrieve House and Senate roll call votes and each member's position
`congressgov_senate_nominations`	Browse presidential nominations and track Senate confirmation
`congressgov_bill_summaries`	Browse recently updated CRS bill summaries
`congressgov_crs_reports`	Browse and retrieve nonpartisan CRS policy reports
`congressgov_committee_reports`	Browse and read committee reports accompanying legislation
`congressgov_daily_record`	Browse and read the daily Congressional Record
`congressgov_search_bills`	Keyword-search bill titles and CRS summaries via a local full-text mirror (opt-in)

Resources

Resource	Description
`congress://current`	Current congress number, session dates, chamber info
`congress://bill-types`	Reference table of valid bill type codes
`congress://member/{bioguideId}`	Member profile by bioguide ID
`congress://bill/{congress}/{billType}/{billNumber}`	Bill detail by congress, type, and number
`congress://committee/{committeeCode}`	Committee detail by committee code

Bill, member, and committee data is also reachable through congressgov_bill_lookup, congressgov_member_lookup, and congressgov_committee_lookup (operation get), since many MCP clients are tool-only and never surface resources.

Prompts

Prompt	Description
`congressgov_bill_analysis`	Structured framework for analyzing a bill
`congressgov_legislative_research`	Research framework for a policy area across Congress

Capability reference

`congressgov_bill_lookup` _tool

list browses one congress, narrowed by billType and a fromDateTime/toDateTime range on the record's update date, newest first unless order: 'oldest'; get, actions, amendments, cosponsors, committees, subjects, summaries, text, titles, related, and content need congress + billType + billNumber
content reads the text version at textVersionIndex (0-based in text order, 0 is the most recent) and returns one character window in content.text with totalCharacters, truncated, and nextOffset
summaries takes an optional versionCode (00 introduced, 49 public law) and applies the same page budget and row window as congressgov_bill_summaries, steered by characterOffset/characterLimit; a cut row carries textTotalCharacters, textTruncated, and textNextOffset

`congressgov_enacted_laws` _tool

list browses one congress, optionally by lawType (pub or priv), the enactment filter congressgov_bill_lookup lacks; get needs lawType + lawNumber, taken from a list row's laws[].number (118-90) or its bare number (90)
get returns the origin bill record, with the law citation on its laws[] array

`congressgov_member_lookup` _tool

No name search: list filters by stateCode (plus district, 0 for at-large, which requires stateCode), congress, and currentMember
get returns the profile for a bioguideId (e.g. P000197); sponsored and cosponsored return that member's legislation

`congressgov_committee_lookup` _tool

committeeCode is a chamber prefix (h/s/j), letters, and a 2-digit suffix (e.g. hsju00); get, bills, reports, and the Senate-only nominations infer chamber from the prefix
A committee name in committeeCode resolves when exactly one committee matches, and otherwise returns the candidate rows with a notice; list with filter name-matches every committee in scope, past the 250-row page cap, and fuzzy hits carry approximate: true
bills is newest first by default (order), and its rows carry no titles, so chain congressgov_bill_lookup get per row

`congressgov_roll_votes` _tool

chamber is house (default, Congress.gov API) or senate (the Senate's LIS feed); every call needs congress + session (1 or 2), and get/members add voteNumber, which resets each session and is specific to one chamber
list is newest first unless order: 'oldest'; get returns the question, result, tallies, and party breakdown, and members returns each member's position
Senate votes start at the 101st Congress (1989), and Senate rows pair the feed's year-less voteDate with a derived voteDateIso

`congressgov_senate_nominations` _tool

list browses one congress; get, actions, committees, hearings, and nominees need a nominationNumber (1000 for PN1000), and nominees also needs an ordinal from the nominees array get returns
Multi-part nominations (e.g. PN851) keep their activity on partitioned children (851-1, 851-2, …); an empty sub-resource call on the bare number returns a notice pointing there

`congressgov_bill_summaries` _tool

Optional congress and billType (which requires congress); fromDateTime/toDateTime filter on the summary's update time, not the bill's action date, and cover the last 7 days when both are omitted
A page stops adding rows at 50,000 serialized characters (at least one row always returns, and pagination.nextOffset resumes); a summary over 25,000 characters arrives windowed with textTotalCharacters, textTruncated, and textNextOffset
For one bill's summaries, or to read a windowed summary to the end, use congressgov_bill_lookup summaries

`congressgov_crs_reports` _tool

list browses the catalog; get takes a reportNumber such as R40097, RL33612, or IF12345
get returns authors, topics, summary, and download formats

`congressgov_committee_reports` _tool

list browses one congress, optionally by reportType (hrpt House, srpt Senate, erpt Executive); get, text, and content need reportType + reportNumber
get returns the citation, title, committees, and associated bill; text lists {type, url} format links, and content reads the report as one character window

`congressgov_daily_record` _tool

Navigation runs list (volumes) → issues (by volumeNumber) → articles (by volumeNumber + issueNumber)
content reads the article at articleIndex (0-based across the issue) as one character window; Record articles publish Formatted Text and PDF only, so format: 'xml' fails as format_unavailable

`congressgov_search_bills` _tool

query keywords (AND-combined) over bill titles and CRS summaries, narrowed by congress, billType, and originChamber; limit 1–100, offset pagination
BM25-ranked rows carry billId plus congress/billType/billNumber for congressgov_bill_lookup, and a summaryPreview; policy area and full bill text are not indexed
Listed only when CONGRESS_MIRROR_ENABLED=true; until bun run mirror:init builds the index, it returns an empty result with a notice

`congress://current` _resource

Current congress number, session dates, and chamber info, the baseline for other queries
Cached publicly for 1 hour

`congress://bill-types` _resource

The 8 bill type codes (hr, s, hjres, sjres, hconres, sconres, hres, sres) with description, chamber, and an example citation
Static, with no upstream call; cached publicly for 24 hours

`congress://member/{bioguideId}` _resource

bioguideId is one uppercase letter and 6 digits (e.g. P000197)
Returns the member profile: name, state, party, terms, leadership, office, legislation counts

`congress://bill/{congress}/{billType}/{billNumber}` _resource

congress and billNumber are positive integers; billType is one of the 8 bill type codes
Returns bill detail: sponsor, status, policy area, committees, latest action

`congress://committee/{committeeCode}` _resource

committeeCode is h/s/j followed by 3–8 lowercase alphanumeric characters (e.g. hsju00); chamber comes from the first letter
Returns committee detail: name, chamber, subcommittees, history, legislation counts

`congressgov_bill_analysis` _prompt

Arguments: congress, billType, and billNumber, all required
Returns one user message framing a seven-part analysis, from summary to outlook, with the tools to call for each part

`congressgov_legislative_research` _prompt

Arguments: topic required; congress optional, defaulting to the current congress
With CONGRESS_MIRROR_ENABLED, the plan opens with congressgov_search_bills; without it, the prompt asks for a seed bill, member, committee, or CRS report ID, since no other tool takes a topic

Features

Built on @cyanheads/mcp-ts-core: stdio and Streamable HTTP transports, pluggable auth (none / jwt / oauth), swappable storage (in-memory, filesystem, Supabase, Cloudflare KV/R2/D1), structured logging with optional OpenTelemetry tracing.

Congress.gov-specific:

Type-safe client for the Congress.gov REST API v3, plus a client for the Senate's LIS XML feed that backs Senate roll votes
The Congress.gov API has no keyword search, so tools browse by congress, type, date range, chamber, state, and district, and address bills by congress + billType + billNumber, members by bioguideId, and committees by system code; list operations page with limit 1–250 (default 20) and offset
content on bill text, committee reports, and Record articles reads format text (default) or xml through a characterOffset/characterLimit window (1–100,000 characters, default 25,000), fetched only from www.congress.gov under a 25 MB ceiling and a 30s deadline
Optional API key from api.data.gov: DEMO_KEY allows 30 req/hr, your own key 5,000 req/hr
Opt-in local SQLite FTS5 mirror (CONGRESS_MIRROR_ENABLED) adds keyword search over bill titles and CRS summaries

Agent-friendly output:

Every list response carries effectiveQuery and totalCount; a notice fires when nothing matched, and a page past the end says so in the rendered output
Exact character windows: content returns offset, truncated, and nextOffset, so walking a multi-megabyte bill never skips or repeats a character
Typed content failures (document_unavailable, format_unavailable, document_fetch_failed, document_too_large, offset_past_end) alongside the shared not_found, rate_limited, invalid_request, and upstream_error reasons, each with a recovery hint

Getting started

Public Hosted Instance

A public instance is available at https://congressgov.caseyjhand.com/mcp — no installation required. Point any MCP client at it via Streamable HTTP:

json

{
  "mcpServers": {
    "congressgov-mcp-server": {
      "type": "streamable-http",
      "url": "https://congressgov.caseyjhand.com/mcp"
    }
  }
}

Self-Hosted / Local

Add the following to your MCP client configuration file.

json

{
  "mcpServers": {
    "congressgov-mcp-server": {
      "type": "stdio",
      "command": "bunx",
      "args": ["@cyanheads/congressgov-mcp-server@latest"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "MCP_LOG_LEVEL": "info",
        "CONGRESS_API_KEY": "your-api-key"
      }
    }
  }
}

Or with npx (no Bun required):

json

{
  "mcpServers": {
    "congressgov-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@cyanheads/congressgov-mcp-server@latest"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "MCP_LOG_LEVEL": "info",
        "CONGRESS_API_KEY": "your-api-key"
      }
    }
  }
}

Or with Docker:

json

{
  "mcpServers": {
    "congressgov-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "MCP_TRANSPORT_TYPE=stdio",
        "-e", "CONGRESS_API_KEY=your-api-key",
        "ghcr.io/cyanheads/congressgov-mcp-server:latest"
      ]
    }
  }
}

For Streamable HTTP, set the transport and start the server:

MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 CONGRESS_API_KEY=your-api-key bun run start:http
# Server listens at http://localhost:3010/mcp

Prerequisites

Bun v1.4.0 or higher (or Node.js v24+).
Optional: a free api.data.gov key raises the limit from 30 to 5,000 requests per hour.

Installation

Clone the repository:

git clone https://github.com/cyanheads/congressgov-mcp-server.git

Navigate into the directory:

cd congressgov-mcp-server

Install dependencies:

bun install

Configure environment:

cp .env.example .env
# edit .env and set CONGRESS_API_KEY (and the mirror vars, if you want keyword search)

Configuration

Variable	Description	Default
`CONGRESS_API_KEY`	API key from api.data.gov. `DEMO_KEY` allows 30 req/hr; your own key 5,000 req/hr.	`DEMO_KEY`
`CONGRESS_API_BASE_URL`	Congress.gov API base URL.	`https://api.congress.gov/v3`
`CONGRESS_MIRROR_ENABLED`	Enable the local bill search mirror and the `congressgov_search_bills` tool.	`false`
`CONGRESS_MIRROR_PATH`	Filesystem path to the SQLite mirror index.	`.mirror/bills.sqlite3`
`CONGRESS_MIRROR_REFRESH_CRON`	Cron schedule for the in-process mirror refresh (HTTP transport only). Unset means running `mirror:refresh` yourself.	—
`CONGRESS_MIRROR_CONGRESSES`	Comma-separated congress numbers to mirror (e.g. `118,119`).	current congress + 1 prior
`MCP_TRANSPORT_TYPE`	Transport: `stdio` or `http`.	`stdio`
`MCP_HTTP_PORT`	HTTP server port.	`3010`
`MCP_SESSION_MODE`	HTTP session mode: `stateless`, `stateful`, or `auto`; `auto` resolves to `stateful`.	`stateless`
`MCP_AUTH_MODE`	Authentication: `none`, `jwt`, or `oauth`.	`none`
`MCP_LOG_LEVEL`	Log level (`debug`, `info`, `notice`, `warning`, `error`, etc.).	`info`
`LOGS_DIR`	Directory for log files (Node.js only).	`<project-root>/logs`
`OTEL_ENABLED`	Enable OpenTelemetry.	`false`
`OTEL_EXPORTER_OTLP_ENDPOINT`	Base OTLP endpoint for traces and metrics.	—
`OTEL_EXPORTER_OTLP_LOGS_ENDPOINT`	Explicit OTLP logs endpoint; the base endpoint does not enable log export.	—
`LOG_TOOL_FAILURE_PAYLOADS`	Log failed-call input and output with key-based redaction; secrets inside free-form values are not redacted.	`false`
`LOG_TOOL_FAILURE_PAYLOAD_MAX_BYTES`	Maximum bytes per failed-call input or output record.	`16384`

See .env.example for the full list of optional overrides.

Running the server

Local development

Build and run the production version:

bun run rebuild
bun run start:http   # or start:stdio

Build the bill search mirror (with CONGRESS_MIRROR_ENABLED=true):

bun run mirror:init      # full build
bun run mirror:refresh   # incremental refresh
bun run mirror:verify    # readiness and integrity check

Run checks and tests:

bun run devcheck   # Lint, format, typecheck, security
bun run test       # Vitest test suite
bun run lint:mcp   # Validate MCP definitions against spec

Docker

docker build -t congressgov-mcp-server .
docker run --rm -e CONGRESS_API_KEY=your-api-key -p 3010:3010 congressgov-mcp-server

The Dockerfile defaults to HTTP transport, stateless session mode, and logs to /var/log/congressgov-mcp-server. OpenTelemetry peer dependencies are installed by default; build with --build-arg OTEL_ENABLED=false to omit them. The image carries the mirror scripts, so docker exec <container> bun run mirror:init builds the index in place.

Project structure

Directory	Purpose
`src/index.ts`	`createApp()` entry point: registers tools, resources, and prompts, inits services, and schedules the mirror refresh.
`src/config/`	Server-specific environment variable parsing and validation with Zod.
`src/mcp-server/tools/`	Tool definitions (`definitions/*.tool.ts`) plus shared input, formatting, and summary-window helpers.
`src/mcp-server/resources/definitions/`	Resource definitions (`*.resource.ts`).
`src/mcp-server/prompts/definitions/`	Prompt definitions (`*.prompt.ts`).
`src/services/congress-api/`	Congress.gov API client: auth, pagination, rate limiting.
`src/services/congress-documents/`	Bounded document-text fetch: host allowlist, byte ceiling, character window.
`src/services/congress-mirror/`	Local SQLite FTS5 bill-search mirror: ingest, normalize, schema.
`src/services/senate-lis/`	Senate LIS XML client for Senate roll call votes.
`src/utils/`	HTML/XML character-reference decoding.
`scripts/`	Build, devcheck, and release tooling, plus the `mirror:init` / `mirror:refresh` / `mirror:verify` CLIs.
`tests/`	Unit and integration tests, mirroring the `src/` structure.

Development guide

See CLAUDE.md for development guidelines and architectural rules. The short version:

Handlers throw, framework catches — no try/catch in tool logic
Use ctx.log for request-scoped logging, ctx.state for tenant-scoped storage
All tools are read-only, with readOnlyHint: true and idempotentHint: true annotations
Wrap external API calls: validate raw → normalize to a domain type → return the output schema; never fabricate missing fields

Contributing

Issues are welcome. Run checks and tests before submitting:

bun run devcheck
bun run test

License

Apache-2.0 — see LICENSE for details.

Install

Tools (10)

congressgov_bill_lookupcongressgov_enacted_lawscongressgov_member_lookupcongressgov_committee_lookupcongressgov_roll_votescongressgov_senate_nominationscongressgov_bill_summariescongressgov_crs_reports

Configuration

Environment variables

CONGRESS_API_KEY

API key from api.data.gov — optional (falls back to DEMO_KEY: 30 req/hr). Own key: 5000 req/hr. Free signup at api.data.gov.

MCP_LOG_LEVELdefault info

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

MCP_HTTP_HOSTdefault 127.0.0.1

The hostname for the HTTP server.

MCP_HTTP_PORTdefault 3010

The port to run the HTTP server on.

MCP_HTTP_ENDPOINT_PATHdefault /mcp

The endpoint path for the MCP server.

MCP_AUTH_MODEdefault none

Authentication mode to use: 'none', 'jwt', or 'oauth'.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "congressgov-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/congressgov-mcp-server@0.7.3",
        "run",
        "start:stdio"
      ],
      "env": {
        "CONGRESS_API_KEY": "<YOUR_CONGRESS_API_KEY>",
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

congressgov_bill_lookup

congressgov_enacted_laws

congressgov_member_lookup

congressgov_committee_lookup

congressgov_roll_votes

congressgov_senate_nominations

congressgov_bill_summaries

congressgov_crs_reports

congressgov_committee_reports

congressgov_daily_record

@cyanheads/congressgov-mcp-server

Overview

Tools

Resources

Prompts

Capability reference

congressgov_bill_lookup tool

congressgov_enacted_laws tool

congressgov_member_lookup tool

congressgov_committee_lookup tool

congressgov_roll_votes tool

congressgov_senate_nominations tool

congressgov_bill_summaries tool

congressgov_crs_reports tool

congressgov_committee_reports tool

congressgov_daily_record tool

congressgov_search_bills tool

congress://current resource

congress://bill-types resource

congress://member/{bioguideId} resource

congress://bill/{congress}/{billType}/{billNumber} resource

congress://committee/{committeeCode} resource

congressgov_bill_analysis prompt

congressgov_legislative_research prompt

Features

Getting started

Public Hosted Instance

Self-Hosted / Local

Prerequisites

Installation

Configuration

Running the server

Local development

Docker

Project structure

Development guide

Contributing

License

Install

Configuration

Related servers

`congressgov_bill_lookup` _tool

`congressgov_enacted_laws` _tool

`congressgov_member_lookup` _tool

`congressgov_committee_lookup` _tool

`congressgov_roll_votes` _tool

`congressgov_senate_nominations` _tool

`congressgov_bill_summaries` _tool

`congressgov_crs_reports` _tool

`congressgov_committee_reports` _tool

`congressgov_daily_record` _tool

`congressgov_search_bills` _tool

`congress://current` _resource

`congress://bill-types` _resource

`congress://member/{bioguideId}` _resource

`congress://bill/{congress}/{billType}/{billNumber}` _resource

`congress://committee/{committeeCode}` _resource

`congressgov_bill_analysis` _prompt

`congressgov_legislative_research` _prompt