Blm Mining Claims

@pipeworx/blm-mining-claims

美国联邦采矿权，数据来自土地管理局的矿产与土地记录系统（MLRS）：查询某个点附近或某个矩形范围内的采矿权、按案件序列号查询单项采矿权，以及统计某个地点周边按类型和状态分类的采矿权数量。每条结果均包含案件序列号、采矿权名称、矿脉／砂矿／选矿场／隧道场类型、状态、登记英亩数、PLSS 法定土地描述，以及 MLRS 案件记录链接。

属于 Pipeworx——连接 AI Agent 与 1875+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供方无关联、未经其认可，也非由其发布。

工具

• blm_claims_near(latitude, longitude, radius_km?, status?, claim_type?, limit?, after_object_id?)：查询某个点周围指定半径（最多 50 km）内的采矿权，并返回该半径内的总数。每页按距离排序。可用于查看锂、金或铀矿床周边有哪些人登记了采矿权。
• blm_claims_in_bbox(min_lat, min_lon, max_lat, max_lon, status?, claim_type?, limit?, after_object_id?)：按矩形范围查询，其他条件相同；范围每边最长为 2°。
• blm_claims_case(case_id)：按 MLRS 序列号（NV101474832）或旧序列号（NMC1018964）查询单个案件。返回类型、状态、英亩数、已取得专利／排除／转让标记、解析后的 PLSS 法定土地描述（子午线、镇区、测区、分区、细分地块）、映射边界框、BLM 的映射质量日志，以及 MLRS 链接。
• blm_claims_summary(latitude, longitude, radius_km?, status?)：统计指定半径内按采矿权类型和状态分类的数量及登记英亩总数。

status 接受 open（默认值：所有未结案的案件，包括 Active、Filed、Under Review 和 On Appeal）、active（状态恰好为 Active）、closed 或 all。claim_type 接受 lode、placer、mill_site 或 tunnel_site。

身份验证

无需密钥。

数据源

• https://gis.blm.gov/nlsdb/rest/services/Mining_Claims/MiningClaims/MapServer：BLM MLRS 采矿权案件图层（ArcGIS MapServer）。图层 0 包含所有案件，图层 1 包含未结案的案件，图层 2 包含已结案的案件。每次调用都会实时查询该服务。
• https://mlrs.blm.gov/：mlrs_case_url 打开的 MLRS 案件记录。

以下是其他人可能需要重新摸索的信息：

• 几何图形并非采矿权的登记边界。 BLM 会将每个案件登记的法定土地描述映射到 PLSS 地籍网格，因此，一项 20 英亩的矿脉采矿权会显示为其登记所在的细分地块。QLTY 分数表示映射效果。geometry_basis 会将其转换为文字：直接匹配 PLSS、计算得出、仅到分区级别、仅到县级别、无几何图形，或经 BLM 手动编辑。
• 图层中没有位置日期、权利人姓名或权利人数。 这些字段仅存在于 MLRS 案件记录中。工具会在 fields_not_in_layer 中说明这一点，而不是返回 null 值。
• 未公布数据截至日期。 服务不提供 editingInfo 或 documentInfo 日期，因此 data_as_of 表示实时查询时间，data_as_of_basis 会说明这一点。
• orderByFields 速度很慢： 经 2026-10-08 测量，耗时约 30–60 秒；不使用时约 5 秒。返回的行按 OBJECTID 排序，因此分页使用 OBJECTID 游标（after_object_id → next_after_object_id）。
• 空间查询中的 resultOffset 会产生偏差。 偏移量为 0 时会少返回一行，偏移量 k 从第 k−1 行开始。按偏移量分页会重复或漏掉采矿权，因此此工具包改用游标。
• BLM_PROD 的大小写不固定（Lode Claim 和 LODE CLAIM 都会出现），因此类型筛选使用 UPPER(BLM_PROD) LIKE 'LODE CLAIM%'，这也会包含名称带有“– National Park”的变体。

快速开始

将其添加到 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "blm-mining-claims": {
      "url": "https://gateway.pipeworx.io/blm-mining-claims/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/blm-mining-claims/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall，以及网关范围内的其他工具。因此，你看到的工具数量会多于此表中的数量：目前，单个工具包端点除了列出该工具包自己的工具，还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，并且是当天有效范围的权威依据。

这是有意如此，并非意外的多路复用。元工具让限定范围的连接也能回答此工具包无法覆盖的问题——通过 ask_pipeworx 在整个目录中路由——无需再添加第二个 MCP 服务。目前无法挂载不包含这些元工具的工具包端点；如果额外的架构信息占用的上下文多于路由带来的收益，请连接完整网关，而不要连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出每个工具包的工具，而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都会连接到同一个网关和相同的 1875+ 个数据源。唯一的区别在于直接列出的是哪个工具包的工具；从任一端点使用 ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/blm_claims_near \
  -H 'Content-Type: application/json' \
  -d '{"latitude":41.71,"longitude":-118.06,"radius_km":10,"limit":5}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/blm_claims_near。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账户）

此软件包也可作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经过网关：

{
  "mcpServers": {
    "blm-mining-claims": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-blm-mining-claims"]
    }
  }
}

或者直接运行它，确认服务能够启动：

npx -y @pipeworx/mcp-blm-mining-claims

它通过 stdin/stdout 使用 MCP，并为仅此工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接额外提供的任何共享元工具。使用相同的源代码和工具，但不提供 ask_pipeworx 路由。

使用 ask_pipeworx

除了直接调用工具，你也可以用通俗语言提问——此方式既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Blm Mining Claims data" })

网关会自动选择合适的工具并填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT