Spaike
/
cauldron-mcp
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
MCP server for Cauldron Cloud — connect Claude Desktop to the Cauldron M&A portal
3 Commits 1 Branch 0 Tags 62 KiB
Python 100%
Go to file
Spaike d82d81c85a fix: use local venv instead of system pip 
Avoids 'externally managed environment' errors on Mac (Homebrew Python 3.12+)
and permission issues on Linux. setup.py now creates .venv inside the repo,
installs into it, and points claude_desktop_config.json to the venv Python.
Added .gitignore to exclude .venv and __pycache__.
 		2026-05-11 16:28:29 +02:00
.gitignore fix: use local venv instead of system pip 2026-05-11 16:28:29 +02:00
README.md fix: use local venv instead of system pip 2026-05-11 16:28:29 +02:00
requirements.txt Cauldron Cloud MCP Server — initial release 2026-05-08 17:24:29 +02:00
server.py feat: add get_deals_rich tool, enrich list_firms 2026-05-08 17:42:04 +02:00
setup.py fix: use local venv instead of system pip 2026-05-11 16:28:29 +02:00

README.md

Cauldron Cloud — MCP Server

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

Quick setup — 3 commands

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

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:

{
  "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?"