congressgov-mcp-server

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['operation', 'congress'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 250, 'minimum': 1, 'description': 'Results per page (1-250).'}, 'order': {'enum': ['recent', 'oldest'], 'type': 'string', 'default': 'recent', 'description': "Sort order for 'list' (sorts by update date). 'recent' (default) is newest first; 'oldest' is ascending. Ignored by other operations."}, 'format': {'enum': ['text', 'xml'], 'type': 'string', 'default': 'text', 'description': "Document format for 'content'. 'text' is GPO's Formatted Text â\x80\x94 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 â\x80\x94 read one at the format URLs 'text'/'articles' return."}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Pagination offset.'}, 'billType': {'enum': ['hr', 's', 'hjres', 'sjres', 'hconres', 'sconres', 'hres', 'sres'], 'type': 'string', 'description': 'Bill type code. Required for get and sub-resource operations.'}, 'congress': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Congress number (e.g., 118, 119).', 'exclusiveMinimum': 0}, 'operation': {'enum': ['list', 'get', 'actions', 'amendments', 'cosponsors', 'committees', 'subjects', 'summaries', 'text', 'titles', 'related', 'content'], 'type': 'string', 'description': 'Which data to retrieve.'}, 'billNumber': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'description': 'Positive integer form.', 'exclusiveMinimum': 0}, {'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.'}, 'toDateTime': {'type': 'string', 'description': 'End of date range filter (ISO 8601). Same field semantics as fromDateTime.'}, 'versionCode': {'type': 'string', 'description': "Which summary version 'summaries' returns â\x80\x94 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."}, 'fromDateTime': {'type': 'string', 'description': "Start of date range filter (ISO 8601). Filters by the bill's update date â\x80\x94 when Congress.gov last touched the record â\x80\x94 not by the bill's latest legislative action."}, 'characterLimit': {'type': 'integer', 'default': 25000, 'maximum': 100000, 'minimum': 1, 'description': "Maximum characters to return (1-100000) â\x80\x94 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."}, 'characterOffset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': "First character to return, 0-based â\x80\x94 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."}, 'textVersionIndex': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': "Which text version 'content' reads, 0-based against the same order 'text' returns â\x80\x94 0 is the most recent version. Ignored by other operations."}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['effectiveQuery', 'totalCount']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'bill': {'type': 'object', 'properties': {}, 'description': 'Dynamic upstream JSON record.', 'additionalProperties': {}}, 'data': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'description': 'Upstream JSON record. Per-tool item shape is rendered in the markdown body.', 'additionalProperties': {}}, 'description': 'Result rows. Per-tool item shape is rendered in the markdown body.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['not_found', 'rate_limited', 'invalid_request', 'upstream_error', 'document_unavailable', 'format_unavailable', 'document_fetch_failed', 'document_too_large', 'offset_past_end'], 'description': "Machine-readable failure mode. Declared by this tool: `not_found`: A requested bill, member, committee, report, vote, or nomination does not exist in Congress.gov. `rate_limited`: The Congress.gov API rate limit (5,000 requests/hour per key) was exceeded. `invalid_request`: Congress.gov rejected the request as malformed â\x80\x94 a bad date range or an identifier with an unexpected shape. `upstream_error`: Congress.gov returned an unexpected error (5xx or another non-2xx status). `document_unavailable`: The 'content' selection resolves to no retrievable document â\x80\x94 the text version or article index is past the end of the list, the record publishes no formats at all, or Congress.gov does not hold the file its own metadata names. `format_unavailable`: The document exists but publishes nothing in the requested 'format' â\x80\x94 some text versions and committee reports ship PDF only, and no Congressional Record article publishes XML. `document_fetch_failed`: www.congress.gov did not return a readable document â\x80\x94 a non-2xx status, a network failure, an empty body, or a content type that is not text or XML. `document_too_large`: The document is larger than the byte ceiling this server retrieves, so no character window can be served from it. `offset_past_end`: characterOffset is at or beyond the last character of every text the call would window â\x80\x94 the document on 'content', or every returned row's summary text on 'summaries' â\x80\x94 so the window would be empty. Other values are possible when a failure originates below the handler."}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Guidance when results are empty, a page is past the end, or a caveat applies.'}, 'content': {'type': 'object', 'properties': {}, 'description': 'Dynamic upstream JSON record.', 'additionalProperties': {}}, 'pagination': {'type': 'object', 'required': ['count'], 'properties': {'count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Total result count across all pages.'}, 'nextOffset': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}], 'description': 'Offset to pass for the next page, or null when there are no more pages.'}}, 'description': 'Pagination metadata: total count and next offset.', 'additionalProperties': False}, 'totalCount': {'type': 'number', 'description': 'Total results across all pages.'}, 'effectiveQuery': {'type': 'string', 'description': 'The browse scope and applied filters.'}}, 'additionalProperties': {}}

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

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['data', 'pagination', 'effectiveQuery', 'totalCount']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'description': 'Upstream JSON record. Per-tool item shape is rendered in the markdown body.', 'additionalProperties': {}}, 'description': 'Result rows. Per-tool item shape is rendered in the markdown body.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['not_found', 'rate_limited', 'invalid_request', 'upstream_error'], 'description': 'Machine-readable failure mode. Declared by this tool: `not_found`: A requested bill, member, committee, report, vote, or nomination does not exist in Congress.gov. `rate_limited`: The Congress.gov API rate limit (5,000 requests/hour per key) was exceeded. `invalid_request`: Congress.gov rejected the request as malformed â\x80\x94 a bad date range or an identifier with an unexpected shape. `upstream_error`: Congress.gov returned an unexpected error (5xx or another non-2xx status). Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Guidance when results are empty, a page is past the end, or a caveat applies.'}, 'pagination': {'type': 'object', 'required': ['count'], 'properties': {'count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Total result count across all pages.'}, 'nextOffset': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}], 'description': 'Offset to pass for the next page, or null when there are no more pages.'}}, 'description': 'Pagination metadata: total count and next offset.', 'additionalProperties': False}, 'totalCount': {'type': 'number', 'description': 'Total results across all pages.'}, 'effectiveQuery': {'type': 'string', 'description': 'The browse scope and applied filters.'}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['operation'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 250, 'minimum': 1, 'description': 'Results per page (1-250).'}, 'order': {'enum': ['recent', 'oldest'], 'type': 'string', '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."}, 'filter': {'type': 'string', 'description': "Filter committee-list results by name (e.g., 'transportation', 'armed services'). Only meaningful for 'list'; fuzzy-matched rows are labeled approximate."}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Pagination offset.'}, 'chamber': {'enum': ['house', 'senate', 'joint'], 'type': 'string', 'description': "Chamber filter for 'list', or override for 'get' and sub-resources (otherwise inferred from committeeCode prefix)."}, 'congress': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Congress number.', 'exclusiveMinimum': 0}, 'operation': {'enum': ['list', 'get', 'bills', 'reports', 'nominations'], 'type': 'string', 'description': 'Which data to retrieve.'}, 'committeeCode': {'type': 'string', 'pattern': '\\S', '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 â\x80\x94 single-word names ('Judiciary') included â\x80\x94 or use operation:'list' with filter to browse."}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['effectiveQuery', 'totalCount']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'description': 'Upstream JSON record. Per-tool item shape is rendered in the markdown body.', 'additionalProperties': {}}, 'description': 'Result rows. Per-tool item shape is rendered in the markdown body.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['not_found', 'rate_limited', 'invalid_request', 'upstream_error'], 'description': 'Machine-readable failure mode. Declared by this tool: `not_found`: A requested bill, member, committee, report, vote, or nomination does not exist in Congress.gov. `rate_limited`: The Congress.gov API rate limit (5,000 requests/hour per key) was exceeded. `invalid_request`: Congress.gov rejected the request as malformed â\x80\x94 a bad date range or an identifier with an unexpected shape. `upstream_error`: Congress.gov returned an unexpected error (5xx or another non-2xx status). Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Guidance when results are empty, a page is past the end, or a caveat applies.'}, 'committee': {'type': 'object', 'properties': {}, 'description': 'Dynamic upstream JSON record.', 'additionalProperties': {}}, 'pagination': {'type': 'object', 'required': ['count'], 'properties': {'count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Total result count across all pages.'}, 'nextOffset': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}], 'description': 'Offset to pass for the next page, or null when there are no more pages.'}}, 'description': 'Pagination metadata: total count and next offset.', 'additionalProperties': False}, 'totalCount': {'type': 'number', 'description': 'Total results across all pages.'}, 'effectiveQuery': {'type': 'string', 'description': 'The browse scope and applied filters.'}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['operation', 'congress'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 250, 'minimum': 1, 'description': 'Results per page (1-250).'}, 'format': {'enum': ['text', 'xml'], 'type': 'string', 'default': 'text', 'description': "Document format for 'content'. 'text' is GPO's Formatted Text â\x80\x94 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 â\x80\x94 read one at the format URLs 'text'/'articles' return."}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Pagination offset.'}, 'congress': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Congress number.', 'exclusiveMinimum': 0}, 'operation': {'enum': ['list', 'get', 'text', 'content'], 'type': 'string', 'description': 'Which data to retrieve.'}, 'reportType': {'enum': ['hrpt', 'srpt', 'erpt'], 'type': 'string', 'description': 'Report type. Required for get, text, and content operations.'}, 'reportNumber': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Committee report number. Required for get, text, and content operations.', 'exclusiveMinimum': 0}, 'characterLimit': {'type': 'integer', 'default': 25000, 'maximum': 100000, 'minimum': 1, 'description': "Maximum characters to return for 'content' (1-100000). Legislative documents run past a million characters, so a full bill takes several windows."}, 'characterOffset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 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."}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['effectiveQuery', 'totalCount']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'description': 'Upstream JSON record. Per-tool item shape is rendered in the markdown body.', 'additionalProperties': {}}, 'description': 'Result rows. Per-tool item shape is rendered in the markdown body.'}, 'text': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'description': 'Dynamic upstream JSON record.', 'additionalProperties': {}}, 'description': 'Dynamic upstream JSON records.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['not_found', 'rate_limited', 'invalid_request', 'upstream_error', 'document_unavailable', 'format_unavailable', 'document_fetch_failed', 'document_too_large', 'offset_past_end'], 'description': "Machine-readable failure mode. Declared by this tool: `not_found`: A requested bill, member, committee, report, vote, or nomination does not exist in Congress.gov. `rate_limited`: The Congress.gov API rate limit (5,000 requests/hour per key) was exceeded. `invalid_request`: Congress.gov rejected the request as malformed â\x80\x94 a bad date range or an identifier with an unexpected shape. `upstream_error`: Congress.gov returned an unexpected error (5xx or another non-2xx status). `document_unavailable`: The 'content' selection resolves to no retrievable document â\x80\x94 the text version or article index is past the end of the list, the record publishes no formats at all, or Congress.gov does not hold the file its own metadata names. `format_unavailable`: The document exists but publishes nothing in the requested 'format' â\x80\x94 some text versions and committee reports ship PDF only, and no Congressional Record article publishes XML. `document_fetch_failed`: www.congress.gov did not return a readable document â\x80\x94 a non-2xx status, a network failure, an empty body, or a content type that is not text or XML. `document_too_large`: The document is larger than the byte ceiling this server retrieves, so no character window can be served from it. `offset_past_end`: characterOffset is at or beyond the last character of every text the call would window â\x80\x94 the document on 'content', or every returned row's summary text on 'summaries' â\x80\x94 so the window would be empty. Other values are possible when a failure originates below the handler."}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Guidance when results are empty, a page is past the end, or a caveat applies.'}, 'report': {'type': 'object', 'properties': {}, 'description': 'Dynamic upstream JSON record.', 'additionalProperties': {}}, 'content': {'type': 'object', 'properties': {}, 'description': 'Dynamic upstream JSON record.', 'additionalProperties': {}}, 'pagination': {'type': 'object', 'required': ['count'], 'properties': {'count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Total result count across all pages.'}, 'nextOffset': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}], 'description': 'Offset to pass for the next page, or null when there are no more pages.'}}, 'description': 'Pagination metadata: total count and next offset.', 'additionalProperties': False}, 'totalCount': {'type': 'number', 'description': 'Total results across all pages.'}, 'effectiveQuery': {'type': 'string', 'description': 'The browse scope and applied filters.'}}, 'additionalProperties': {}}

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

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['effectiveQuery', 'totalCount']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'description': 'Upstream JSON record. Per-tool item shape is rendered in the markdown body.', 'additionalProperties': {}}, 'description': 'Result rows. Per-tool item shape is rendered in the markdown body.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['not_found', 'rate_limited', 'invalid_request', 'upstream_error'], 'description': 'Machine-readable failure mode. Declared by this tool: `not_found`: A requested bill, member, committee, report, vote, or nomination does not exist in Congress.gov. `rate_limited`: The Congress.gov API rate limit (5,000 requests/hour per key) was exceeded. `invalid_request`: Congress.gov rejected the request as malformed â\x80\x94 a bad date range or an identifier with an unexpected shape. `upstream_error`: Congress.gov returned an unexpected error (5xx or another non-2xx status). Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Guidance when results are empty, a page is past the end, or a caveat applies.'}, 'report': {'type': 'object', 'properties': {}, 'description': 'Dynamic upstream JSON record.', 'additionalProperties': {}}, 'pagination': {'type': 'object', 'required': ['count'], 'properties': {'count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Total result count across all pages.'}, 'nextOffset': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}], 'description': 'Offset to pass for the next page, or null when there are no more pages.'}}, 'description': 'Pagination metadata: total count and next offset.', 'additionalProperties': False}, 'totalCount': {'type': 'number', 'description': 'Total results across all pages.'}, 'effectiveQuery': {'type': 'string', 'description': 'The browse scope and applied filters.'}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['operation'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 250, 'minimum': 1, 'description': 'Results per page (1-250).'}, 'format': {'enum': ['text', 'xml'], 'type': 'string', 'default': 'text', 'description': "Document format for 'content'. 'text' is GPO's Formatted Text â\x80\x94 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 â\x80\x94 read one at the format URLs 'text'/'articles' return."}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Pagination offset.'}, 'operation': {'enum': ['list', 'issues', 'articles', 'content'], 'type': 'string', 'description': 'Which data to retrieve.'}, 'issueNumber': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'description': 'Positive integer form.', 'exclusiveMinimum': 0}, {'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") â\x80\x94 both forms are accepted.'}, 'articleIndex': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': "Which article 'content' reads, 0-based against the issue's whole article sequence â\x80\x94 the same absolute position 'articles' pages through with offset. Ignored by other operations."}, 'volumeNumber': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'description': 'Positive integer form.', 'exclusiveMinimum': 0}, {'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."}, 'characterLimit': {'type': 'integer', 'default': 25000, 'maximum': 100000, 'minimum': 1, 'description': "Maximum characters to return for 'content' (1-100000). Legislative documents run past a million characters, so a full bill takes several windows."}, 'characterOffset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 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."}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['effectiveQuery', 'totalCount']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'description': 'Upstream JSON record. Per-tool item shape is rendered in the markdown body.', 'additionalProperties': {}}, 'description': 'Result rows. Per-tool item shape is rendered in the markdown body.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['not_found', 'rate_limited', 'invalid_request', 'upstream_error', 'document_unavailable', 'format_unavailable', 'document_fetch_failed', 'document_too_large', 'offset_past_end'], 'description': "Machine-readable failure mode. Declared by this tool: `not_found`: A requested bill, member, committee, report, vote, or nomination does not exist in Congress.gov. `rate_limited`: The Congress.gov API rate limit (5,000 requests/hour per key) was exceeded. `invalid_request`: Congress.gov rejected the request as malformed â\x80\x94 a bad date range or an identifier with an unexpected shape. `upstream_error`: Congress.gov returned an unexpected error (5xx or another non-2xx status). `document_unavailable`: The 'content' selection resolves to no retrievable document â\x80\x94 the text version or article index is past the end of the list, the record publishes no formats at all, or Congress.gov does not hold the file its own metadata names. `format_unavailable`: The document exists but publishes nothing in the requested 'format' â\x80\x94 some text versions and committee reports ship PDF only, and no Congressional Record article publishes XML. `document_fetch_failed`: www.congress.gov did not return a readable document â\x80\x94 a non-2xx status, a network failure, an empty body, or a content type that is not text or XML. `document_too_large`: The document is larger than the byte ceiling this server retrieves, so no character window can be served from it. `offset_past_end`: characterOffset is at or beyond the last character of every text the call would window â\x80\x94 the document on 'content', or every returned row's summary text on 'summaries' â\x80\x94 so the window would be empty. Other values are possible when a failure originates below the handler."}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Guidance when results are empty, a page is past the end, or a caveat applies.'}, 'content': {'type': 'object', 'properties': {}, 'description': 'Dynamic upstream JSON record.', 'additionalProperties': {}}, 'pagination': {'type': 'object', 'required': ['count'], 'properties': {'count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Total result count across all pages.'}, 'nextOffset': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}], 'description': 'Offset to pass for the next page, or null when there are no more pages.'}}, 'description': 'Pagination metadata: total count and next offset.', 'additionalProperties': False}, 'totalCount': {'type': 'number', 'description': 'Total results across all pages.'}, 'effectiveQuery': {'type': 'string', 'description': 'The browse scope and applied filters.'}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['operation', 'congress'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 250, 'minimum': 1, 'description': 'Results per page (1-250).'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Pagination offset.'}, 'lawType': {'enum': ['pub', 'priv'], 'type': 'string', 'description': "Law type â\x80\x94 'pub' (public laws, general application, most common) or 'priv' (private laws, specific individuals or entities). Required for 'get'."}, 'congress': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Congress number.', 'exclusiveMinimum': 0}, 'lawNumber': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'description': 'Positive integer form (e.g. 90).', 'exclusiveMinimum': 0}, {'type': 'string', 'pattern': '^(?:\\d+-)?0*[1-9]\\d*$', 'description': 'String form â\x80\x94 the law number ("90") or the full citation ("118-90").'}], 'description': "Law number, as carried by a 'list' row's `laws[].number` â\x80\x94 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'."}, 'operation': {'enum': ['list', 'get'], 'type': 'string', 'description': 'Which data to retrieve.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['effectiveQuery', 'totalCount']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'law': {'type': 'object', 'properties': {}, 'description': 'Dynamic upstream JSON record.', 'additionalProperties': {}}, 'data': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'description': 'Upstream JSON record. Per-tool item shape is rendered in the markdown body.', 'additionalProperties': {}}, 'description': 'Result rows. Per-tool item shape is rendered in the markdown body.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['not_found', 'rate_limited', 'invalid_request', 'upstream_error'], 'description': 'Machine-readable failure mode. Declared by this tool: `not_found`: A requested bill, member, committee, report, vote, or nomination does not exist in Congress.gov. `rate_limited`: The Congress.gov API rate limit (5,000 requests/hour per key) was exceeded. `invalid_request`: Congress.gov rejected the request as malformed â\x80\x94 a bad date range or an identifier with an unexpected shape. `upstream_error`: Congress.gov returned an unexpected error (5xx or another non-2xx status). Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Guidance when results are empty, a page is past the end, or a caveat applies.'}, 'pagination': {'type': 'object', 'required': ['count'], 'properties': {'count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Total result count across all pages.'}, 'nextOffset': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}], 'description': 'Offset to pass for the next page, or null when there are no more pages.'}}, 'description': 'Pagination metadata: total count and next offset.', 'additionalProperties': False}, 'totalCount': {'type': 'number', 'description': 'Total results across all pages.'}, 'effectiveQuery': {'type': 'string', 'description': 'The browse scope and applied filters.'}}, 'additionalProperties': {}}

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

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['effectiveQuery', 'totalCount']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'description': 'Upstream JSON record. Per-tool item shape is rendered in the markdown body.', 'additionalProperties': {}}, 'description': 'Result rows. Per-tool item shape is rendered in the markdown body.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['not_found', 'rate_limited', 'invalid_request', 'upstream_error'], 'description': 'Machine-readable failure mode. Declared by this tool: `not_found`: A requested bill, member, committee, report, vote, or nomination does not exist in Congress.gov. `rate_limited`: The Congress.gov API rate limit (5,000 requests/hour per key) was exceeded. `invalid_request`: Congress.gov rejected the request as malformed â\x80\x94 a bad date range or an identifier with an unexpected shape. `upstream_error`: Congress.gov returned an unexpected error (5xx or another non-2xx status). Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'member': {'type': 'object', 'properties': {}, 'description': 'Dynamic upstream JSON record.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Guidance when results are empty, a page is past the end, or a caveat applies.'}, 'pagination': {'type': 'object', 'required': ['count'], 'properties': {'count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Total result count across all pages.'}, 'nextOffset': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}], 'description': 'Offset to pass for the next page, or null when there are no more pages.'}}, 'description': 'Pagination metadata: total count and next offset.', 'additionalProperties': False}, 'totalCount': {'type': 'number', 'description': 'Total results across all pages.'}, 'effectiveQuery': {'type': 'string', 'description': 'The browse scope and applied filters.'}}, 'additionalProperties': {}}

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

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['effectiveQuery', 'totalCount']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'description': 'Upstream JSON record. Per-tool item shape is rendered in the markdown body.', 'additionalProperties': {}}, 'description': 'Result rows. Per-tool item shape is rendered in the markdown body.'}, 'vote': {'type': 'object', 'properties': {}, 'description': 'Dynamic upstream JSON record.', 'additionalProperties': {}}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['not_found', 'rate_limited', 'invalid_request', 'upstream_error'], 'description': 'Machine-readable failure mode. Declared by this tool: `not_found`: A requested bill, member, committee, report, vote, or nomination does not exist in Congress.gov. `rate_limited`: The Congress.gov API rate limit (5,000 requests/hour per key) was exceeded. `invalid_request`: Congress.gov rejected the request as malformed â\x80\x94 a bad date range or an identifier with an unexpected shape. `upstream_error`: Congress.gov returned an unexpected error (5xx or another non-2xx status). Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Guidance when results are empty, a page is past the end, or a caveat applies.'}, 'pagination': {'type': 'object', 'required': ['count'], 'properties': {'count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Total result count across all pages.'}, 'nextOffset': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}], 'description': 'Offset to pass for the next page, or null when there are no more pages.'}}, 'description': 'Pagination metadata: total count and next offset.', 'additionalProperties': False}, 'totalCount': {'type': 'number', 'description': 'Total results across all pages.'}, 'effectiveQuery': {'type': 'string', 'description': 'The browse scope and applied filters.'}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['operation', 'congress'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 250, 'minimum': 1, 'description': 'Results per page (1-250).'}, 'offset': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Pagination offset.'}, 'ordinal': {'type': 'integer', 'maximum': 9007199254740991, '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 â\x80\x94 use a partitioned form like '851-1' instead).", 'exclusiveMinimum': 0}, 'congress': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Congress number.', 'exclusiveMinimum': 0}, 'operation': {'enum': ['list', 'get', 'nominees', 'actions', 'committees', 'hearings'], 'type': 'string', 'description': 'Which data to retrieve.'}, 'nominationNumber': {'type': 'string', '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."}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['effectiveQuery', 'totalCount']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'properties': {}, 'description': 'Upstream JSON record. Per-tool item shape is rendered in the markdown body.', 'additionalProperties': {}}, 'description': 'Result rows. Per-tool item shape is rendered in the markdown body.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['not_found', 'rate_limited', 'invalid_request', 'upstream_error'], 'description': 'Machine-readable failure mode. Declared by this tool: `not_found`: A requested bill, member, committee, report, vote, or nomination does not exist in Congress.gov. `rate_limited`: The Congress.gov API rate limit (5,000 requests/hour per key) was exceeded. `invalid_request`: Congress.gov rejected the request as malformed â\x80\x94 a bad date range or an identifier with an unexpected shape. `upstream_error`: Congress.gov returned an unexpected error (5xx or another non-2xx status). Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Guidance when results are empty, a page is past the end, or a caveat applies.'}, 'nomination': {'type': 'object', 'properties': {}, 'description': 'Dynamic upstream JSON record.', 'additionalProperties': {}}, 'pagination': {'type': 'object', 'required': ['count'], 'properties': {'count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Total result count across all pages.'}, 'nextOffset': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}], 'description': 'Offset to pass for the next page, or null when there are no more pages.'}}, 'description': 'Pagination metadata: total count and next offset.', 'additionalProperties': False}, 'totalCount': {'type': 'number', 'description': 'Total results across all pages.'}, 'effectiveQuery': {'type': 'string', 'description': 'The browse scope and applied filters.'}}, 'additionalProperties': {}}