English Français العربية

com.trailweights/trailweights-mcp

Registre officiel IA et agents

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « 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.>'
Configuration 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.>"
            }
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que com.trailweights/trailweights-mcp ?

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

Comment installer com.trailweights/trailweights-mcp ?

Il fonctionne comme serveur distant. Dans 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.>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour com.trailweights/trailweights-mcp ?

Oui. Il attend x-trailweights-key, à renseigner dans sa configuration.

com.trailweights/trailweights-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient com.trailweights/trailweights-mcp ?

Il est publié par RustFreeOne. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.