Metadata-Version: 2.5
Name: reachant-mcp
Version: 0.1.0
Summary: MCP server for Reachant: prospect Google Places leads from Claude, Cursor and other MCP clients.
Project-URL: Homepage, https://reachant.com
Author: Reachant
License: MIT
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp<2,>=1.2
Description-Content-Type: text/markdown

# reachant-mcp

MCP server for [Reachant](https://reachant.com): find and enrich Google Places business
leads from Claude Desktop, Claude Code, Cursor or any MCP client.

## Setup

1. In Reachant, open **Settings → Integrations** and generate an API key.
2. Install [uv](https://docs.astral.sh/uv/getting-started/installation/).
3. Add the server to your client.

**Claude Desktop** (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "reachant": {
      "command": "uvx",
      "args": ["reachant-mcp"],
      "env": { "REACHANT_API_KEY": "rk_..." }
    }
  }
}
```

**Claude Code:** `claude mcp add reachant -e REACHANT_API_KEY=rk_... -- uvx reachant-mcp`

**Cursor** (`.cursor/mcp.json`): same JSON as Claude Desktop.

Then ask your assistant: *"What is my Reachant balance?"*

## Tools

`get_account_status`, `list_categories`, `estimate_search`, `run_search`, `get_search`,
`list_searches`, `list_leads`, `get_lead`, `export_leads_csv`.

Searches spend your plan's leads and credits. `run_search` only accepts a token from
`estimate_search`, so your assistant must show you the price and get your yes first.

## Environment

- `REACHANT_API_KEY` — required.
- `REACHANT_API_URL` — optional, default `https://app.reachant.com`.

## Release (maintainers)

```bash
cd reachant-mcp
uv build
UV_PUBLISH_TOKEN=pypi-... uv publish
```
