KnowJudges

KnowJudges MCP

通过只读远程 MCP 服务，研究美国法官、法院、法律 AI 案例和移民裁决结果，并提供来源链接。

• 网站：https://knowjudges.com
• 公开 MCP 文档：https://knowjudges.com/mcp
• 端点：https://mcp.knowjudges.com/mcp
• 传输方式：Streamable HTTP
• 身份验证：有限的公开访问无需令牌

当前协议

已部署的服务公布 10 个工具。此参考内容已于 2026 年 10 月 12 日根据实时 tools/list 检查。请获取已部署的 inputSchema 和 outputSchema，不要假定客户端缓存的目录是最新的。所有工具均返回带来源链接的结构化公开结果，并声明 readOnlyHint: true、destructiveHint: false 和 openWorldHint: false。它们无法提交文件、向法官发送电子邮件或更改记录。

连接

在客户端的远程 MCP 设置中添加端点。配置名称各不相同；如支持，仅使用 URL 即可完成设置。

{
  "mcpServers": {
    "know-your-judge": {
      "url": "https://mcp.knowjudges.com/mcp"
    }
  }
}

工具和输入

无需时可省略可选输入。日期使用 YYYY-MM-DD 格式。架构中要求使用两个字母的州／司法辖区代码不区分大小写。

工具	用途和选择指南	必填输入	可选输入和限制
find_judges	查找具名或可通过其他方式识别的法官。结果包含 profile_url 和报告的任职状态；具名匹配可能是历史记录或不确定结果。	query（至少 2 个字符）	state（名称或邮政编码）、court、county、limit（默认值为 5，范围为 1–10）。
get_judge_profile	获取身份信息、职务分配、公开简介信息、来源和特定范围的调查结果。针对传记或执业情况的问题，请使用相应的专用工具。	judge_url	无。缺失字段表示相关信息不可用。仅凭职务结束日期无法确认法官已退休或转为资深法官。
get_judge_biography	获取有来源支持的出生详情、教育经历、职业生涯和司法任职经历。	judge_url	无。保留日期精度。只有在有有效的完整出生日期时才提供年龄；只有年份的日期不得换算为精确年龄。
get_courtroom_presentation_rules	根据相关调查结果和底层来源，回答关于具名法官庭审实践的问题。除非用户提出要求，否则不要转而查询法院元数据或名册。	judge_url	topics（最多 10 个字符串），例如证物、远程作证或具名审判庭。针对特定项目或分庭的指导仍须按条件适用。
find_ai_abuse_cases	按案件名称、错误类型或记录的结果搜索涉及法律 AI 错误的案件。response 用于区分受到制裁和未受制裁的情况。	根据架构，无单个必填字段；请提供有意义的识别文本或缩小范围的筛选条件。不支持空搜索或批量搜索。	query（至少 2 个字符）、state、court、judge、response、包含边界日期的 from_date/to_date、limit（默认值为 5，范围为 1–10）。返回的 total_matches 并非所提供记录的数量。
get_recent_rule_changes	获取自某个日期以来记录的简介或规则更新。按法院筛选时，也会包含关联的已索引法官简介；会省略法院信息不明确的记录。	since（包含该日期）	judge_url、court_url、limit（默认值为 10，范围为 1–25）。跟踪从返回的 change_tracking_started_at 开始；结果为空并不能证明现实中此前没有发生变更。
find_court	查找法院身份信息，用于查询法院元数据或名册。	query（至少 2 个字符）	jurisdiction（2 个字母的代码，例如 GA、DC、US）、state（名称或邮政编码）、limit（默认值为 5，范围为 1–10）。返回规范的 court_url 值。
get_court	获取某个法院的身份信息、可用元数据，以及范围受限的已索引现任状态名册。	court_url	limit（默认值为 10，范围为 1–10）。保留 roster_coverage 和 roster_truncated。计数包含已索引的在职、资深、召回或客座法官简介，并非经独立核实的完整法官名册。
get_immigration_analytics	获取某名移民法官或某个法院的已记录结果。	entity（judge 或 court）、profile_url（规范的公开法官或法院 URL）	metric（默认值为 asylum_denial_rate；只有在明确要求时才可使用替代项 proceeding_removal_rate）、year（1950–2100）、year_basis（calendar，默认值，或 fiscal）、nationality（2–100 个字符）、state（2 个字母的代码）。
compare_immigration_analytics	在联合地理位置、国籍和时段筛选条件下，比较记录比率的最高值或最低值。	entity（judge 或 court）	metric、year、year_basis、nationality、state（同上）；order（ascending，默认值，或 descending）、minimum_decisions（默认值为 1，范围为 1–100000）、limit（默认值为 3，范围为 1–10）。
对于庇护分析，百分比以批准数加拒绝数为分母；程序性结果单独报告。少于 35 项裁决的样本会标注，而不会隐藏。裁决数为零表示没有可计算的比率，并非 0%。请保留 availability、message、分母／地理范围定义、来源、覆盖时段和局限性。历史比率既不能预测个人结果，也不表示当事人可以选择法官。

规范的公共 URL 链接方式

请使用发现工具返回的 URL，并保留其确切的、包含管辖区信息的形式。不要根据名称构造 URL，也不要使用不带限定信息的 slug、内部键或 ID。

法官档案、传记或执业情况

