Lawstronaut Legal Research

---

这是什么？

Lawstronaut 是一个基础设施层，可将 AI Agent 和软件连接到覆盖 150 多个司法管辖区的数百万份法律文档和结构化法律数据，这些数据会持续更新，并可通过 MCP 即时使用。

身份验证

生产环境 MCP 服务：https://mcp.lawstronaut.com

传输方式：基于 Streamable HTTP 的 MCP（POST /）。

公开服务卡片（工具列表，无需身份验证）：
https://mcp.lawstronaut.com/.well-known/mcp/server-card.json

---

Lawstronaut MCP 支持 Bearer 令牌和 OAuth 2.0（client_id + client_secret）。需要付费订阅。

方式	适用场景	工具列表	工具调用
Bearer 令牌	命令行、脚本、不支持 OAuth 的客户端	无需身份验证	Authorization: Bearer <token>
OAuth 2.0	Cursor、VS Code、Claude、发布平台	无需身份验证	OAuth 访问令牌（由客户端自动管理）

获取 client ID、secret 或 Bearer 令牌

1. 访问 lawstronaut.com 并购买订阅。
2. 登录开发者门户。
3. 在 Home 菜单中打开 MCP server access。
4. 创建 client ID + client secret（OAuth）或 Bearer 令牌。

选项 A — Bearer 令牌

使用 MCP server access 中的 Bearer 令牌：

Authorization: Bearer <your-token>

在环境中设置：

export LAWSTRONAUT_MCP_BEARER_TOKEN="your-token-here"

示例配置：cursor-mcp.json、vscode-mcp.json、claude-code.mcp.json。

选项 B — OAuth 2.0（client_id + client_secret）

在开发者门户的 MCP server access 中使用创建的 client_id 和 client_secret。

端点	URL
MCP 服务	https://mcp.lawstronaut.com
授权	https://mcp.lawstronaut.com/oauth/authorize
令牌	https://mcp.lawstronaut.com/oauth/token
OAuth 发现	https://mcp.lawstronaut.com/.well-known/oauth-authorization-server
受保护资源	https://mcp.lawstronaut.com/.well-known/oauth-protected-resource

流程： response_type=code → 重定向时携带 code → 使用 grant_type=authorization_code、client_id、client_secret、code 和 redirect_uri 在 /oauth/token 交换令牌。

支持 MCP OAuth 发现的客户端只需提供服务 URL，即可使用已注册的 client_id / client_secret 自动完成流程。

示例配置：cursor-mcp-oauth.json、vscode-mcp-oauth.json。

---

设置

选择客户端，粘贴配置，并使用 lawstronaut 账户进行身份验证。大多数客户端会在 Agent 首次使用 lawstronaut 工具时打开浏览器窗口进行 OAuth 身份验证。

Cursor

Bearer 令牌

1. 将 cursor-mcp.json 复制到 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）。
2. 导出 LAWSTRONAUT_MCP_BEARER_TOKEN。
3. 重启 Cursor。如果连接失败，请检查 输出 → MCP 日志。

OAuth

1. 将 cursor-mcp-oauth.json 复制到 .cursor/mcp.json。
2. 按 Cursor 提示完成 OAuth 登录（使用已注册的 client_id / client_secret）。

文档：Cursor MCP。

---

VS Code（GitHub Copilot Agent / MCP）

Bearer 令牌

1. 将 vscode-mcp.json 复制到 .vscode/mcp.json，或合并到用户 MCP 配置中。
2. 运行 MCP: List Servers，并在提示时输入 Bearer 令牌。

OAuth

1. 将 vscode-mcp-oauth.json 复制到 .vscode/mcp.json。
2. 按提示通过 VS Code 登录。

文档：MCP 配置参考。

---

Claude Code（命令行）

Bearer 令牌 — 命令行

export LAWSTRONAUT_MCP_BEARER_TOKEN="your-token-here"

claude mcp add --transport http lawstronaut-mcp https://mcp.lawstronaut.com \
  --header "Authorization: Bearer $LAWSTRONAUT_MCP_BEARER_TOKEN"

Bearer 令牌 — 项目文件

将 claude-code.mcp.json 复制到项目根目录中的 .mcp.json。

OAuth

仅添加服务 URL，并按提示完成 OAuth：

claude mcp add --transport http lawstronaut-mcp https://mcp.lawstronaut.com

文档：通过 MCP 将 Claude Code 连接到工具。

---

Claude Desktop（Anthropic 应用）

Claude Desktop 面向 stdio MCP 服务。对于此 HTTP 服务，请使用 Cursor、VS Code 或 Claude Code，也可以使用任何支持远程 Streamable HTTP MCP 的主机。

前往 自定义、连接器，点击“+”，选择添加自定义连接器，并填写对话框：

---

其他主机（Continue、Zed、自定义 Agent 等）

任何支持 MCP Streamable HTTP 的客户端都可以通过以下方式连接：

