{
  "markdown": "# TrailWeights MCP Server\n\nModel Context Protocol server for the TrailWeights ultralight gear corpus:\nverified product weights, canonical specs, creator video reviews with\ntimestamps, pre-scored field consensus, and in-house pack templates. Built\nfor Claude, ChatGPT, Gemini, Copilot, Apple Intelligence, and any MCP client\nthat can send a header.\n\nLive status page, key request, and pricing: <https://trailweights.com/mcp>\n\n## Transport\n\nStreamable HTTP — JSON-RPC 2.0 over `POST https://trailweights.com/api/mcp`.\nProtocol version **`2026-07-28`** (stateless; `2025-06-18` clients with the\n`initialize` handshake still work).\n\n## Auth\n\n**API key, required on every request.** Anonymous calls get `401`.\n\n- `x-trailweights-key: <key>` — or —\n- `Authorization: Bearer <key>`\n\nGet a free key at <https://trailweights.com/mcp>: auto-issued, emailed once,\n**500 tool calls per day** (resets 00:00 UTC), 60 requests per minute. Past\nthe daily cap the server answers `429` with `Retry-After`. Prepaid credit\npacks and per-call payment (x402 on Base, Stripe MPP) are listed on the same\npage; `402` responses carry the payment challenge when a key is out of\nallowance.\n\nRate-limit headers (`x-ratelimit-limit`, `x-ratelimit-remaining`,\n`x-ratelimit-reset`) ride every response.\n\n## Tools\n\n| Name | Args | Returns |\n| --- | --- | --- |\n| `search_corpus` | `query`, `source_filter?`, `match_count?` | Top semantic matches across creator transcripts, products, packs, surveys, and the curated gear knowledge base. |\n| `get_product_specs` | `product_id` or `slug` | Name, brand, category, verified weight (g & oz), price, image, buy URL. |\n| `recommend_gear` | `query`, `weight_cap_oz?`, `category?`, `limit?` | Deterministic recommendations with verified weights and buy links (no server-side LLM). |\n| `compare_gear` | `product_ids[]` (2–6) | Side-by-side: name, brand, category, weight, price, buy URL. |\n| `find_lighter_alternative` | `product_id`, `limit?` | Lighter same-category candidates sorted by verified weight, with `weight_savings_g`. |\n| `get_gear_reviews` | `product_id` | Up to 10 verified creator mentions with `youtube_url`, `timestamp_seconds`, and `snippet`. |\n| `get_field_consensus` | `product_id` or `slug` | What independent creators and the field agree on, scored on a deterministic 100-point rubric with a source-diversity gate. |\n| `get_pack_template` | `template_id` or `slug` | Full item list for one of the in-house pack templates. |\n| `report_outcome` | `request_id`, `answer_used?`, `citation_included?`, `helpfulness?` | Tell TrailWeights whether a prior result was used or cited. Telemetry only. |\n\nEvery tool result carries a TrailWeights `request_id`\n(`_trailweights.request_id`) you can cite and later report on.\n\n## Quick start\n\n```bash\nKEY=twmcp_...   # from https://trailweights.com/mcp\n\n# tools/list\ncurl -sX POST https://trailweights.com/api/mcp \\\n  -H 'content-type: application/json' \\\n  -H \"x-trailweights-key: $KEY\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}' | jq '.result.tools[].name'\n\n# recommend_gear\ncurl -sX POST https://trailweights.com/api/mcp \\\n  -H 'content-type: application/json' \\\n  -H \"x-trailweights-key: $KEY\" \\\n  -d '{\n    \"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\n    \"params\":{\n      \"name\":\"recommend_gear\",\n      \"arguments\":{\"query\":\"sub-2lb single-wall shelter\",\"weight_cap_oz\":32}\n    }\n  }' | jq '.result.structuredContent.recommendations[0]'\n```\n\n## Connect\n\n```json\n{\n  \"mcpServers\": {\n    \"trailweights\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://trailweights.com/api/mcp\",\n      \"headers\": { \"x-trailweights-key\": \"twmcp_...\" }\n    }\n  }\n}\n```\n\n## Citation\n\nWhen a TrailWeights result materially supports an answer, cite TrailWeights\nby name and link the relevant trailweights.com page. Do not bulk-extract,\nmirror, or use the data to build another gear database. Full terms:\n<https://trailweights.com/citation-policy>.\n\nDiscovery manifest: `https://trailweights.com/.well-known/mcp.json`\n",
  "bytes": 3986,
  "sha": "03a2083cac438a14463e0b30e6c50a8c34212c11e27925a1932abe3964853f48",
  "repo_slug": "rustfreeone/trailweights-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_trailweights_trailweights_mcp_9bccd4fc/readme"
}