{"openapi":"3.0.3","info":{"title":"Gnist Context — US Congress","description":"US congressional bill search, bill details (sponsors, subjects, summaries), member lookup, and recent legislation from Congress.gov — covers all bill types (HR, S, joint/concurrent resolutions) across all congresses.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/congress/`\n- **Toolkit page:** `/toolkits/congress`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/congress/search_bills":{"post":{"tags":["Government"],"summary":"search_bills","description":"Search US congressional bills by keyword.\n\nArgs:\n    query: Search keywords for bill text or title.\n    congress: Congress number (e.g. 118 for the 118th Congress).\n    bill_type: Bill type filter: hr, s, hjres, sjres, hconres, sconres, hres, sres.\n    limit: Maximum results to return (1-250, default 20).\n\nReturns:\n    Dictionary with count and list of matching bills including title, sponsor, and latest action.","operationId":"congress_search_bills","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"query":{"type":"string"},"congress":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null},"bill_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"limit":{"default":20,"type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/congress/get_bill":{"post":{"tags":["Government"],"summary":"get_bill","description":"Get detailed information about a specific US congressional bill.\n\nArgs:\n    congress: Congress number (e.g. 118).\n    bill_type: Bill type: hr, s, hjres, sjres, hconres, sconres, hres, sres.\n    bill_number: Bill number (e.g. \"1\" for H.R. 1).\n\nReturns:\n    Dictionary with full bill details including sponsor, subjects, policy area, and summaries.","operationId":"congress_get_bill","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"congress":{"type":"integer"},"bill_type":{"type":"string"},"bill_number":{"type":"string"}},"required":["congress","bill_type","bill_number"],"type":"object"}}}}}},"/rest/congress/get_recent_bills":{"post":{"tags":["Government"],"summary":"get_recent_bills","description":"Get recently updated bills from a specific congress.\n\nArgs:\n    congress: Congress number (default: 118 for the 118th Congress, 2023-2025).\n    limit: Maximum results to return (1-250, default 20).\n\nReturns:\n    Dictionary with count and list of recently updated bills.","operationId":"congress_get_recent_bills","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"congress":{"default":118,"type":"integer"},"limit":{"default":20,"type":"integer"}},"type":"object"}}}}}},"/rest/congress/search_members":{"post":{"tags":["Government"],"summary":"search_members","description":"Search members of Congress with optional filters.\n\nNote: State, party, and chamber filters are applied client-side after fetching results.\nThe returned count reflects filtered results only. For unfiltered queries, pagination\nworks normally. When filters are active, increase limit for more complete results.\n\nArgs:\n    state: Filter by US state abbreviation (e.g. CA, NY, TX).\n    party: Filter by party name (Democratic, Republican).\n    chamber: Filter by chamber (House of Representatives, Senate).\n    limit: Maximum results to fetch from API before filtering (1-250, default 20).\n\nReturns:\n    Dictionary with count and list of matching members including party, state, and chamber.","operationId":"congress_search_members","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"party":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"chamber":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null},"limit":{"default":20,"type":"integer"}},"type":"object"}}}}}},"/rest/congress/report_feedback":{"post":{"tags":["Government"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"congress_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Government","description":"Data sources: Government"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}