• URL： https://mcp.lawstronaut.com
• Bearer： Authorization: Bearer <token>
• OAuth： 使用 /.well-known/oauth-authorization-server 发现端点，并提供 client_id / client_secret

---

工具

• list_jurisdictions - 列出 Lawstronaut 语料库中的所有司法管辖区（国家/州）——请先调用，以获取其他工具所需的有效 ISO 代码

• list_domains - 列出法律领域，支持按名称筛选和分页

  • domain：按名称筛选领域（字符串，可选）
  • limit：要返回的结果数量（数字，可选）
  • offset：要跳过的结果数量（数字，可选）

• list_subdomains - 列出某个领域 ID 下的子领域——支持按名称筛选结果和分页

  • domain_id：按领域 ID 筛选（字符串，必填）
  • subdomain：按名称筛选子领域（字符串，可选）
  • limit：要返回的结果数量（数字，可选）
  • offset：要跳过的结果数量（数字，可选）

• list_categories - 列出某个子领域下的法律类别——支持按名称筛选结果和分页

  • subdomain_id：按子领域 ID 筛选（字符串，可选）
  • category_name：按名称筛选类别（字符串，可选）
  • limit：要返回的结果数量（数字，可选）
  • offset：要跳过的结果数量（数字，可选）

• list_subcategories - 列出某个类别 ID 下的子类别——支持按名称筛选结果和分页

  • category_id：按类别 ID 筛选（字符串，必填）
  • subcategory_name：按名称筛选子类别（字符串，可选）
  • limit：要返回的结果数量（数字，可选）
  • offset：要跳过的结果数量（数字，可选）

• list_law_types - 列出某个子类别 ID 下的法律类型——支持按名称筛选结果和分页

  • subcategory_id：按子类别 ID 筛选（字符串，必填）
  • law_type：按名称筛选法律类型（字符串，可选）
  • limit：要返回的结果数量（数字，可选）
  • offset：要跳过的结果数量（数字，可选）

• list_portals - 列出某司法管辖区的法律门户 — 可按名称、语言或标签筛选

  • iso：按司法管辖区 ISO 代码筛选（例如 'US'）（字符串，必填）
  • name：按名称筛选门户（字符串，可选）
  • tag：按标签筛选（字符串，可选）
  • lang：按语言筛选（字符串，可选）

• list_authority_types - 列出某司法管辖区的机构类型 — 可按门户或机构类型筛选

  • iso：按司法管辖区 ISO 代码筛选（例如 'US'）（字符串，必填）
  • limit：要返回的结果数量（数字，可选）
  • offset：要跳过的结果数量（数字，可选）
  • portal_name：按门户名称筛选（字符串，可选）
  • authority_type：按机构类型筛选（字符串，可选）

• list_issuing_authorities - 列出某司法管辖区的发文机构 — 可按门户或机构名称筛选

  • iso：按司法管辖区 ISO 代码筛选（例如 'US'）（字符串，必填）
  • limit：要返回的结果数量（数字，可选）
  • offset：要跳过的结果数量（数字，可选）
  • portal_name：按门户名称筛选（字符串，可选）
  • issuing_authority：按发文机构筛选（字符串，可选）

• list_documents - 列出某司法管辖区的法律文件 — 可按标题、日期、门户、状态、标签等筛选

  • iso：按司法管辖区 ISO 代码筛选（例如 'US'）（字符串，必填）
  • portal：按门户名称筛选（字符串，可选）
  • version：文件版本（字符串，可选）
  • limit：要返回的结果数量（数字，可选）
  • offset：要跳过的结果数量（数字，可选）
  • document_id：文件 ID（字符串，可选）
  • repealed：按废止状态筛选（布尔值，可选）
  • title：按标题筛选（字符串，可选）
  • section_title：按章节标题筛选（字符串，可选）
  • url：按 URL 筛选（字符串，可选）
  • status：按状态筛选（字符串，可选）
  • crawling_date：按抓取日期筛选（字符串，可选）
  • last_updated：按最后更新日期筛选（字符串，可选）
  • last_amendment：按最后修订日期筛选（字符串，可选）
  • publication_date：按发布日期筛选（字符串，可选）
  • expiration_date：按到期日期筛选（字符串，可选）
  • effective_date：按生效日期筛选（字符串，可选）
  • date_of_enactment：按颁布日期筛选（字符串，可选）
  • date_of_decision：按决定日期筛选（字符串，可选）
  • file_data_only：仅返回文件相关数据（布尔值，可选）
  • issuing_authority：按发文机构筛选（字符串，可选）
  • type_of_authority：按机构类型筛选（字符串，可选）
  • source_identifier：按来源标识符筛选（字符串，可选）
  • source_secondary_identifier：按来源次级标识符筛选（字符串，可选）
  • tag：按标签筛选（字符串，可选）
  • lang：按语言筛选（字符串，可选）

