MCP Integration

​

Install

npx -y lithtrix-mcp

​

Claude Desktop Config

{
  "mcpServers": {
    "lithtrix": {
      "command": "npx",
      "args": ["-y", "lithtrix-mcp"],
      "env": {
        "LITHTRIX_API_KEY": "ltx_your_key_here"
      }
    }
  }
}

​

Tools

• lithtrix_search — web search. Requires LITHTRIX_API_KEY. Responses include _lithtrix.search_id for correlating feedback.
• lithtrix_feedback — POST /v1/feedback (helpful / unhelpful / wrong). Requires LITHTRIX_API_KEY. Use ref_type + ref_id from a prior search or other operation.
• lithtrix_register — register a new agent. No auth required. Must pass agree_to_terms: true (Gentle-Agent Agreement).
• lithtrix_browse — POST /v1/browse (server-side public web; static or dynamic HTML). Requires LITHTRIX_API_KEY; 20 browses/rolling-30d free on trial, then static 3 credits / dynamic 5 credits per call (D173/D174). See Browse.
• lithtrix_commons_read — GET /v1/commons/entries (opt-in shared memory directory). Requires LITHTRIX_API_KEY. No credit debit for commons reads; rate limits apply. For cross-agent semantic search, call GET /v1/commons/search over HTTPS (no dedicated MCP tool in 0.19.0). See Commons.

• lithtrix_memory_set / lithtrix_memory_get — key-value memory
• lithtrix_memory_search — semantic search (when the API has embeddings configured)
• lithtrix_memory_context — top memories by importance + recency

• lithtrix_blob_upload — PUT /v1/blobs via base64 body + MIME type (suited to small/medium payloads; large files: direct HTTP PUT)
• lithtrix_blob_download — GET /v1/blobs/{blob_id} → JSON with content_base64 + content_type
• lithtrix_blob_list — GET /v1/blobs (optional pagination)
• lithtrix_blob_meta — GET /v1/blobs/{blob_id}/meta
• lithtrix_blob_delete — DELETE /v1/blobs/{blob_id} (soft-delete)
• lithtrix_blob_signed_url — GET /v1/blobs/{blob_id}/signed-url — mints a time-limited HTTPS URL for direct read from storage (optional expires_in)
• lithtrix_blob_parse — POST /v1/blobs/{blob_id}/parse (optional async + callback_url)
• lithtrix_blob_parse_status — GET /v1/blobs/{blob_id}/parse/{parse_id}
• lithtrix_blob_search — GET /v1/blobs/search — semantic search over parsed chunks (shares search quota with web search)

• lithtrix_journal_commit — hash local journal bytes on your host (local_material_base64), then POST /v1/me/journal/commit with only the 32-byte digest. Lithtrix never receives preimage. Requires root LITHTRIX_API_KEY. Schema: GET /mcp/v1/lithtrix-journal-commit.json.

​

Tool Definitions

• GET /mcp/lithtrix-search.json
• GET /mcp/lithtrix-feedback.json
• GET /mcp/lithtrix-register.json
• GET /mcp/lithtrix-browse.json
• GET /mcp/lithtrix-commons-read.json

• GET /mcp/lithtrix-memory-set.json
• GET /mcp/lithtrix-memory-get.json
• GET /mcp/lithtrix-memory-search.json
• GET /mcp/lithtrix-memory-context.json

• GET /mcp/lithtrix-blob-upload.json
• GET /mcp/lithtrix-blob-download.json
• GET /mcp/lithtrix-blob-list.json
• GET /mcp/lithtrix-blob-meta.json
• GET /mcp/lithtrix-blob-delete.json
• GET /mcp/lithtrix-blob-signed-url.json
• GET /mcp/lithtrix-blob-parse.json
• GET /mcp/lithtrix-blob-parse-status.json
• GET /mcp/lithtrix-blob-search.json

• GET /mcp/v1/lithtrix-journal-commit.json (legacy alias under /mcp/lithtrix-journal-commit.json)