# Cauldron Cloud — MCP Server

Connects Claude Desktop (or any MCP client) to the Cauldron M&A portal.

## Quick setup — 3 commands

```bash
git clone https://git.zerotohero.it/Spaike/cauldron-mcp.git
cd cauldron-mcp
python setup.py
```

The wizard will:
1. Create a local `.venv` virtual environment (no system-level changes)
2. Install dependencies into it
3. Open the browser to the API Keys page on the portal
4. Read the key you paste into the terminal
5. Write `claude_desktop_config.json` without touching your other settings

Then restart Claude Desktop — done.

---

## Manual setup

### Requirements

- Python 3.10+
- pip

### Install dependencies

```bash
python -m venv .venv

# Mac / Linux
source .venv/bin/activate
# Windows
.venv\Scripts\activate

pip install mcp httpx
```

### Get your API key

Go to the Cauldron portal → user menu → **API Keys** → click **Generate**.  
Your key looks like: `cldrn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`

> The key is shown **once only**. Store it somewhere safe.

### Configure Claude Desktop

Open the config file:

- **Mac**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Linux**: `~/.config/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

Add the `mcpServers` block:

```json
{
  "mcpServers": {
    "cauldron": {
      "command": "/absolute/path/to/cauldron-mcp/.venv/bin/python",
      "args": ["/absolute/path/to/cauldron-mcp/server.py"],
      "env": {
        "CAULDRON_API_KEY": "cldrn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}
```

Restart Claude Desktop.

---

## Available tools

| Tool | Description |
|---|---|
| `get_my_profile` | Your user profile and firm |
| `list_deals` | List deals with filters (type, stage, industry, country, free text) |
| `get_deal_detail` | Full detail of a single deal |
| `deal_statistics` | Aggregated stats grouped by stage, industry, year, month, country, etc. |
| `list_my_requests_for_help` | Requests for Help sent by your firm to the network |
| `list_incoming_requests` | Incoming RFH from other firms (filterable by unanswered) |
| `list_rfh_suggestions` | Suggestions submitted for a specific Request for Help |
| `rfh_statistics` | Aggregated RFH activity stats (response rates, top responders, etc.) |
| `list_members` | Network professionals (filter by sector, country, job title, firm) |
| `get_member_detail` | Full profile of a single network member |
| `list_deal_stages` | Available deal stages |
| `list_industries` | Industry classifications |
| `list_firms` | Firms visible to your account (with summary, countries, equity partner) |
| `get_deals_rich` | Full deal dataset including tombstone narrative, fee structure, multiples, attachments list |

---

## Example questions for Claude

```
"Show me all open Sell Side deals in the Automotive sector"

"How many deals did we close in 2024, broken down by industry?"

"Are there any Requests for Help we haven't answered yet?"

"Give me the full detail of deal #142"

"What shared network deals are in the Technology sector?"

"Show deal statistics by month from 2023 to today"

"Who in the network covers Healthcare deals in Germany?"

"How is our firm performing on incoming Requests for Help?"
```