English Français العربية

com.trailweights/trailweights-mcp

Official registry AI and agents

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

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 configuration (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

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  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

Frequently asked questions

What is com.trailweights/trailweights-mcp?

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

How do I install com.trailweights/trailweights-mcp?

It runs as a remote server. In 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.>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does com.trailweights/trailweights-mcp need an API key?

Yes. It expects x-trailweights-key, which you set in its configuration.

Is com.trailweights/trailweights-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains com.trailweights/trailweights-mcp?

It is published by RustFreeOne. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.