> ## Documentation Index
> Fetch the complete documentation index at: https://docs.receiptor.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Create an API key, select workspace context, and run your first calls.

## 1. Create an API key

In the app:

1. Open **Account -> API Keys** (`/account/api-keys`).
2. Click **Add New API Key**.
3. Copy the key immediately.

API keys are shown only once after creation.

## 2. List your workspaces

Use the API key to fetch available organizations:

```bash theme={null}
curl -s https://developer.api.receiptor.ai/v1/workspaces \
  -H "Authorization: Bearer $RECEIPTOR_API_KEY"
```

Pick the `orgId` you want to operate in.

## 3. Discover capabilities

```bash theme={null}
curl -s https://developer.api.receiptor.ai/v1/capabilities
```

Use capability `slug` values for execution (for example, `documents.search`).

## 4. Execute a capability with workspace context

```bash theme={null}
curl -s -X POST https://developer.api.receiptor.ai/v1/capabilities/documents.search \
  -H "Authorization: Bearer $RECEIPTOR_API_KEY" \
  -H "X-Receiptor-Org-Id: $RECEIPTOR_ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "uber",
    "limit": 5,
    "outputMode": "compact"
  }'
```

## 5. Run the same flow in CLI

```bash theme={null}
receiptor auth sk_...
receiptor workspace list
receiptor workspace use org_...
receiptor list
receiptor documents search --query "uber" --limit 5
```

## 6. Validate MCP tools

Using your MCP client:

1. Call `initialize`
2. Call `tools/list`
3. Call `tools/call` with a capability tool name such as `documents_search`

## Next

* [API Key Auth](/api/authentication/api-keys)
* [Workspace Context](/api/workspaces/context)
* [Capabilities Overview](/api/capabilities/overview)
* [Live Capabilities Catalog](/api/capabilities/live-catalog)
* [MCP Client Setup](/api/mcp/client-setup)