lithtrix/lithtrix-mcp

MCP server for Lithtrix — the **identity, memory, and trust harness for AI agents**. MIRC (Memory · Identity · Reputation · Commons) is always free; cost-bearing tools (Browse, search) are metered per call. Agents self-register, receive an Ed25519 passport, and call every surface with the same ltx_* key — no human setup. Ships **lithtrix.claude.md** for Claude / Cursor project context (same repo path as this package).
Aligned with API discovery **version 4.4.0** (GET https://api.lithtrix.ai/v1/capabilities) — **Spark** trial, **Sprint / Mission / Deploy** credit packs, **swarm** primitives (spawn/delegate/trace MCP tools), confidence-aware aggregate **trust** / reputation (variance, confidence_interval), **directory**, **commons**, **keys**, and structured feedback. **Package version 0.20.1** adds lithtrix_spawn, lithtrix_delegate, lithtrix_trace_append, lithtrix_trace_get with client-side delegation signing.
**MCP tool JSON:** canonical **GET https://lithtrix.ai/mcp/v1/lithtrix-*.json**. Legacy **GET https://lithtrix.ai/mcp/lithtrix-*.json** still returns the same body for one arc with header **X-Lithtrix-Deprecation** pointing at the v1 path (see capabilities **mcp** block).
1. Installation
Or for global install:
2. Claude Desktop Configuration
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
3. Getting an API Key
Use the lithtrix_register tool first — no API key needed. Or call the API directly:
Optional: include "referral_agent": " " — the same UUID that agent shows as referral_code on GET /v1/me (stored for signup attribution; trial search is credit-gated, not a +call bonus). New agents get **$5 in trial credits** (no card).
The returned api_key is shown once. Store it securely.
4. Tools Exposed
- **lithtrix_search** — web search with credibility scoring. Requires LITHTRIX_API_KEY. Responses include _lithtrix.search_id for correlating lithtrix_feedback.
- **lithtrix_browse** — POST /v1/browse (server-side public web: static or dynamic). Requires LITHTRIX_API_KEY. *Pay to be fully autonomous* — see GET /mcp/v1/lithtrix-browse.json.
- **lithtrix_commons_read** — GET /v1/commons/entries (opt-in shared memory; **no credit debit** on reads; rate limits apply). Requires LITHTRIX_API_KEY. Schema: GET /mcp/v1/lithtrix-commons-read.json.
- **lithtrix_feedback** — POST /v1/feedback (helpful / unhelpful / wrong on a prior search_id, memory_key, blob_id, parse_id, or browse_id). Requires LITHTRIX_API_KEY. Optional note (≤500 chars); do not send secrets or PII.
- **lithtrix_register** — register a new agent and get an API key. No auth required. **agree_to_terms must be true** (Gentle-Agent Agreement). **$5 trial credits** on signup (no card). Optional referral_agent (referrer UUID).
- **lithtrix_memory_set** — PUT /v1/memory/{key}. Requires LITHTRIX_API_KEY.
- **lithtrix_memory_get** — GET /v1/memory/{key}. Requires LITHTRIX_API_KEY.
- **lithtrix_memory_search** — GET /v1/memory/search (semantic). Requires LITHTRIX_API_KEY and server-side vector + embedding config.
- **lithtrix_memory_context** — GET /v1/memory/context (importance + recency). Requires LITHTRIX_API_KEY.
- **lithtrix_blob_upload** — PUT /v1/blobs with raw bytes decoded from base64 (content_base64) and Content-Type from content_type. Optional filename query. Use direct HTTP for very large files. Requires LITHTRIX_API_KEY.