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

# Quickstart

> Connect the free MCP and make your first API call in under a minute. No key required.

The free tier is anonymous - no signup, no key. Pick whichever path fits your tool.

## From an AI client (MCP)

The MCP endpoint is `https://mcp.reechee.io/mcp` (streamable HTTP).

<Steps>
  <Step title="Add the server">
    **Claude Code**

    ```bash theme={null}
    claude mcp add --transport http reechee https://mcp.reechee.io/mcp
    ```

    **Cursor** - add to `~/.cursor/mcp.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "reechee": { "url": "https://mcp.reechee.io/mcp" }
      }
    }
    ```

    Other clients (Claude Desktop, ChatGPT, Codex) point at the same URL - the
    per-client steps live in the [MCP quickstarts](/mcp/overview).
  </Step>

  <Step title="Ask a question">
    > What are people unhappy about with Zendesk lately?

    The agent calls `search_products`, then `get_pain_points`, and answers from real
    review data - with a pointer to the full report on Reechee.
  </Step>
</Steps>

## From the REST API

No key needed for the free reads. First resolve a product name to an `id`:

```bash theme={null}
curl "https://app.reechee.io/api/v1/products?query=slack"
```

```json theme={null}
{
  "success": true,
  "data": [
    {
      "id": "4fddd655-30b8-420b-a506-a7a4a47e0a65",
      "name": "Slack",
      "by": "Slack",
      "categories": ["Business Instant Messaging", "Team Collaboration"]
    }
  ],
  "meta": { "pagination": { "page": 1, "page_size": 20, "has_more": true } }
}
```

Then read that product's free pain-points taste - the top themes, a couple of quotes,
and a pointer to the full report:

```bash theme={null}
curl "https://app.reechee.io/api/v1/products/4fddd655-30b8-420b-a506-a7a4a47e0a65/pain-points"
```

```json theme={null}
{
  "success": true,
  "data": {
    "summary": "Across 301 Slack reviews (91 recent)…",
    "themes": [
      {
        "category_name": "Notification Overload & Poor Message Prioritization",
        "trend": "trending",
        "total_mentions": 29,
        "quotes": [{ "quote_text": "it can become incredibly noisy…" }]
      }
    ],
    "total_themes": 12
  },
  "meta": {
    "upsell": "Get the full pain-points report, with every theme, quote, and trend, at https://reechee.io"
  }
}
```

## Unlock the paid tools

Paid teams get an API key for opportunities, full pain-point reports, watchlist, credit
balance, and safe write actions (follow/unfollow, triage).

<Steps>
  <Step title="Create a key">
    In the app, open **Settings → API keys** and create one. Copy it once - it looks
    like `rch_live_…` and is shown only at creation.
  </Step>

  <Step title="Send it as a bearer token">
    ```bash theme={null}
    curl "https://app.reechee.io/api/v1/opportunities" \
      -H "Authorization: Bearer rch_live_your_key_here"
    ```

    The same key, sent as `Authorization: Bearer …` to the MCP server, switches the
    MCP from 3 free tools to the full paid tool set.
  </Step>
</Steps>

<Card title="Get your API key" icon="key" href="https://app.reechee.io/settings/api-keys">
  Settings → API keys (paid teams: Starter and up).
</Card>