110 lines
2.8 KiB
Markdown
110 lines
2.8 KiB
Markdown
# 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. Install dependencies automatically
|
|
2. Open the browser to the API Keys page on the portal
|
|
3. Read the key you paste into the terminal
|
|
4. 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
|
|
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": "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 |
|
|
|
|
---
|
|
|
|
## 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?"
|
|
```
|