• get_document_text - 获取符合司法管辖区和筛选条件的文档全文

  • iso：按司法管辖区 ISO 代码筛选（例如 'US'）（字符串，必填）
  • portal：按门户名称筛选（字符串，可选）
  • version：文档版本（字符串，可选）
  • limit：返回结果数量（数字，可选）
  • offset：跳过的结果数量（数字，可选）
  • document_id：文档 ID（字符串，可选）
  • repealed：按废止状态筛选（布尔值，可选）
  • title：按标题筛选（字符串，可选）
  • section_title：按章节标题筛选（字符串，可选）
  • url：按 URL 筛选（字符串，可选）
  • status：按状态筛选（字符串，可选）
  • crawling_date：按抓取日期筛选（字符串，可选）
  • last_updated：按最后更新日期筛选（字符串，可选）
  • last_amendment：按最近修订日期筛选（字符串，可选）
  • publication_date：按发布日期筛选（字符串，可选）
  • expiration_date：按失效日期筛选（字符串，可选）
  • effective_date：按生效日期筛选（字符串，可选）
  • date_of_enactment：按颁布日期筛选（字符串，可选）
  • date_of_decision：按决定日期筛选（字符串，可选）
  • file_data_only：仅返回与文件相关的数据（布尔值，可选）
  • issuing_authority：按发布机构筛选（字符串，可选）
  • type_of_authority：按机构类型筛选（字符串，可选）
  • source_identifier：按来源标识符筛选（字符串，可选）
  • source_secondary_identifier：按来源次级标识符筛选（字符串，可选）
  • tag：按标签筛选（字符串，可选）
  • lang：按语言筛选（字符串，可选）

• get_markdown - 获取符合司法管辖区和筛选条件的文档正文（Markdown 格式）

  • iso：按司法管辖区 ISO 代码筛选（例如 'US'）（字符串，必填）
  • portal：按门户名称筛选（字符串，可选）
  • version：文档版本（字符串，可选）
  • limit：返回结果数量（数字，可选）
  • offset：跳过的结果数量（数字，可选）
  • document_id：文档 ID（字符串，可选）
  • repealed：按废止状态筛选（布尔值，可选）
  • title：按标题筛选（字符串，可选）
  • section_title：按章节标题筛选（字符串，可选）
  • url：按 URL 筛选（字符串，可选）
  • status：按状态筛选（字符串，可选）
  • crawling_date：按抓取日期筛选（字符串，可选）
  • last_updated：按最后更新日期筛选（字符串，可选）
  • last_amendment：按最近修订日期筛选（字符串，可选）
  • publication_date：按发布日期筛选（字符串，可选）
  • expiration_date：按失效日期筛选（字符串，可选）
  • effective_date：按生效日期筛选（字符串，可选）
  • date_of_enactment：按颁布日期筛选（字符串，可选）
  • date_of_decision：按决定日期筛选（字符串，可选）
  • file_data_only：仅返回与文件相关的数据（布尔值，可选）
  • issuing_authority：按发布机构筛选（字符串，可选）
  • type_of_authority：按机构类型筛选（字符串，可选）
  • source_identifier：按来源标识符筛选（字符串，可选）
  • source_secondary_identifier：按来源次级标识符筛选（字符串，可选）
  • tag：按标签筛选（字符串，可选）
  • lang：按语言筛选（字符串，可选）

• get_source_url - 获取指向原始源文件（PDF 等）的限时签名 URL

  • document_id：文档 ID（整数，必填）

• get_document_with_version - 获取指定版本的特定文档及其完整元数据

  • document_id：文档 ID（整数，必填）
  • version：版本（整数，必填）

• horizon_scan - 扫描某个司法辖区近期的法律变更 — 可按主题、日期范围和主管机关筛选

  • iso：一个 ISO 代码，例如 "IE"、"NL"、"US" 等（字符串，必填）
  • since：扫描的日期范围起始日期（字符串，可选）
  • topic：要重点扫描的主题或关键词（字符串，可选）
  • date_field：用于日期范围的日期字段（字符串，可选）
  • status：按状态筛选（字符串，可选）
  • issuing_authority：按发布机关筛选（字符串，可选）
  • type_of_authority：按机关类型筛选（字符串，可选）
  • include_repealed：是否包含已废止的文件（布尔值，可选）
  • max_per_jurisdiction：每个司法辖区的结果上限（整数，可选）

• evidence_pull - 获取文件的完整引证链 — 元数据、法律链接、来源 URL 和正文

  • iso：文件所属司法辖区的 ISO 代码，例如 'IE'、'NL'、'US' 等（字符串，必填）
  • document_id：来自任一列表或搜索工具的数字型 document_id（整数，必填）
  • include_text：是否包含文件正文（布尔值，可选）
  • include_source_url：是否包含带签名的来源 URL（布尔值，可选）
  • text_format：所含文本的格式（例如 markdown 或纯文本）（字符串，可选）

所有工具均为只读。OAuth 令牌使用范围 mcp:tools:read 签发。工具列表公开；调用工具需要身份验证。

---