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

# MCP server

> Reechee's hosted MCP server - pain points, opportunities and contact reveals for any AI client, on every plan starting with pay-as-you-go.

Reechee runs a hosted [MCP](https://modelcontextprotocol.io) server so any AI client -
Claude, Cursor, Codex, ChatGPT - can pull software-review pain points and opportunities
straight into a conversation or an agent.

```
https://mcp.reechee.io/mcp
```

It speaks **Streamable HTTP**, so there's nothing to install - point your client at the
URL. It's a thin wrapper over the [REST API](https://docs.reechee.io/api-reference/introduction.md), so the data
matches exactly.

Every MCP call is made as a Reechee account: log in from your client (Connected) or send
an API key. Start free, no card needed - pay-as-you-go includes the full toolset.

> [card] [Connect your client](https://docs.reechee.io/mcp/connect-claude.md)
>
> Add the server to Claude, Cursor, or Codex - takes about a minute.

## Connected - log in with your account

Clients that support OAuth (Claude, ChatGPT, Cursor) log you in with your Reechee account
instead of a key. Point them at `https://mcp.reechee.io/mcp` and the client opens the
Reechee login by itself. The older `https://mcp.reechee.io/mcp/auth` URL behaves exactly
the same, so existing setups keep working.

> [!NOTE]
>
> New to Reechee? [Create your account](https://app.reechee.io/auth/sign-up) and finish
> setup first, then connect. Signing up in the middle of Connect leaves your client
> waiting, and you will need to click Connect again.

The client opens a browser, you log in and approve a short "Connect to Reechee" screen, and
it's connected - nothing to paste. You get the full read + action set and the credit tools
(all **sixteen** tools). The consent screen has an optional credit budget; leave it empty
for no limit, or set one to cap what the connection can spend in any 30 days. A team still on a plan from before
pay-as-you-go pricing gets three read tools (`search_products`, a pain-points taste, and
`get_competitors`) until it moves to pay-as-you-go. See [Connect Claude](https://docs.reechee.io/mcp/connect-claude.md)
and the [authentication guide](https://docs.reechee.io/guides/authentication.md#connected-oauth).

## With an API key

Send a key as `Authorization: Bearer rch_live_…` and the same server exposes **sixteen**
tools. `get_pain_points` returns the full report (every theme, quote, and trend), and you
get reads, safe write actions, and credit-spending tools:

| Tool | Args | Tier |
| - | - | - |
| `search_products` | `query?`, `page?`, `page_size?` | Read |
| `get_pain_points` | `product_id` | Read |
| `get_competitors` | `product_id` | Read |
| `list_opportunities` | filters, `page`, `page_size` | Read |
| `get_opportunity` | `opportunity_id` | Read |
| `list_watchlist` | `page`, `page_size` | Read |
| `get_credit_balance` | - | Read |
| `get_account` | - | Read |
| `follow_product` | `product_id` | Action |
| `unfollow_product` | `product_id` | Action |
| `mark_opportunity_viewed` | `opportunity_id` | Action |
| `set_status` | `opportunity_id`, `status` | Action |
| `reveal_reviewer` | `opportunity_id` | Credit (5) |
| `unlock_contact` | `opportunity_id`, `field`, `target?`, `target_id?` | Credit (email 1, phone 2) |
| `unlock_buying_committee` | `opportunity_id` | Credit (0 or 2) |
| `generate_pain_points_report` | `product_id` | Credit (1) |

The point is chaining: *"find new opportunities in my watchlist, unlock the best 3 buyers'
emails, and draft outreach,"* or *"follow the top 5 competitors of Salesforce."*

The MCP tools accept `page_size` from 1 to 50 (the REST API allows up to 100).

`list_opportunities` and `get_opportunity` return both review-sourced opportunities
(software reviews on G2, Capterra, Trustpilot, TrustRadius, SourceForge) and
social-sourced ones (LinkedIn and Reddit mentions) - each row's `source` field says
which. Social sources require a Scale plan or higher.

For review-sourced opportunities, `get_opportunity` includes `review_title`, `pros`,
`cons`, and `general_comments` under `review`. On pricing version 2 these are all
`null` until your team reveals the reviewer, even if the company is already known.
After `reveal_reviewer`, its nested `opportunity.review` and later `get_opportunity`
calls return the full stored fields. Both the tool's structured response and its
human-readable text include the authorized evidence without truncation, so clients
that read only text still receive it. Missing fields stay `null` in structured
output and do not become invented text.

Repeated reviewer reveals return the evidence without another debit. Legacy pricing
version 1 retains access to stored review text before reveal. Organization and source
access rules still apply, and `list_opportunities` does not include these full-review
fields. See the [REST evidence contract](https://docs.reechee.io/api-reference/introduction.md#full-review-evidence).

> [!NOTE]
>
> The four **Credit** tools spend Reechee credits. API keys always run behind a spend
> budget (a safety guardrail against an agent burning your balance): set a
> **spend cap** when you create the key under Settings → API keys. It cannot be added
> later, and a key with no cap gets `403 spend_cap_required`. OAuth [Connect](https://docs.reechee.io/guides/authentication.md#connected-oauth):
> the consent screen has an optional **credit budget**. Leave it empty for no limit, or
> set a number to cap what the connection can spend in any 30 days.

A call without a login or a key is answered `401` with an OAuth discovery challenge,
which is what makes OAuth clients open the login. See
[what pay-as-you-go includes](https://docs.reechee.io/guides/free-vs-paid.md) and the
[authentication guide](https://docs.reechee.io/guides/authentication.md) to create a key.

## Next

> [card] [Claude](https://docs.reechee.io/mcp/connect-claude.md)

> [card] [Cursor](https://docs.reechee.io/mcp/connect-cursor.md)

> [card] [Codex](https://docs.reechee.io/mcp/connect-codex.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.