> ## 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 - free pain-points answers for any AI client, and a full paid toolset for your agents.
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](/api-reference/introduction), so the data
matches exactly.
## Start free - no key
Anonymous clients get three tools, no signup required. Ask a question like:
> What are people unhappy about with Zendesk lately?
and the agent resolves the product and reads its pain points, answering from real review
data with a pointer to the full report on Reechee.
| Tool | Args | What it does |
| ----------------- | ------------ | ---------------------------------------------------------- |
| `search_products` | `query` | Resolve a product name to a product `id`. |
| `get_pain_points` | `product_id` | Top pain-point themes + a couple of quotes (a free taste). |
| `get_competitors` | `product_id` | Category alternatives, each with a pain headline. |
Add the server to Claude, Cursor, or Codex - takes about a minute.
## Connect with your account - no key
Clients that support OAuth (like Claude) can log you in with your Reechee account instead
of a key. Point them at:
```
https://mcp.reechee.io/mcp/auth
```
The client opens a browser, you log in and approve a short "Connect to Reechee" screen, and
it's connected - nothing to paste. The tools follow your team's **current plan**: a free
team stays on the 3-tool taste (now tied to your account), a paid team gets the full read +
action set (**twelve** tools) - or all **sixteen** if you allow an optional credit budget
on the consent screen. Without a budget a connected client can never spend your credits.
See [Connect Claude](/mcp/connect-claude) and the
[authentication guide](/guides/authentication#connect-oauth).
## Go further with a key
Send a paid-team key as `Authorization: Bearer rch_live_…` and the same server exposes
**sixteen** tools. `get_pain_points` returns the *full* report when keyed (every theme,
quote, and trend), and you gain reads, safe write actions, and credit-spending tools:
| Tool | Args | Tier |
| ----------------------------- | ---------------------------------------------------------- | ---------------------------- |
| `search_products` | `query` | Free |
| `get_pain_points` | `product_id` | Free taste / full when keyed |
| `get_competitors` | `product_id` | Free |
| `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 |
| `unlock_contact` | `opportunity_id`, `field`, `target?`, `target_id?` | Credit (1) |
| `unlock_buying_committee` | `opportunity_id` | Credit (0-1) |
| `generate_pain_points_report` | `product_id` | Credit (1) |
| `generate_pitch` | `opportunity_id`, `channels?`, `product_url?`, `features?` | 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."*
`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.
The four **Credit** tools spend Reechee credits, so they always run behind a spend
budget (a safety guardrail against an agent burning your balance). API keys: set a
**spend cap** when you create the key under Settings → API keys - a key with no cap
gets `403 spend_cap_required`. OAuth [Connect](/guides/authentication#connect-oauth):
allow an optional **credit budget** on the consent screen - a connection without one
lists twelve tools and cannot spend.
See the [free-vs-paid](/guides/free-vs-paid) breakdown and the
[authentication guide](/guides/authentication) to create a key.
## Next