{"openapi":"3.1.0","info":{"title":"GovInfo (BYOK) API","version":"0.1.0","description":"GovInfo (BYOK) lets an AI assistant read your own GovInfo data through the GovInfo API with a key you supply (api.data.gov API key for GovInfo). Read-only: 7 tools (list_collections, list_collection_updates, list_published_packages, get_package_summary, list_package_granules, get_granule_summary, get_related_documents). The BYOK key travels with each request, is used for that one call only and is...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-govinfo.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-govinfo/docs"},"termsOfService":"https://connectorbay.com/byok-govinfo/terms"},"servers":[{"url":"https://byok-govinfo.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-govinfo/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_collections":{"post":{"operationId":"list_collections","summary":"List the GovInfo collections with their code, name and package and granule counts. Use for \"Which collections does GovIn","description":"List the GovInfo collections with their code, name and package and granule counts. Use for \"Which collections does GovInfo have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_collectionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_collection_updates":{"post":{"operationId":"list_collection_updates","summary":"List packages of one collection added or modified since a date and time, with package id, last-modified time and summary","description":"List packages of one collection added or modified since a date and time, with package id, last-modified time and summary link. Pages by cursor. Use for \"Which congressional bill packages were added to GovInfo since 2026-01-01\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"collection":{"description":"Collection code, for example BILLS (congressional bills), FR (Federal Register), CREC (Congressional Record) or USCOURTS; list_collections shows all codes.","maxLength":30,"title":"Collection","type":"string"},"modified_since":{"description":"Start of the window as an ISO 8601 UTC time, for example 2026-01-01T00:00:00Z.","maxLength":25,"title":"Modified Since","type":"string"},"offset_mark":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":"*","description":"Paging cursor: * for the first page, then the offsetMark value found in the nextPage link of the previous answer.","title":"Offset Mark"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Records per page, 1 to 1000.","title":"Page Size"}},"required":["collection","modified_since"],"title":"list_collection_updatesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_published_packages":{"post":{"operationId":"list_published_packages","summary":"List packages issued between two dates (by official issue date) in one or more collections, with package id and summary ","description":"List packages issued between two dates (by official issue date) in one or more collections, with package id and summary link. Pages by cursor. Use for \"Which Federal Register issues were published in March 2026\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start_date":{"description":"Earliest issue date, YYYY-MM-DD.","maxLength":10,"title":"Start Date","type":"string"},"end_date":{"description":"Latest issue date, YYYY-MM-DD.","maxLength":10,"title":"End Date","type":"string"},"collection":{"description":"Comma-separated collection codes, for example FR or BILLS,CFR.","maxLength":120,"title":"Collection","type":"string"},"doc_class":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":null,"description":"Filter by the collection's document class (for bills the bill type such as hr or s; for the Congressional Record the section).","title":"Doc Class"},"congress":{"anyOf":[{"maxLength":4,"type":"string"},{"type":"null"}],"default":null,"description":"Congress number, for example 119.","title":"Congress"},"modified_since":{"anyOf":[{"maxLength":25,"type":"string"},{"type":"null"}],"default":null,"description":"Only packages modified since this ISO 8601 UTC time, for example 2026-01-01T00:00:00Z.","title":"Modified Since"},"offset_mark":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":"*","description":"Paging cursor: * for the first page, then the offsetMark value found in the nextPage link of the previous answer.","title":"Offset Mark"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Records per page, 1 to 1000.","title":"Page Size"}},"required":["start_date","end_date","collection"],"title":"list_published_packagesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_package_summary":{"post":{"operationId":"get_package_summary","summary":"Get the summary of one GovInfo package: title, collection, issue date, category, last-modified time, links to its text, ","description":"Get the summary of one GovInfo package: title, collection, issue date, category, last-modified time, links to its text, PDF, XML and metadata, and collection-specific fields such as congress and bill number. Use for \"Summarize package BILLS-115hr1625enr\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"package_id":{"description":"GovInfo package id, for example BILLS-115hr1625enr or FR-2018-04-12 (as returned by the listing tools).","maxLength":120,"title":"Package Id","type":"string"}},"required":["package_id"],"title":"get_package_summaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_package_granules":{"post":{"operationId":"list_package_granules","summary":"List the granules (parts such as individual Federal Register documents or Congressional Record articles) of a package, w","description":"List the granules (parts such as individual Federal Register documents or Congressional Record articles) of a package, with title, granule id and summary link. Pages by cursor. Use for \"List the documents inside Federal Register issue FR-2018-04-12\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"package_id":{"description":"GovInfo package id of a package that has granules, for example FR-2018-04-12.","maxLength":120,"title":"Package Id","type":"string"},"offset_mark":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":"*","description":"Paging cursor: * for the first page, then the offsetMark value found in the nextPage link of the previous answer.","title":"Offset Mark"},"page_size":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Records per page, 1 to 1000.","title":"Page Size"}},"required":["package_id"],"title":"list_package_granulesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_granule_summary":{"post":{"operationId":"get_granule_summary","summary":"Get the summary of one granule: title, issuing agencies, class, issue date, last-modified time and links to its text, PD","description":"Get the summary of one granule: title, issuing agencies, class, issue date, last-modified time and links to its text, PDF and metadata. Use for \"Summarize Federal Register document 2018-07777\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"package_id":{"description":"GovInfo package id, for example FR-2018-04-12.","maxLength":120,"title":"Package Id","type":"string"},"granule_id":{"description":"Granule id from list_package_granules, for example 2018-07777.","maxLength":120,"title":"Granule Id","type":"string"}},"required":["package_id","granule_id"],"title":"get_granule_summaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_related_documents":{"post":{"operationId":"get_related_documents","summary":"List the relationships of a GovInfo document (for a bill: its versions, history, public law, reports, U.S. Code and Stat","description":"List the relationships of a GovInfo document (for a bill: its versions, history, public law, reports, U.S. Code and Statutes references; for a Federal Register document: related documents and CFR citations). Use for \"What is related to bill BILLS-116hr748enr\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"access_id":{"description":"Package or granule id, for example BILLS-116hr748enr.","maxLength":120,"title":"Access Id","type":"string"}},"required":["access_id"],"title":"get_related_documentsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}