English Français العربية

com.trailweights/trailweights-mcp

السجل الرسمي الذكاء الاصطناعي والوكلاء

Verified ultralight gear evidence for agents: weights, specs, reviews, consensus. Paid per call.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http trailweights-mcp 'https://trailweights.com/api/mcp' --header 'x-trailweights-key: <TrailWeights-issued API key from https://trailweights.com/mcp. Every tool call is paid: one prepaid credit or $0.01 USDC via x402 on Base. Authorization: Bearer <key> also accepted.>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "trailweights-mcp": {
            "type": "http",
            "url": "https://trailweights.com/api/mcp",
            "headers": {
                "x-trailweights-key": "<TrailWeights-issued API key from https://trailweights.com/mcp. Every tool call is paid: one prepaid credit or $0.01 USDC via x402 on Base. Authorization: Bearer <key> also accepted.>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. TrailWeights MCP Server
  2. Transport
  3. Auth
  4. Tools
  5. Quick start
  6. Connect
  7. Citation

TrailWeights MCP Server

Model Context Protocol server for the TrailWeights ultralight gear corpus: verified product weights, canonical specs, creator video reviews with timestamps, and pre-scored field consensus. Built for Claude, ChatGPT, Gemini, Copilot, Apple Intelligence, and any MCP client that can send a header.

Live status page, key request, and pricing: https://trailweights.com/mcp

Transport

Streamable HTTP — JSON-RPC 2.0 over POST https://trailweights.com/api/mcp. Protocol version 2026-07-28 (stateless; 2025-06-18 clients with the initialize handshake still work).

Auth

API key, required on every tool call. Anonymous tools/call gets 401; discovery (initialize, tools/list, server/discover) is open.

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

Get a key at https://trailweights.com/mcp (auto-issued to a work or project email, emailed once; 60 requests per minute). Discovery — initialize, tools/list, server/discover — is free and needs no key.

Every tool call is paid, from the first one. There is no free allowance.

  • One credit from a prepaid pack: $49 for 5,000 calls, $199 for 25,000.
  • Or $0.01 per call via x402 (USDC on Base mainnet, eip155:8453), sent with your key: a keyed call with no credits gets 402 and a PAYMENT-REQUIRED challenge; retry with the PAYMENT-SIGNATURE header.

Payments never replace the key — an anonymous paid call still gets 401.

Rate-limit headers (x-ratelimit-limit, x-ratelimit-remaining, x-ratelimit-reset) ride every response.

Tools

NameArgsReturns
search_corpusquery, source_filter?, match_count?Top semantic matches across creator transcripts, products, packs, surveys, and the curated gear knowledge base.
get_product_specsproduct_id or slugName, brand, category, verified weight (g & oz), price, image, buy URL.
recommend_gearquery, weight_cap_oz?, category?, limit?Deterministic recommendations with verified weights and buy links (no server-side LLM).
compare_gearproduct_ids[] (2–6)Side-by-side: name, brand, category, weight, price, buy URL.
find_lighter_alternativeproduct_id, limit?Lighter same-category candidates sorted by verified weight, with weight_savings_g.
get_gear_reviewsproduct_idUp to 10 verified creator mentions with youtube_url, timestamp_seconds, and snippet.
get_field_consensusproduct_id or slugWhat independent creators and the field agree on, scored on a deterministic 100-point rubric with a source-diversity gate.
report_outcomerequest_id, answer_used?, citation_included?, helpfulness?Tell TrailWeights whether a prior result was used or cited. Telemetry only.

Every tool result carries a TrailWeights request_id (_trailweights.request_id) you can cite and later report on.

Quick start

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]'

Connect

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

Citation

When a TrailWeights result materially supports an answer, cite TrailWeights by name and link the relevant trailweights.com page. Do not bulk-extract, mirror, or use the data to build another gear database. Full terms: https://trailweights.com/citation-policy.

Discovery manifest: https://trailweights.com/.well-known/mcp.json

الأسئلة الشائعة

ما هو com.trailweights/trailweights-mcp؟

Verified ultralight gear evidence for agents: weights, specs, reviews, consensus. Paid per call.

كيف أثبّت com.trailweights/trailweights-mcp؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http trailweights-mcp 'https://trailweights.com/api/mcp' --header 'x-trailweights-key: <TrailWeights-issued API key from https://trailweights.com/mcp. Every tool call is paid: one prepaid credit or $0.01 USDC via x402 on Base. Authorization: Bearer <key> also accepted.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج com.trailweights/trailweights-mcp إلى مفتاح API؟

نعم. يتطلب x-trailweights-key، وتضبطها في إعداداته.

هل com.trailweights/trailweights-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون com.trailweights/trailweights-mcp؟

ينشره RustFreeOne. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.