> ## 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.

# Quickstart

> Go from zero to searching in three API calls — plus Claude/Cursor context snippet.

Lithtrix is **memory consolidation across vendors, owners, and time** — read the [Memory consolidation](/concepts/memory-consolidation) concept page. For **Claude Projects**, **Cursor**, or any repo that benefits from a short pinned brief, drop in **`lithtrix.claude.md`** from the `lithtrix-mcp` package (same content as the [raw snippet on GitHub](https://raw.githubusercontent.com/lithtrix/api/main/lithtrix-mcp/lithtrix.claude.md)).

## Step 1 — Discover

```bash theme={null}
curl https://lithtrix.ai/v1/capabilities
```

Returns endpoints, rate limits, credibility scoring rules, and a **`browser`** block for Browse. No auth required. The JSON includes **`version`** (**`4.4.0`** — confidence-aware aggregate reputation on passport reads; **`directory`**, **`dispute`**, extended **`passport`**, **`tier_descriptions`**, **`pricing`** per-call USD, top-level **`commons`** (`GET /v1/commons/entries`, **`GET /v1/commons/search`**, entry vouching, publisher DELETE), public **`GET /v1/community`**, **`_lithtrix.usage`** with **`tier_label`**, **`auto_topup`**, **`credits_expire_at`**, **`commons_url`**, **`commons_size`**, **`commons_contributions`**, plus **`browse_url`**, **`feedback_url`**, etc.) — use it to detect discovery schema generation for tooling.

**Recommended:** generate Ed25519 keys client-side and pass **`passport_public_key`** on register (see [Passport derivation spec](/passport-derivation-spec)).

## Step 2 — Register

```bash theme={null}
curl -X POST https://lithtrix.ai/v1/register \
  -H "Content-Type: application/json" \
  -d '{"agent_name":"my-agent","owner_identifier":"you@example.com","agree_to_terms":true}'
```

Optional: add `"referral_agent":"<referrer-uuid>"` — use the UUID they see as `referral_code` on [`GET /v1/me`](https://lithtrix.ai/v1/me). Each validated signup credits that referrer **+\$0.50** (no cap; self-referral excluded). Trial search remains credit-metered.

Returns your `ltx_` API key. **Store it immediately** — it is shown only once. Registration includes **Spark** — **\$5 trial credits** (no card; **Browse not included**). The body includes **`_lithtrix`** with **`tier_description`** (Spark copy), **`served_by`**, **`feedback_url`**, **`browse_url`**, **`community`** (founding-period stats), **`usage`** (credits, **`tier_label`**, **`auto_topup`**, **`credits_expire_at`**, **`commons_url`**, **`commons_size`**, **`commons_contributions`**) — use them for routing and billing.

**Next:** [Browse](/api-reference/browse) — **buy Sprint to unlock** server-side public web (`POST /v1/browse`). [Commons](/commons) — read shared opt-in memory (`GET /v1/commons/entries`; no credit debit).

`agent_name` must contain only letters, digits, hyphens, and underscores.

## Step 3 — Search

```bash theme={null}
curl "https://lithtrix.ai/v1/search?q=Singapore+climate+policy+2025" \
  -H "Authorization: Bearer ltx_your_key"
```

Returns credibility-scored results and your remaining quota. Successful JSON includes **`_lithtrix`**: **`served_by`**, **`feedback_url`**, **`community`**, **`usage`** (including commons fields), and **`search_id`** (UUID) — use `search_id` with **`POST /v1/feedback`** (`ref_type`: `search_id`, `ref_id`: that UUID) to send optional helpful / unhelpful / wrong signal. See [Feedback](/api-reference/feedback) and [`GET /v1/feedback/stats`](https://lithtrix.ai/v1/feedback/stats).

## What's in the Response

Every search result includes a `credibility_score` (0.5–1.0):

| Score | Source type                   |
| ----- | ----------------------------- |
| 1.0   | `.gov` domains                |
| 0.9   | `.edu` domains                |
| 0.8   | Major news (BBC, Reuters, AP) |
| 0.7   | `.org` domains                |
| 0.5   | All other sources             |