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

# Quickstart

> From nothing to answering questions about your reviews, in about two minutes.

## Connect an assistant

The fastest path needs no key at all.

<Steps>
  <Step title="Add the server">
    ```bash theme={null}
    claude mcp add --transport http reputably https://app.reputably.net/api/mcp
    ```

    On a white-label domain, use your own domain instead.
  </Step>

  <Step title="Sign in">
    Run `/mcp` inside Claude Code and choose **Authenticate**. A browser opens, you approve
    once, and the connection persists.
  </Step>

  <Step title="Ask something">
    > Which of my locations have reviews still waiting on a reply?

    > Show me leads from the last 7 days, strongest buying signal first.

    > Do AI assistants mention us when someone asks for a physio in Newcastle?
  </Step>
</Steps>

If the first answer looks empty, you are probably reading the wrong workspace. See
[Workspaces](/guides/workspaces).

Other clients, including Claude Desktop, Codex and Cursor, are on
[Connect your assistant](/mcp/connect).

## Call the API

<Steps>
  <Step title="Create a key">
    Sign in, open **Settings → API & MCP** and create an agent key. Copy it now; it is shown
    once.
  </Step>

  <Step title="Make a request">
    Every operation is a `POST` with a JSON body.

    ```bash theme={null}
    curl https://app.reputably.net/api/functions/listLeadsWithMentions \
      -H "Authorization: Bearer rpk_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{"stage":"new","limit":10,"sort":"intent"}'
    ```
  </Step>

  <Step title="Read entities directly">
    Generic reads are also available, filtered by a JSON query.

    ```bash theme={null}
    curl -G https://app.reputably.net/api/entities/Review \
      -H "Authorization: Bearer rpk_your_key_here" \
      --data-urlencode 'q={"needs_response":true}' \
      --data-urlencode 'limit=25'
    ```
  </Step>
</Steps>

The full surface is in the [API reference](/api-reference/introduction).

## Paging

Every list takes `skip` alongside `limit` (`list_mentions` takes `page`). Anything past the
first page is reachable only by asking for it, so a tool that returns exactly `limit` rows
is usually not the whole set. Ask for the next page before concluding you have everything.