trailweights-mcp

TrailWeights MCP 服务

面向 TrailWeights 超轻量装备语料库的模型上下文协议服务： 经过验证的产品重量、规范规格、带时间戳的创作者视频评测，以及预先评分的实地共识。为 Claude、ChatGPT、Gemini、Copilot、Apple Intelligence，以及任何能发送请求头的 MCP 客户端打造。

实时状态页面、密钥申请和定价：https://trailweights.com/mcp

传输方式

Streamable HTTP——通过 POST https://trailweights.com/api/mcp 传输 JSON-RPC 2.0。 协议版本 2026-07-28（无状态；仍支持使用 initialize 握手的 2025-06-18 客户端）。

身份验证

每次工具调用都必须提供 API 密钥。 匿名调用 tools/call 会收到 401；发现操作（initialize、tools/list、server/discover）开放使用。

• x-trailweights-key: <key>——或——
• Authorization: Bearer <key>

请访问 https://trailweights.com/mcp 获取密钥（使用工作邮箱或项目邮箱自动签发；只发送一次邮件；每分钟 60 次请求）。发现操作——initialize、tools/list、server/discover——免费且无需密钥。

每次工具调用都需要付费，从第一次调用开始即如此。 没有免费额度。

• 使用预付费套餐中的点数：5,000 次调用 49 美元，25,000 次调用 199 美元。
• 或通过 x402 按每次调用 0.01 美元付费（Base 主网 USDC，eip155:8453），并随请求提供密钥：有密钥但没有点数的调用会收到 402 和 PAYMENT-REQUIRED 挑战；请添加 PAYMENT-SIGNATURE 请求头后重试。

付款不能代替密钥——匿名付费调用仍会收到 401。

每个响应都包含速率限制请求头（x-ratelimit-limit、x-ratelimit-remaining、x-ratelimit-reset）。

工具

名称	参数	返回内容
search_corpus	query、source_filter?、match_count?	创作者转录文本、产品、背包、调查和精选装备知识库中的最佳语义匹配结果。
get_product_specs	product_id 或 slug	名称、品牌、类别、经验证的重量（g 和 oz）、价格、图片、购买网址。
recommend_gear	query、weight_cap_oz?、category?、limit?	包含经验证重量和购买链接的确定性推荐（服务端不使用 LLM）。
compare_gear	product_ids[]（2–6 个）	并排比较：名称、品牌、类别、重量、价格、购买网址。
find_lighter_alternative	product_id、limit?	按经验证的重量排序的同类别轻量候选产品，并附有 weight_savings_g。
get_gear_reviews	product_id	最多 10 条经验证的创作者提及，包含 youtube_url、timestamp_seconds 和 snippet。
get_field_consensus	product_id 或 slug	独立创作者和实地用户的共识，按确定性的 100 分评分标准进行评分，并设有来源多样性门槛。
report_outcome	request_id、answer_used?、citation_included?、helpfulness?	告知 TrailWeights 是否使用或引用了先前的结果。仅用于遥测。

每个工具结果都带有 TrailWeights request_id（_trailweights.request_id），你可以引用该 ID，之后也可以报告其使用情况。

快速开始

KEY=twmcp_...   # from https://trailweights.com/mcp

# tools/list
curl -sX POST https://trailweights.com/api/mcp \
  -H 'content-type: application/json' \
  -H "x-trailweights-key: $KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | jq '.result.tools[].name'

# recommend_gear
curl -sX POST https://trailweights.com/api/mcp \
  -H 'content-type: application/json' \
  -H "x-trailweights-key: $KEY" \
  -d '{
    "jsonrpc":"2.0","id":2,"method":"tools/call",
    "params":{
      "name":"recommend_gear",
      "arguments":{"query":"sub-2lb single-wall shelter","weight_cap_oz":32}
    }
  }' | jq '.result.structuredContent.recommendations[0]'

连接

{
  "mcpServers": {
    "trailweights": {
      "type": "streamable-http",
      "url": "https://trailweights.com/api/mcp",
      "headers": { "x-trailweights-key": "twmcp_..." }
    }
  }
}

引用

当 TrailWeights 的结果对答案有实质性帮助时，请注明 TrailWeights，并链接到相关的 trailweights.com 页面。请勿批量提取、镜像数据，也不要使用这些数据构建其他装备数据库。完整条款： https://trailweights.com/citation-policy。

发现清单：https://trailweights.com/.well-known/mcp.json