{ "id": "vaquill.us.statutes.search", "object": "tool", "name": "Search US Statutes", "summary": "Search US statutes, regulations, court rules and guidance.", "description": "Hybrid semantic and keyword search across US primary law: the United States Code, the Code of Federal Regulations, all 50 state statutory codes plus DC and Puerto Rico, state administrative codes, court rules, constitutions, the Federal Register, agency guidance and executive actions. Phrase the query the way a lawyer would ask it; `matchType` switches to strict keyword or exact phrase when you need it. Filter by jurisdiction, corpus, title, chapter, part, publisher, year, or status, and use `changedSince` to poll for what moved. Each hit carries its citation, its `actId`, an excerpt, and its currency signals. Set `includeBody` to pull full text inline instead of a second call per hit, and name `fields` to cut a 140-field row down to what you actually read.\n\nRaw vaquill#us/statutes/search endpoint: input is { body, queryParams, pathParams } as the provider documents them (https://www.vaquill.ai/docs/api-reference/us-statutes/search-us-statutes-constitutions-court-rules-and-executive-actions).", "category": "lookup", "hosted_by": "Vaquill", "runtime": "partner", "side_effects": false, "status": "live", "credits": 0, "price": null, "providers": [ { "id": "vaquill", "name": "Vaquill", "price": null, "own_key_only": true } ], "mcp_name": "vaquill_us_statutes_search", "input_schema": { "type": "object", "properties": { "body": { "type": "object", "properties": { "query": { "type": "string", "minLength": 2, "maxLength": 500, "description": "The search query, in natural language. Ranking is hybrid semantic plus keyword, so a question phrased the way a lawyer would ask it works as well as a term of art." }, "corpusType": { "anyOf": [ { "type": "string", "enum": [ "USC", "CFR", "STATE", "CONSTITUTION", "FEDERAL_RULES", "STATE_CONSTITUTION", "STATE_RULES", "EXECUTIVE_ACTION", "REGULATION", "FEDERAL_REGISTER", "FEDERAL_REGISTER_NOTICE", "AGENCY_GUIDANCE", "SENTENCING_GUIDELINES", "US_TAX_TREATY", "STATE_AGENCY_GUIDANCE", "STATE_AG_OPINION", "SESSION_LAW", "STATUTE_COMPILATION", "AGENCY_ADJUDICATION", "CFR_ANNUAL", "USC_ANNUAL" ] }, { "type": "array", "items": { "type": "string", "enum": [ "USC", "CFR", "STATE", "CONSTITUTION", "FEDERAL_RULES", "STATE_CONSTITUTION", "STATE_RULES", "EXECUTIVE_ACTION", "REGULATION", "FEDERAL_REGISTER", "FEDERAL_REGISTER_NOTICE", "AGENCY_GUIDANCE", "SENTENCING_GUIDELINES", "US_TAX_TREATY", "STATE_AGENCY_GUIDANCE", "STATE_AG_OPINION", "SESSION_LAW", "STATUTE_COMPILATION", "AGENCY_ADJUDICATION", "CFR_ANNUAL", "USC_ANNUAL" ] } } ], "description": "Restrict to one body of law, or a list of them. `USC` and `CFR` are the federal code and regulations, `STATE` a state statutory code, `REGULATION` a state administrative code, `STATE_RULES` court rules. Omit to search everything." }, "state": { "anyOf": [ { "type": "string", "enum": [ "federal", "al", "ak", "az", "ar", "ca", "co", "ct", "de", "dc", "fl", "ga", "hi", "id", "il", "in", "ia", "ks", "ky", "la", "me", "md", "ma", "mi", "mn", "ms", "mo", "mt", "ne", "nv", "nh", "nj", "nm", "ny", "nc", "nd", "oh", "ok", "or", "pa", "pr", "ri", "sc", "sd", "tn", "tx", "ut", "vt", "va", "wa", "wv", "wi", "wy" ] }, { "type": "array", "items": { "type": "string", "enum": [ "federal", "al", "ak", "az", "ar", "ca", "co", "ct", "de", "dc", "fl", "ga", "hi", "id", "il", "in", "ia", "ks", "ky", "la", "me", "md", "ma", "mi", "mn", "ms", "mo", "mt", "ne", "nv", "nh", "nj", "nm", "ny", "nc", "nd", "oh", "ok", "or", "pa", "pr", "ri", "sc", "sd", "tn", "tx", "ut", "vt", "va", "wa", "wv", "wi", "wy" ] } } ], "description": "Restrict to one jurisdiction, or a list. `federal` means the federal corpora rather than a state." }, "code": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ], "description": "Restrict to specific state statutory codes, e.g. `tx_pe` for the Texas Penal Code. Values are the `actId`s returned by `/us/statutes/divisions` with `corpusType=STATE`, so a browse result can be fed straight back in." }, "yearFrom": { "type": "integer", "minimum": 1700, "maximum": 2100, "description": "Only return sections dated in or after this year." }, "yearTo": { "type": "integer", "minimum": 1700, "maximum": 2100, "description": "Only return sections dated in or before this year. It filters the LAST such date, so a section amended in 2025 is excluded by `yearTo=2024` even though it existed then." }, "excludeRepealed": { "default": false, "type": "boolean", "description": "Drop sections whose own status says they are no longer operative (repealed, renumbered, transferred, expired, superseded, and the rest of the dead vocabulary). A section carrying NO recorded status is kept, because a missing status is not evidence of repeal." }, "actStatus": { "anyOf": [ { "type": "string", "enum": [ "abolished", "deleted", "expired", "in_force", "inactive", "non_precedential", "not_funded", "not_yet_effective", "omitted", "proposed", "recodified", "recompiled", "rejected", "relocated", "removed", "renumbered", "repealed", "rescinded", "reserved", "revoked", "superseded", "terminated", "transferred", "unconstitutional", "vacant", "vacated", "vetoed", "withdrawn" ] }, { "type": "array", "items": { "type": "string", "enum": [ "abolished", "deleted", "expired", "in_force", "inactive", "non_precedential", "not_funded", "not_yet_effective", "omitted", "proposed", "recodified", "recompiled", "rejected", "relocated", "removed", "renumbered", "repealed", "rescinded", "reserved", "revoked", "superseded", "terminated", "transferred", "unconstitutional", "vacant", "vacated", "vetoed", "withdrawn" ] } } ], "description": "Return only sections carrying this status. The inverse of `excludeRepealed`, and the way to audit dead law on purpose." }, "changedSince": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", "description": "Only return sections we have OBSERVED change on or after this date (`YYYY-MM-DD`). This is the sync filter: it turns a lookup into something a nightly job can poll." }, "agency": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ], "description": "Federal Register agency slug, e.g. `environmental-protection-agency`. Applies to `FEDERAL_REGISTER` and `EXECUTIVE_ACTION`; other corpora carry no agency." }, "documentType": { "type": "string", "enum": [ "final", "proposed", "presidential" ], "description": "Federal Register document stage: `final` is a rule in force, `proposed` an NPRM, `presidential` a Presidential Document." }, "publishedFrom": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", "description": "Only return Federal Register documents published on or after this date. This is the PUBLICATION date, not `yearFrom`'s version year." }, "publishedTo": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$", "description": "Only return Federal Register documents published on or before this date." }, "titleNumber": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991, "description": "USC or CFR title number, e.g. 17 for securities, 42 for civil rights. Only meaningful for `USC` and `CFR`; state titles are alphabetic." }, "chapter": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ], "description": "Scope to one or more chapters within a title or code. This is the search side of each hit's `parent.chapter`, so a hit can be passed straight back to search its neighbourhood." }, "part": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ], "description": "Scope to one or more CFR parts, e.g. `240` for 17 C.F.R. Part 240. The CFR counterpart to `chapter`; pair it with `titleNumber`." }, "source": { "anyOf": [ { "type": "string", "enum": [ "administrative_guidance", "ag_precedent", "agency_guidance", "bia_precedent", "bis_advisory_opinion", "cfpb_circular", "cfpb_enforcement_action", "cfpb_supervisory_guidance", "cftc_staff_letter", "cms_iom", "copyright_circular", "copyright_compendium", "cpsc_advisory_opinion", "cpsc_secg", "ddtc_commodity_jurisdiction", "ddtc_guidance", "dfars", "dfars_pgi", "doe_appliance_guidance", "doj_business_review", "doj_justice_manual", "doj_leniency", "eeoc_guidance", "far", "fcc_declaratory_ruling", "fdic_fil", "ferc_policy_statement", "fincen_amla_material", "fincen_boi_compliance_guide", "fincen_boi_faq", "fincen_boi_rule_qa", "fincen_guidance", "fincen_ruling", "frap", "frb_sr_letter", "frbp", "frcp", "frcrp", "fre", "ftc_administrative_decision", "ftc_advisory_opinion", "ftc_advocacy_filing", "ftc_hsr_interpretation", "ftc_policy_statement", "hhs_ocr_hipaa_faq", "hhs_ocr_hipaa_guidance", "hhs_ocr_resolution_agreement", "immigration_admin_precedent", "irs_announcement", "irs_irm", "irs_notice", "irs_rev_proc", "irs_rev_rul", "irs_written_determination", "merger_guidelines", "mpep", "mspb_nonprecedential", "mspb_precedential", "nlrb_advice_memo", "nlrb_board_decision", "nlrb_gc_memo", "occ_bulletin", "occ_interpretive_letter", "ofac_faq", "olc_opinion", "sct", "sec_commission_opinion", "senate_treaty", "senate_treaty_document", "senate_treaty_resolution", "ssa_ruling", "state_financial_bulletin", "state_insurance_bulletin", "tmep", "us_tax_treaty", "us_tax_treaty_technical_explanation", "uscis_policy_manual", "whd_foh", "whd_opinion_letter" ] }, { "type": "array", "items": { "type": "string", "enum": [ "administrative_guidance", "ag_precedent", "agency_guidance", "bia_precedent", "bis_advisory_opinion", "cfpb_circular", "cfpb_enforcement_action", "cfpb_supervisory_guidance", "cftc_staff_letter", "cms_iom", "copyright_circular", "copyright_compendium", "cpsc_advisory_opinion", "cpsc_secg", "ddtc_commodity_jurisdiction", "ddtc_guidance", "dfars", "dfars_pgi", "doe_appliance_guidance", "doj_business_review", "doj_justice_manual", "doj_leniency", "eeoc_guidance", "far", "fcc_declaratory_ruling", "fdic_fil", "ferc_policy_statement", "fincen_amla_material", "fincen_boi_compliance_guide", "fincen_boi_faq", "fincen_boi_rule_qa", "fincen_guidance", "fincen_ruling", "frap", "frb_sr_letter", "frbp", "frcp", "frcrp", "fre", "ftc_administrative_decision", "ftc_advisory_opinion", "ftc_advocacy_filing", "ftc_hsr_interpretation", "ftc_policy_statement", "hhs_ocr_hipaa_faq", "hhs_ocr_hipaa_guidance", "hhs_ocr_resolution_agreement", "immigration_admin_precedent", "irs_announcement", "irs_irm", "irs_notice", "irs_rev_proc", "irs_rev_rul", "irs_written_determination", "merger_guidelines", "mpep", "mspb_nonprecedential", "mspb_precedential", "nlrb_advice_memo", "nlrb_board_decision", "nlrb_gc_memo", "occ_bulletin", "occ_interpretive_letter", "ofac_faq", "olc_opinion", "sct", "sec_commission_opinion", "senate_treaty", "senate_treaty_document", "senate_treaty_resolution", "ssa_ruling", "state_financial_bulletin", "state_insurance_bulletin", "tmep", "us_tax_treaty", "us_tax_treaty_technical_explanation", "uscis_policy_manual", "whd_foh", "whd_opinion_letter" ] } } ], "description": "Restrict to a publisher within a corpus, e.g. `irs_rev_rul` for IRS revenue rulings or `frcp` for the Federal Rules of Civil Procedure." }, "fields": { "type": "array", "items": { "type": "string", "enum": [ "abstract", "actId", "actStatus", "action", "adoptingCitations", "agencies", "agencySlugs", "alternateCitations", "amendmentHistory", "amendmentNote", "amendmentYears", "amendmentsCount", "articleName", "articleNumber", "audience", "body", "breadcrumb", "caseName", "chapter", "chapterName", "citation", "citationShort", "committeeNote", "corpusType", "court", "crossReferencesCfr", "crossReferencesUsc", "currencyNote", "currencyYear", "currentThrough", "datesText", "displayLabel", "displayPath", "documentNumber", "documentSubtype", "documentTypeLabel", "docxUrl", "edition", "effectiveDate", "effectiveDateRaw", "excerpt", "expirationDate", "expirationDateRaw", "externalUrl", "federalRegisterCitations", "forum", "frCommentsCloseOn", "frCorrectionOf", "frCorrections", "frDocketIds", "frEffectiveOn", "frEndPage", "frRegulationIdNumbers", "frRegulationsDotGovUrl", "frRelatedDocuments", "frSignificant", "frStartPage", "frVolume", "goodLawStatus", "govInfoHtmlUrl", "govInfoPdfUrl", "granuleId", "history", "htmlUrl", "implementingRegulations", "issueDate", "issueDateRaw", "issuingAgency", "languageCode", "lastAmendedDate", "lastAmendedYear", "lawImplemented", "licenseNote", "originalEnactmentDate", "originalEnactmentDateRaw", "packageId", "parent", "part", "partName", "pdfUrl", "popularName", "president", "priorEffectiveDates", "program", "publicLawCites", "publicLaws", "publicationDate", "publisherKey", "referencedShortTitles", "relatedCitations", "relatedDocuments", "releaseDate", "relevanceScore", "renumberedTo", "renumberedToLabel", "requesters", "rescindedOn", "rescindedOnRaw", "reviewDate", "ruleSet", "ruleSetCode", "sectionNumber", "sectionTitle", "settlementAmount", "signingDate", "signingDateRaw", "source", "sourceCharEnd", "sourceCharStart", "sourceCredit", "sourceNote", "sourcePageEnd", "sourcePageStart", "state", "stateHtmlUrl", "statutoryAuthority", "subchapter", "subchapterName", "subject", "subjectNumber", "subpart", "subpartName", "subtitle", "subtitleName", "supersededBy", "supersedes", "supersessionActions", "textUrl", "title", "titleName", "titleNumber", "topLevelTitle", "topics", "transferredTo", "transferredToLabel", "versionId", "volume", "wordCount", "xmlUrl", "year" ] }, "description": "Return only these fields on each hit. A row spans 140 fields and most are null for any one corpus, so naming what you need is the difference between a 200 KB page and a 4 KB one. Costs the same either way." }, "limit": { "default": 10, "type": "integer", "minimum": 1, "maximum": 50, "description": "Results per page." }, "offset": { "default": 0, "type": "integer", "minimum": 0, "maximum": 70, "description": "How many results to skip, for paging. Every page of a query is cut from one ranking, so results never repeat or go missing between pages, and a later page costs no more than the first." }, "includeBody": { "default": false, "type": "boolean", "description": "Return each hit's full text inline on `body` instead of fetching it per section afterwards. Adds the ordinary body price per row that returns text; rows whose text cannot be resolved come back null and are not charged." }, "excerptChars": { "default": 500, "type": "integer", "minimum": 100, "maximum": 4000, "description": "Characters of matching text to include in each hit's `excerpt`. The excerpt is a ranking preview, not the section." }, "matchType": { "default": "any", "type": "string", "enum": [ "any", "all", "phrase" ], "description": "Exact versus semantic matching, so no separate keyword mode is needed. `any` is hybrid ranking and suits natural-language questions; `all` requires every term; `phrase` requires the exact phrase." } }, "required": [ "query" ] } }, "required": [ "body" ], "additionalProperties": false }, "kind": "endpoint" }