find_judges({"query":"Amy Totenberg","state":"GA","limit":3})
→ select the matching results[i].profile_url
→ get_judge_profile({"judge_url": selectedProfileUrl})        // identity/assignments
→ get_judge_biography({"judge_url": selectedProfileUrl})      // biography question
→ get_courtroom_presentation_rules({"judge_url": selectedProfileUrl}) // practice question

后续调用是根据问题选用的备选项，并非必须全部调用。发现结果中的 profile_url 在这些工具输入中对应 judge_url。

法院信息和已记录的变更

find_court({"query":"U.S. District Court for the Northern District of Georgia","state":"GA"})
→ select the matching results[i].court_url
→ get_court({"court_url": selectedCourtUrl,"limit":5})
→ get_recent_rule_changes({"since":"2026-10-01","court_url": selectedCourtUrl})

查询特定法官的变更时，应改用法官发现结果中的 judge_url。法院名册为空表示当前没有匹配的已索引记录；计数为 null 表示名册数据不可用。两者都不能证明实际法院没有法官。请保留特定地点的联系方式说明，不要把某一法院地址或电话号码视为全院通用信息。

法律 AI 案例

{
  "name": "find_ai_abuse_cases",
  "arguments": {
    "query": "AI hallucinations fabricated legal citations",
    "response": "Monetary Sanctions",
    "limit": 5
  }
}

请报告已记录的结果，并保留返回的裁决链接状态；仅因某案例被纳入数据集，并不能证明司法裁定认定使用了 AI。

移民比较

compare_immigration_analytics({"entity":"judge","nationality":"Brazil","state":"CA","year":2025,"order":"ascending","limit":3})
→ lowest recorded asylum denial rates for the available filtered period
compare_immigration_analytics({"entity":"judge","nationality":"Brazil","state":"CA","year":2025,"order":"descending","limit":3})
→ highest recorded rates; retain counts, small-sample notes, and coverage
→ get_immigration_analytics({"entity":"judge","profile_url": returnedProfileUrl,"nationality":"Brazil","state":"CA","year":2025})

后续调用请使用返回的、可用且非 null 的公共 URL。这些示例仅展示输入形式，并不保证特定国籍／年份有数据。

限制、配额和防枚举措施

• 搜索、法院名册和移民比较最多返回 10 条记录。近期变更最多返回 25 条。执业主题筛选最多接受 10 个主题。
• 不提供分页、游标、偏移量、批量枚举或批量导出。空搜索、通配符搜索、单字符搜索、仅按管辖区查询法官／法院，以及请求所有法官／法院的请求均会被拒绝。请使用可识别的姓名／地点文本，并结合缩小范围的筛选条件。
• 连续按前缀／标识符抓取数据会受到限流。每日法官／法院唯一身份配额中，已访问过的身份只计一次；更换对话会话不会重置 OpenAI 主体的配额。
• 通用匿名调用方使用 IP 备用配额：每小时 20 次工具请求、每天 100 次，以及每天新访问 50 个法官／法院身份。
• 提供 _meta["openai/subject"] 的 OpenAI 调用方使用匿名主体配额：每小时 60 次工具请求、每天 300 次，以及每天 100 个新身份。openai/session 不是持久配额键。
• 可识别的 Claude 请求在可用时使用会话上下文进行短期控制；不会推断持久的用户标识符。没有会话时，将应用聚合网络控制。会话配额为每小时 60 次、每天 300 次，以及每天 100 个新身份。
• 单独的、针对已识别提供方的 IP／网络备用限制为每小时 1000 次请求、每天 10000 次，以及每天 1000 个新身份。普通网络的备用上限为每小时 200 次、每天 1000 次，网络预算为每天 100 个新身份。这些是聚合上限，不是个人配额。
• MCP 初始化／发现／控制请求计入网络备用限制，不计入普通调用方的工具配额。REST 使用共享的执行实现；没有 MCP 调用方上下文时，将使用匿名备用配额。
• 速率／抓取限制可能返回 HTTP 429 或受限的 MCP 工具失败。请遵循重试信息；不要通过轮换身份绕过控制。输入无效和数据缺失是不同状态。

如需数据集或定期／批量使用，请参阅 https://knowjudges.com/data-licensing。

来源与核验

保留返回的 KnowJudges URL、来源/官方 URL、来源标题、摘录、范围/适用性、生效/修订日期以及可用的最近核查日期。法官个人、全院、全州以及全国适用的联邦/EOIR 指引属于不同的权威范围。更广泛的规则并非个人偏好。缺少有记录的实践发现，既不能证明许可，也不能证明禁止。

last_updated 表示发布日期，而 last_verified 或 source_checked_at 表示证据核查日期。近期发布并不意味着当天核查了每个来源。保留有依据的仅精确到年份的履历日期和事实上的不确定性。

AI 案件链接可能指向已核验的判决页面，也可能明确标注为来源回退链接。保留 decision_link_status、dataset_source 和 summary_note；不得将回退 URL 描述为已核验的官方法院判决。未知的裁决数量表示不可用，而非零。依据要求采取行动前，请检查链接来源；具体案件的命令可能具有约束力。

链接

• REST 文档：https://knowjudges.com/api
• 公开资料和法院：https://knowjudges.com/kyj
• 条款：https://knowjudges.com/terms
• 隐私：https://knowjudges.com/privacy
• 目录列表：https://glama.ai/mcp/connectors/com.knowjudges/knowjudges

第三方列表和客户端工具目录可能未及时更新；实时 tools/list 才是权威信息。