Vaquill
Search US and Indian statutes, regulations, constitutions, and court rules.
我該用這個嗎
品質與安全性
A
發現項目（2）
- LOWTool 'resolve_statute_citations_batch' name length outside 3-30 range在 resolve_statute_citations_batch 中
- LOWTool 'fetch' suggests web access but openWorldHint=false在 fetch 中
根據工具定義與協定合規性的自動化分析。
上下文成本
~10,249Token（工具定義）
~5.1 KB典型回應大小
顯著的注意力影響（128k 上下文的 8.01%）
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"vaquill-mcp": {
"url": "https://mcp.vaquill.ai/s/_"
}
}
}遠端端點
https://mcp.vaquill.ai/s/_streamable-httphttps://mcp.vaquill.ai/in/s/_streamable-http它能做什麼
工具清單
工具（18）
🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟢count_statute_sections(corpusType, state, code, article, titleNumber, ...)
Exact section count for a jurisdiction, corpus, code, title, chapter or part. Use when sizing a job before walking divisions and fetching sections. This counts a scope, not search matches. There is no query parameter, because search ranks within a bounded window and cannot give an exact total of matching sections. A zero count may indicate a wrong filter. Cost: 1 credit.
輸入結構描述
{
"type": "object",
"properties": {
"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"
]
},
{
"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"
]
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Corpus to count, single or list. Omit to count every corpus.",
"examples": [
"REGULATION"
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"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": "Two-letter jurisdiction code or `federal`, single or list.",
"examples": [
"tx"
]
},
"code": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "State code identifier, e.g. `tx_26`. With `corpusType=FEDERAL_RULES`, a rule set instead (`frcp`, `uscapp_t28a_fre`). Same values and checks as `code` on `/search`.",
"examples": [
"tx_26"
]
},
"article": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Article label (`Amendment XIV`) on CONSTITUTION / STATE_CONSTITUTION, or article number (`2-A`) on a STATE / REGULATION code divided by article. Same values and pairing rules as `article` on `/search`.",
"examples": [
"Amendment XIV"
]
},
"titleNumber": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "USC or CFR title number.",
"examples": [
42
]
},
"chapter": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Chapter identifier. Pair with `titleNumber` or `code`.",
"examples": [
"554"
]
},
"part": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "CFR part identifier. Pair with `titleNumber`.",
"examples": [
"240"
]
},
"actStatus": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Count only sections carrying this status.",
"examples": [
"repealed"
]
},
"excludeRepealed": {
"type": "boolean",
"description": "Only sections with an affirmatively dead status are excluded. Sections with no recorded status are kept. US Code uses a stored annual edition, so sections repealed after that edition closed are still counted.",
"default": false,
"examples": [
true
]
}
},
"required": []
}輸出結構描述
{
"type": "object",
"additionalProperties": true
}🟢fetch(id)
Fetch the full text of one US law section by the `id` from a `search` result, returning `{id, title, text, url, metadata}`. Also accepts a citation URL, a bare path, or a Bluebook citation such as '42 U.S.C. 1983'. Present for clients that require the standard search/fetch pair; prefer `get_us_statute_section_text` if available. Charged as a section lookup plus a body read.
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"additionalProperties": true
}🟢get_credit_balance
The credits this API key can spend now, calculated from live credit buckets under the same expiry rules used for billing. Use for pre-flight checks or low-balance alerts. creditsRemaining is a spendable balance, not a cached estimate. Any valid API key works without a particular scope, and normal rate limits still apply. Free.
輸入結構描述
{
"type": "object",
"properties": {},
"required": []
}輸出結構描述
{
"type": "object",
"additionalProperties": true
}🟢get_pricing(region)
Current API credit pricing: per-endpoint credit costs and the credit-to-currency conversion rate (1 credit = $0.01 USD). Free, and no authentication required. Use to check what a call will cost before making it.
輸入結構描述
{
"type": "object",
"properties": {
"region": {
"anyOf": [
{
"type": "string",
"enum": [
"US",
"IN"
]
},
{
"type": "null"
}
],
"description": "Defaults to the jurisdiction of the documentation you are reading. If omitted, returns pricing only for that jurisdiction's endpoints, not prices across jurisdictions."
}
},
"required": []
}輸出結構描述
{
"type": "object",
"additionalProperties": true
}🟢get_section_changes(act_id, limit, sinceId, beforeId, changeKind, ...)
What our refreshes have observed changing on one section over time: when it was added, amended or removed, newest first. This is our capture history, not the publisher's -- an empty list means we recorded no change, never that the section was never amended. For the publisher's own history, read amendmentHistory on the section. Cost: 1 credit.
輸入結構描述
{
"type": "object",
"properties": {
"act_id": {
"type": "string",
"maxLength": 200,
"minLength": 3,
"description": "Section identifier, e.g. `USC_T42_C21_S1983` (Title 42, Chapter 21, Section 1983, written 42 U.S.C. 1983). Take it from a search result rather than assembling it: the title and section are derivable from a citation but the CHAPTER is not, so hand-built ids usually 404.",
"examples": [
"CFR_T21_P314_S314_50"
]
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Max changes to return on this page.",
"default": 50,
"examples": [
50
]
},
"sinceId": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Return only changes with an `id` greater than this: the cursor for polling forward into new changes. Ids are a monotonic sequence, so this is exact, immune to clock skew, and cannot drop two changes that share a timestamp. Carry `cursor` forward."
},
"beforeId": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Return only changes with an `id` less than this: the cursor for walking BACK through history, which is what a newest-first reader needs. Pass the smallest `id` on your last page."
},
"changeKind": {
"anyOf": [
{
"items": {
"type": "string",
"enum": [
"added",
"amended",
"removed"
]
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Filter to these kinds. Repeat the parameter to pass several (`?changeKind=amended&changeKind=removed`). Omit for all three."
},
"order": {
"type": "string",
"enum": [
"asc",
"desc"
],
"description": "`desc` (default) is newest first, the natural reading order for a history. Use `asc` to replay a section's life forward, or when catching up from a cursor.",
"default": "desc"
}
},
"required": [
"act_id"
]
}輸出結構描述
{
"type": "object",
"additionalProperties": true
}🟢get_section_cited_by(act_id, limit)
The USC and CFR sections whose text cross-references a given section: the inverse of the crossReferences already returned on a section lookup. Use to find where a definition or requirement is actually invoked, or to gauge how load-bearing a provision is across the code. Cost: 2 credits.
輸入結構描述
{
"type": "object",
"properties": {
"act_id": {
"type": "string",
"maxLength": 200,
"minLength": 3,
"description": "Section identifier, e.g. `USC_T42_C21_S1983` (Title 42, Chapter 21, Section 1983, written 42 U.S.C. 1983). Take it from a search result rather than assembling it: the title and section are derivable from a citation but the CHAPTER is not, so hand-built ids usually 404.",
"examples": [
"USC_T42_C21_S1983"
]
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Maximum citing sections to return.",
"default": 25,
"examples": [
25
]
}
},
"required": [
"act_id"
]
}輸出結構描述
{
"type": "object",
"additionalProperties": true
}🟢get_section_cross_state(act_id, limit)
Provisions in OTHER states that address the same subject as a given state statute section, ranked by similarity. State statutes only. Use for fifty-state surveys, multi-jurisdiction compliance, or to check whether a client's home-state rule is typical or an outlier. Cost: 6 credits.
輸入結構描述
{
"type": "object",
"properties": {
"act_id": {
"type": "string",
"maxLength": 200,
"minLength": 3,
"description": "Section identifier, e.g. `USC_T42_C21_S1983` (Title 42, Chapter 21, Section 1983, written 42 U.S.C. 1983). Take it from a search result rather than assembling it: the title and section are derivable from a citation but the CHAPTER is not, so hand-built ids usually 404.",
"examples": [
"USC_T42_C21_S1983"
]
},
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1,
"description": "Maximum states to return, one provision each.",
"default": 5,
"examples": [
5
]
}
},
"required": [
"act_id"
]
}輸出結構描述
{
"type": "object",
"additionalProperties": true
}🟢get_section_definitions(act_id)
The term definitions that govern a section, parsed from its chapter's definitions section. Use whenever a provision turns on a term of art ('covered entity', 'security', 'employer') and you need the statute's own definition rather than the ordinary meaning. Cost: 4 credits.
輸入結構描述
{
"type": "object",
"properties": {
"act_id": {
"type": "string",
"maxLength": 200,
"minLength": 3,
"description": "Section identifier, e.g. `USC_T42_C21_S1983` (Title 42, Chapter 21, Section 1983, written 42 U.S.C. 1983). Take it from a search result rather than assembling it: the title and section are derivable from a citation but the CHAPTER is not, so hand-built ids usually 404.",
"examples": [
"USC_T42_C21_S1983"
]
}
},
"required": [
"act_id"
]
}輸出結構描述
{
"type": "object",
"additionalProperties": true
}🟢get_section_neighbors(act_id, limit)
The sections immediately before and after a given section within its own chapter or code, in statutory order. Use to read a provision in context, to find a definitions or penalties sibling, or to check whether the operative language continues into the next section. Cost: 2 credits.
輸入結構描述
{
"type": "object",
"properties": {
"act_id": {
"type": "string",
"maxLength": 200,
"minLength": 3,
"description": "Section identifier, e.g. `USC_T42_C21_S1983` (Title 42, Chapter 21, Section 1983, written 42 U.S.C. 1983). Take it from a search result rather than assembling it: the title and section are derivable from a citation but the CHAPTER is not, so hand-built ids usually 404.",
"examples": [
"USC_T42_C21_S1983"
]
},
"limit": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "How many sections to return on EACH side.",
"default": 3,
"examples": [
3
]
}
},
"required": [
"act_id"
]
}輸出結構描述
{
"type": "object",
"additionalProperties": true
}🟢get_sections_batch(actIds, includeBody)
Metadata for up to 50 sections in one call, by a list of act_ids. Same fields as get_us_statute_section. Use instead of looping that tool when you already hold several act_ids, for example every result of one search. Sections that are not found are skipped and not charged. Cost: 2 credits.
輸入結構描述
{
"type": "object",
"properties": {
"actIds": {
"items": {
"type": "string"
},
"type": "array",
"maxItems": 50,
"minItems": 1,
"description": "Section identifiers from a prior search, up to 50 per call. Duplicates are collapsed and order is preserved. DO NOT BUILD THESE FROM A CITATION: the chapter/article segments exist only in the data, so assembled ids miss. To start from a citation, use resolve_statute_citation.",
"examples": [
[
"USC_T42_C21_S1983",
"CFR_T17_P240_S240_10b5_1"
]
]
},
"includeBody": {
"type": "boolean",
"description": "Adds the ordinary body price for each row that returns text. Unresolved text returns `body: null` with no body charge. Use `creditsConsumed` for the total rather than calculating from the number of IDs.",
"default": false,
"examples": [
true
]
}
},
"required": [
"actIds"
]
}輸出結構描述
{
"type": "object",
"additionalProperties": true
}🟢get_us_statute_section(act_id)
Metadata for one US statute, regulation or rule section by act_id: citation, title hierarchy, breadcrumb, amendment history, and links to HTML, PDF and XML. Does NOT include the section text -- use get_us_statute_section_text for that. Good for confirming you have the right section before paying for its full body. Cost: 2 credits.
輸入結構描述
{
"type": "object",
"properties": {
"act_id": {
"type": "string",
"maxLength": 200,
"minLength": 3,
"description": "Section identifier, e.g. `USC_T42_C21_S1983` (Title 42, Chapter 21, Section 1983, written 42 U.S.C. 1983). Take it from a search result rather than assembling it: the title and section are derivable from a citation but the CHAPTER is not, so hand-built ids usually 404.",
"examples": [
"USC_T42_C21_S1983"
]
}
},
"required": [
"act_id"
]
}輸出結構描述
{
"type": "object",
"additionalProperties": true
}🟢get_us_statute_section_text(act_id, format, structured, asOf)
The full text of a US statute, regulation or rule section by act_id. Returns styled HTML (with cross-references and paragraph numbering as officially published) and plain text. Use when you need the actual statutory language to quote, draft against, or analyze rather than just cite. Cost: 6 credits.
輸入結構描述
{
"type": "object",
"properties": {
"act_id": {
"type": "string",
"maxLength": 200,
"minLength": 3,
"description": "Section identifier, e.g. `USC_T42_C21_S1983` (Title 42, Chapter 21, Section 1983, written 42 U.S.C. 1983). Take it from a search result rather than assembling it: the title and section are derivable from a citation but the CHAPTER is not, so hand-built ids usually 404.",
"examples": [
"CFR_T17_P240_S240_10b5_1"
]
},
"format": {
"type": "string",
"enum": [
"both",
"html",
"plain",
"content",
"operative"
],
"description": "Which representations to return. The default `both` carries a long section's text twice, so `plain` or `html` roughly halves the payload at the same price. `content` and `operative` return only the operative text, about 1 KB instead of 30 KB on a long section, but ONLY United States Code sections can be split: on any other corpus they return no text, so check for null.",
"default": "both",
"examples": [
"operative"
]
},
"structured": {
"type": "boolean",
"description": "When true, also return `markdown` and a `subsections` tree parsed from the text for pincite addressing. Same cost.",
"default": false,
"examples": [
true
]
},
"asOf": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
],
"format": "date",
"description": "Text as it stood on this date (`YYYY-MM-DD`), same cost. A RECONSTRUCTION from observed changes, not an archive: read the response's `asOf.isBounded` before citing it, since false means the answer is limited by when capture began, not by the law. A section we cannot rebuild returns `source: \"unavailable\"` and is refunded.",
"examples": [
"2026-01-15"
]
}
},
"required": [
"act_id"
]
}輸出結構描述
{
"type": "object",
"additionalProperties": true
}🟢list_statute_divisions(corpusType, state, titleNumber, code, chapter, ...)
Walk the statutory hierarchy: list the child divisions (titles, chapters, parts, or sections) under any level, in statutory order. Use to browse a code structurally when you do not yet know the section number, or to enumerate everything under a chapter. Cost: 1 credit.
輸入結構描述
{
"type": "object",
"properties": {
"corpusType": {
"type": "string",
"enum": [
"USC",
"CFR",
"STATE",
"REGULATION",
"CONSTITUTION",
"STATE_CONSTITUTION",
"FEDERAL_RULES"
],
"description": "Corpus to browse. Case-insensitive. The browsable subset of the `corpusType` tokens on `/us/statutes/coverage`.",
"examples": [
"USC"
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"enum": [
"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": "2-letter jurisdiction code, required for the state-scoped corpora (STATE, REGULATION, STATE_CONSTITUTION). Case-insensitive.",
"examples": [
"tx"
]
},
"titleNumber": {
"anyOf": [
{
"type": "integer",
"minimum": 1
},
{
"type": "null"
}
],
"description": "USC/CFR title number to drill into.",
"examples": [
42
]
},
"code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Code to drill into: a state code such as `tx_pe` (list them with `corpusType=STATE&state=<state>`), or a federal rule set such as `frcp` (list them with `corpusType=FEDERAL_RULES`).",
"examples": [
"tx_pe"
]
},
"chapter": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Chapter identifier to drill into (USC and state codes). Accepted alongside `part` on CFR, where it is not needed: part numbers are unique within a title.",
"examples": [
"21"
]
},
"part": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Part identifier to drill into (CFR).",
"examples": [
"240"
]
},
"article": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Article to drill into: a constitution's article or amendment (`Article III`, `Amendment XIV`), or the article of a state code that is divided by articles rather than chapters (New York, where the listing's `kind` is `article`). Pass the `identifier` exactly as the listing returned it.",
"examples": [
"Article III"
]
},
"excludeRepealed": {
"type": "boolean",
"description": "Only sections with an affirmatively dead status, including repealed, superseded or renumbered, are excluded. Sections with no recorded status are kept, not treated as repealed.",
"default": false
},
"actStatus": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "List only sections carrying this status, e.g. `repealed`. The inverse of `excludeRepealed`, and useful for auditing what a container holds that is no longer operative."
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Resume token from a previous response's `nextCursor`. Only meaningful at the level that lists sections. Omit it to start at the beginning of the container."
}
},
"required": [
"corpusType"
]
}輸出結構描述
{
"type": "object",
"additionalProperties": true
}🟢list_statutes_coverage
Self-describing coverage matrix: every corpusType we hold and its per-jurisdiction section counts. Use before answering a jurisdiction question to check whether we actually cover that state and that body of law, so you can say so instead of searching a corpus that does not exist. Free.
輸入結構描述
{
"type": "object",
"properties": {},
"required": []
}輸出結構描述
{
"type": "object",
"additionalProperties": true
}🟢resolve_statute_citation(cite, state, corpusType)
Resolve a Bluebook citation string ('42 U.S.C. 1983', '16 C.F.R. 444.1', 'Cal. Code Regs. tit. 22, 76227') to the exact section, confirmed, with an official source link and the act_id. Use this whenever the user gives you a citation rather than a question -- it is far more reliable than searching for the citation text. Cost: 2 credits.
輸入結構描述
{
"type": "object",
"properties": {
"cite": {
"type": "string",
"maxLength": 200,
"minLength": 2,
"description": "A Bluebook citation string, e.g. '42 U.S.C. 1983' or '16 C.F.R. 444.1'.",
"examples": [
"42 U.S.C. 1983"
]
},
"state": {
"anyOf": [
{
"type": "string",
"maxLength": 2,
"minLength": 2
},
{
"type": "null"
}
],
"enum": [
"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": "Optional 2-letter jurisdiction to resolve WITHIN, e.g. `tx`. Some citation forms are shared: `8 CCR 1206-2` is Colorado and `22 CCR 76227` is California. A constraint, not a hint: a citation naming a different jurisdiction returns `resolved: false` rather than being forced into this one.",
"examples": [
"tx"
]
},
"corpusType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"enum": [
"CONSTITUTION",
"REGULATION",
"STATE",
"STATE_CONSTITUTION",
"STATE_RULES"
],
"description": "Optional corpus to resolve WITHIN: `STATE`, `REGULATION`, `STATE_RULES`, `CONSTITUTION`, `STATE_CONSTITUTION`. Narrows a citation whose form several corpora share; like `state`, a citation belonging to another corpus resolves to nothing instead.",
"examples": [
"REGULATION"
]
}
},
"required": [
"cite"
]
}輸出結構描述
{
"type": "object",
"additionalProperties": true
}🟢resolve_statute_citations_batch(citations, state, corpusType)
Resolve up to 50 Bluebook citations in one call, returning the same confirmed section, official source link and act_id as the single-citation tool. Use when a document or answer cites several provisions: one call is far cheaper in both credits and latency than looping the single-citation tool. Cost: 2 credits.
輸入結構描述
{
"type": "object",
"properties": {
"citations": {
"items": {
"type": "string"
},
"type": "array",
"maxItems": 500,
"minItems": 1,
"description": "Bluebook citation strings, up to 50 per call. Duplicates are collapsed and order preserved, so `results` lines up with the de-duplicated input. Priced PER CITATION at the single-resolve rate: batching is a round-trip and latency win, not a discount.",
"examples": [
[
"42 U.S.C. 1983",
"16 C.F.R. 444.1",
"Cal. Civ. Code 1950.5"
]
]
},
"state": {
"anyOf": [
{
"type": "string",
"maxLength": 2,
"minLength": 2
},
{
"type": "null"
}
],
"enum": [
"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": "Optional two-letter jurisdiction to resolve every citation WITHIN. Applies to the whole batch: a batch spanning jurisdictions should omit it and let each citation name its own. Same semantics as the single-citation route -- a constraint, not a hint.",
"examples": [
"ca"
]
},
"corpusType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"enum": [
"CONSTITUTION",
"REGULATION",
"STATE",
"STATE_CONSTITUTION",
"STATE_RULES"
],
"description": "Restricts every citation to one corpus: `STATE`, `REGULATION`, `STATE_RULES`, `CONSTITUTION`, `STATE_CONSTITUTION`. `STATE` covers federal and state statutes, and the two constitution values are synonyms here, with `state` distinguishing the jurisdiction.",
"examples": [
"REGULATION"
]
}
},
"required": [
"citations"
]
}輸出結構描述
{
"type": "object",
"additionalProperties": true
}🟢search(query)
Generic corpus search over US primary law, returning `{id, title, url}` records for citation. Present so this server works in clients that require the standard search/fetch pair. If you can call `search_us_statutes`, prefer it: it filters by jurisdiction, corpus, date and status, which this cannot. Pair with `fetch` to read a result.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string"
}
},
"required": [
"query"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"additionalProperties": {
"items": {
"additionalProperties": {
"type": "string"
},
"type": "object"
},
"type": "array"
}
}🟢search_us_statutes(query, corpusType, state, code, article, ...)
Semantic + keyword search across US primary law: the United States Code (USC), the Code of Federal Regulations (CFR), and all 50 states' statutes, regulations, constitutions and court rules. Use for any 'what does the law say' question. Filter by corpusType and titleNumber. Returns sections with citation, hierarchy and official source links. The returned act_id (e.g. 'USC_T42_C21_S1983') feeds every other statute tool -- do not hand-build one, they usually 404. Cost: 4 credits.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 500,
"minLength": 2,
"description": "Search query in natural language.",
"examples": [
"insider trading penalties"
]
},
"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"
]
},
{
"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"
]
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Restrict to one corpus, or several as a list. Federal: `USC`, `USC_ANNUAL` (published past editions), `CFR`, `CFR_ANNUAL` (same, superseded by construction), `CONSTITUTION`, `FEDERAL_RULES`, `FEDERAL_REGISTER`, `FEDERAL_REGISTER_NOTICE` (a curated slice, not the whole series), `EXECUTIVE_ACTION`, `AGENCY_GUIDANCE`, `SENTENCING_GUIDELINES`, `US_TAX_TREATY`, `SESSION_LAW` (Statutes at Large, as enacted), `STATUTE_COMPILATION` (an act as amended through a stated later law), `AGENCY_ADJUDICATION` (DOJ Office of Legal Counsel opinions and MSPB decisions). Pair with `state`: `STATE`, `REGULATION`, `STATE_RULES`, `STATE_CONSTITUTION`, `STATE_AGENCY_GUIDANCE`, `STATE_AG_OPINION`. Omit for all.",
"examples": [
"CFR"
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"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": "Jurisdiction. A 2-letter code for one of the 52 supported US jurisdictions (50 states + DC + PR), or `federal` for USC / CFR / Constitution / federal rules. Pass a list to search several at once. Case-insensitive. Omit to search every jurisdiction.",
"examples": [
"ca"
]
},
"code": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Restrict to specific state statutory codes, e.g. `tx_pe` for the Texas Penal Code. Values are the `actId`s from list_statute_divisions. List allowed, across states. The only way to scope below a whole jurisdiction: `state=tx` alone searches all ~15 Texas codes.",
"examples": [
"tx_pe"
]
},
"article": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Scope a search to one or more articles. On `CONSTITUTION` and `STATE_CONSTITUTION` this is the article label as `GET /us/statutes/divisions` lists it (`Amendment XIV`, `Article IV`, `Preamble`). On `STATE` / `REGULATION` it is the article of a code divided by article instead of chapter, such as New York (`2-A` in `ny_jud`). This is the search side of `parent.article`: pass a hit's `parent` straight back to search within its article.\n\nPass the `identifier` exactly as the listing returned it; a case slip such as `amendment xiv` also matches. Article labels repeat, so `article` needs a `corpusType` from one of those two families, `STATE_CONSTITUTION` also needs `state`, and `STATE` / `REGULATION` need the `code`. A request missing one is refused with 422 before anything is charged. String or list.",
"examples": [
"Amendment XIV"
]
},
"yearFrom": {
"anyOf": [
{
"type": "integer",
"maximum": 2100,
"minimum": 1700
},
{
"type": "null"
}
],
"description": "Only sections last amended in or after this year; pair with `yearTo` for a window. Tracks the publisher's own amendment credit, not when we rebuilt the corpus. About a fifth of sections carry no credit and are excluded once either bound is set.",
"examples": [
2020
]
},
"yearTo": {
"anyOf": [
{
"type": "integer",
"maximum": 2100,
"minimum": 1700
},
{
"type": "null"
}
],
"description": "Only sections last amended in or before this year. This filters the LAST amendment, so a section amended in 2025 is excluded by `yearTo=2024` even though it existed in 2024. A currency filter, not point-in-time retrieval.",
"examples": [
2026
]
},
"excludeRepealed": {
"type": "boolean",
"description": "Drop sections whose own status says they are not operative (repealed, renumbered, transferred, expired, superseded, omitted, and the rest). Removes what we KNOW is dead; it does not promise the remainder is good law. Read `goodLawStatus` per result to tell them apart: `good_law` is checked, `unknown` is unchecked.",
"default": false,
"examples": [
true
]
},
"actStatus": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"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": "Positively scope to raw publisher statuses: `repealed` for dead law only, `in_force` for sections affirmatively marked current. The inverse of `excludeRepealed`, and what a compliance diff asking what was LOST needs. Combining a dead status with `excludeRepealed: true` is rejected 422.",
"examples": [
"repealed"
]
},
"changedSince": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
],
"format": "date",
"description": "Only sections we OBSERVED changing on or after this date (`YYYY-MM-DD`). Observed, not effective: the date we saw it, an upper bound on when it took effect. Capture began long after the corpus did and events sweep at 24 months, so empty means no captured change, never that nothing was amended.",
"examples": [
"2026-08-01"
]
},
"agency": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "Federal Register agency slug, e.g. `environmental-protection-agency`. Pass a list to match any of several. Applies to `FEDERAL_REGISTER` and `EXECUTIVE_ACTION`; other corpora carry no agency, so combining this with them returns nothing.",
"examples": [
"environmental-protection-agency"
]
},
"documentType": {
"anyOf": [
{
"type": "string",
"enum": [
"final",
"proposed",
"presidential"
]
},
{
"type": "null"
}
],
"description": "Federal Register document stage: `final` (a rule in force), `proposed` (an NPRM), or `presidential` (a Presidential Document, the `EXECUTIVE_ACTION` corpus). The same distinction appears in each row's `actId` prefix (`FR_RULE_` vs `FR_PRORULE_`).",
"examples": [
"final"
]
},
"publishedFrom": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
],
"format": "date",
"description": "Only return Federal Register documents published on or after this date (`YYYY-MM-DD`). This is the PUBLICATION date, which is not the same as `yearFrom`: that filters the version year of a section.",
"examples": [
"2024-01-01"
]
},
"publishedTo": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
],
"format": "date",
"description": "Only return Federal Register documents published on or before this date.",
"examples": [
"2024-12-31"
]
},
"titleNumber": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "Filter by USC/CFR title number (e.g., 17 for SEC, 42 for civil rights). Only meaningful for `USC`/`CFR`; ignored for state corpora whose titles are alphabetic (e.g. Texas `pe` = Penal Code).",
"examples": [
17
]
},
"chapter": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "One or more chapters within a title or code, e.g. `21` for USC Title 42 Chapter 21. Pass a hit's `parent.chapter` back to search its neighbors. Chapter numbers repeat across titles, so pair with `titleNumber` (USC) or `code` (state); an unpaired chapter is rejected.",
"examples": [
"21"
]
},
"part": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "One or more parts within a title, e.g. `240` for 17 C.F.R. Part 240. The CFR counterpart to `chapter`: pass a hit's `parent.part` back. Pair with `titleNumber`; an unpaired part is rejected.",
"examples": [
"240"
]
},
"source": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"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": "The named body of law within a `corpusType` that folds several together: `FEDERAL_RULES` into `frcp`/`fre`/`sct`, `CFR` into `far`/`dfars`, `AGENCY_GUIDANCE` into ~34 agency sources, `AGENCY_ADJUDICATION` into `olc_opinion`/`mspb_precedential`/`mspb_nonprecedential`. Every result carries its own `source`, so a hit's value can be passed straight back.",
"examples": [
"sct"
]
},
"fields": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array",
"uniqueItems": true
},
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"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",
"historyEffectiveDate",
"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 result fields, e.g. `[\"title\", \"excerpt\"]`. A result carries 40+ fields, most null on any given row. `actId` and `citation` are always included. Unknown names are rejected 422. Omit for the full object.",
"examples": [
[
"title",
"excerpt",
"state"
]
]
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Number of results to return per page.",
"default": 10
},
"offset": {
"type": "integer",
"maximum": 70,
"minimum": 0,
"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. The deepest reachable result is `offset` + `limit`; check `hasMore`.",
"default": 0
},
"includeBody": {
"type": "boolean",
"description": "Return each hit's full text inline on `body`, instead of one `/section/{actId}/body` call per hit. Buys latency, not a discount: the 4-credit search PLUS 6 credits for every row that returns text, so ten rows is 64. ⚠️ It multiplies with `limit`; 50 rows is 304 credits in one call. Rows with no text are not charged, so read `creditsConsumed`. Prefer this over a bigger `excerptChars`: an excerpt is windowed around the match and can start mid-section, so it is not safe to quote.",
"default": false,
"examples": [
true
]
},
"excerptChars": {
"type": "integer",
"maximum": 4000,
"minimum": 100,
"description": "Characters of matching text to include in each result's `excerpt`. The excerpt is a ranking preview; use `/us/statutes/section/{actId}/body` for the full text. Default 500.",
"default": 500
},
"matchType": {
"type": "string",
"enum": [
"any",
"all",
"phrase"
],
"description": "`any` (default) is hybrid semantic + keyword ranking, for natural-language questions. `all` requires every query term; `phrase` matches an exact phrase, for a defined term. To pull up one section, pass its citation as the query and it resolves to that section at rank 1.",
"default": "any",
"examples": [
"phrase"
]
}
},
"required": [
"query"
]
}輸出結構描述
{
"type": "object",
"additionalProperties": true
}社群
證據
近期觀測
已驗證未記錄版本18 個工具
已驗證未記錄版本22 個工具
已驗證未記錄版本27 個工具
已驗證未記錄版本22 個工具
已驗證未記錄版本26 個工具
已驗證未記錄版本21 個工具