---
title: Quickstart, MCP
description: Add the looot MCP server to Claude Code, sign in with the browser, check your balance, search the catalog and run a job with fallback.
---

This walks Claude Code through the browser sign-in flow. Other clients follow the same shape;
see [Connect your agent](/connect) for ChatGPT, Cursor, Codex, VS Code and more.

1. **Add the server**

    ```bash
    claude mcp add --scope user --transport http looot https://api.looot.ai/mcp
    ```

2. **Sign in**

    ```bash
    claude mcp login looot
    ```

    A browser opens on looot.ai. Pick your organization and click **Connect**. The client keeps
    its own token and renews it in the background; you never copy a key.

3. **Check your balance**

    Ask the agent to check the balance, or call the [`balance`](/mcp-tools/balance) tool directly. A new workspace
    starts at $0. `balance` returns `topUpLink` with the minimum top-up. See
    [Before your first run](/money#before-your-first-run).

4. **Top up**

    Call the [`top_up`](/mcp-tools/top-up) tool (`amountUsd` is optional) to get a Stripe Checkout link, or pay at
    [looot.ai/usage?top_up=1](https://looot.ai/usage?top_up=1). looot never sees your card and the
    agent never enters card details.

5. **Search the catalog**

    Call [`search`](/mcp-tools/search) with a plain-English query, for example "verify an email address". It returns
    endpoint ids, providers, prices and each row's `access` (`runs_now`, `needs_your_account` or
    `coming_soon`).

6. **Run a job with fallback**

    Call [`run`](/mcp-tools/run) with `endpointId: "job:<job id>"`, your `input`, a fresh [`idempotencyKey`](/concepts/idempotency), and
    `fallback: true`. looot picks the first provider of that job it can run for your workspace,
    and with `fallback` set, moves to the next one of the same job if the first misses. The run
    carries `requestedJob` (which provider was picked and why) and, with fallback, `route`
    (every attempt tried and what happened).

## Next

[MCP tools](/mcp-tools) documents all 15 customer tools. [Jobs](/concepts/jobs) and
[Fallback](/concepts/fallback) explain the job-run and fallback behavior in full.

<Related />