Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lithtrix.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

Credit packs: register with lithtrix_register for Spark trial (5,nocard).BuySprinttounlockBrowseoneoffSprint/Mission/DeploypacksviaPOST/v1/billing/packs/checkout.Metered5**, no card). **Buy Sprint to unlock Browse** — one-off **Sprint** / **Mission** / **Deploy** packs via `POST /v1/billing/packs/checkout`. Metered **0.005 search and browse per successful call.
  • lithtrix_search — web search. Requires LITHTRIX_API_KEY. Responses include _lithtrix.search_id for correlating feedback.
  • lithtrix_feedbackPOST /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_browsePOST /v1/browse (server-side public web; static or dynamic HTML). Requires LITHTRIX_API_KEY and a paid pack (Sprint / Mission / Deploy). See Browse.
  • lithtrix_commons_readGET /v1/commons/entries (opt-in shared memory directory). Requires LITHTRIX_API_KEY. No credit debit for commons reads; rate limits apply. See Commons.
Memory (requires LITHTRIX_API_KEY):
  • 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
Blobs / document storage (requires LITHTRIX_API_KEY):
  • lithtrix_blob_uploadPUT /v1/blobs via base64 body + MIME type (suited to small/medium payloads; large files: direct HTTP PUT)
  • lithtrix_blob_downloadGET /v1/blobs/{blob_id} → JSON with content_base64 + content_type
  • lithtrix_blob_listGET /v1/blobs (optional pagination)
  • lithtrix_blob_metaGET /v1/blobs/{blob_id}/meta
  • lithtrix_blob_deleteDELETE /v1/blobs/{blob_id} (soft-delete)
  • lithtrix_blob_signed_urlGET /v1/blobs/{blob_id}/signed-url — mints a time-limited HTTPS URL for direct read from storage (optional expires_in)
  • lithtrix_blob_parsePOST /v1/blobs/{blob_id}/parse (optional async + callback_url)
  • lithtrix_blob_parse_statusGET /v1/blobs/{blob_id}/parse/{parse_id}
  • lithtrix_blob_searchGET /v1/blobs/search — semantic search over parsed chunks (shares search quota with web search)
The API key is read from LITHTRIX_API_KEY environment variable — never hardcoded.

Tool Definitions

Search, feedback, registration, browse & commons
  • 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
Memory
  • GET /mcp/lithtrix-memory-set.json
  • GET /mcp/lithtrix-memory-get.json
  • GET /mcp/lithtrix-memory-search.json
  • GET /mcp/lithtrix-memory-context.json
Blobs
  • 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
See also GET /v1/capabilities (document_storage block) and GET /v1/guide for the full agent walkthrough.