Kruncher MCP Server

The Kruncher MCP server lets AI assistants interact with your deal flow, portfolio companies, and analysis data through the Model Context Protocol . Instead of making REST calls manually, your AI assistant gets direct access to Kruncher tools.

Capabilities

The MCP server exposes the following tools to AI assistants.

Read Tools

Tool	Description
`search_companies`	Search your pipeline by name, industry, or keyword
`list_projects`	List and filter companies with pagination, stage, country, industry, funding stage, business model, and score outcomes
`get_report`	Get the full company analysis report with optional section filtering (chapters, votes, deal score, what’s new, events, KPIs, red flags, investments)
`get_report_sections`	List available report section keys (useful for filtering `get_report`)
`get_filters`	Get pipeline configuration, filter options, and counts (stages, industries, countries, owners, lists, score outcomes)

Write Tools — Immediate

Execute on call.

Tool	Description
`add_comment`	Add a note to any company in your pipeline
`save_insight`	Save an AI-generated insight to a company’s activity log (tagged “AI Insight”)
`edit_chapter_row`	Edit a single row inside a completed analysis report
`create_company`	Add a new company — bookmark, analyze from website, or analyze with uploaded documents/notes (1 credit for full analysis, 15–20 min)

Write Tools — Confirm Required

Consume credits or kick off async work. Called without confirm: true, return a dry-run preview. Called with confirm: true, execute.

Tool	Description
`generate_document`	Generate a DOCX or PPTX from a company’s analysis using a saved template (async; download link appears once status flips to `saved`)

Claude

Claude.ai (Web & Mobile)

Go to claude.ai → Settings → Connectors
Click Add custom connector
Enter the MCP server URL: https://mcp.kruncher.ai/mcp
Click Add
You’ll be redirected to log in with your Kruncher account
After authentication, Kruncher tools appear in your conversations

To use in a conversation: click + near the composer, select Connectors, and enable Kruncher.

If Dynamic Client Registration (DCR) is not enabled, expand Advanced Settings when adding the connector and enter the OAuth Client ID from the Kruncher Settings page (leave Client Secret empty).

Connectors added on the web are automatically available on Claude mobile.

ChatGPT

ChatGPT connects to the Kruncher MCP server natively via the Apps system. ChatGPT discovers all OAuth configuration automatically from the server’s .well-known endpoints — no manual auth URL or client ID configuration needed.

Setup

Go to ChatGPT → Settings → Apps & Connectors
Open Advanced settings
Toggle Developer Mode on (Team/Enterprise: workspace admin must enable this in Workspace Settings → Permissions & Roles)
Click Create and fill in:

Field	Value
Connector name	Kruncher
Description	Search your deal pipeline, analyze companies, view investment reports, and manage your Kruncher portfolio.
Connector URL	`https://mcp.kruncher.ai/mcp`

ChatGPT will discover OAuth configuration automatically
Click Save

Testing

Start a new chat in ChatGPT
Click + near the composer → More → select Kruncher
Try: "Show me my pipeline" — should trigger the list_projects tool
On first use, you’ll be redirected to log in with your Kruncher account

Official Connectors

Official Kruncher connectors for the Claude Connector Directory and ChatGPT App Store are currently under review by Anthropic and OpenAI respectively. Once approved, users will be able to connect with a single click without any configuration.

In the meantime, use the custom connector setup described above.

Authentication

The MCP server uses OAuth 2.1 with PKCE via Auth0 for user authentication. When connecting from Claude.ai or ChatGPT, users are redirected to the Kruncher login page to authenticate with their account. The resulting JWT is used for all subsequent tool calls.

Auth server: https://auth.kruncher.ai
Flow: Authorization Code with PKCE (no client secret required)
Token: JWT with audience https://api.kruncher.ai

This is the same login flow used in the Kruncher web app — users authenticate with their email.

Coming Soon: API Key Authentication

For agent-to-agent integration (automated pipelines, background workers, scheduled tasks), we will release API key authentication for the MCP server. This will work the same way as the Integration API keys — generate a key in Kruncher Settings and pass it directly without an OAuth login flow.

Usage Examples

Once connected, ask your AI assistant naturally:

CODE

"Show me all projects in my pipeline"
"Search for fintech companies"
"Get the full analysis report for Acme Corp"
"Create a new project for TechStartup Inc with website techstartup.com"
"Add a comment to Acme Corp: Followed up via email"
"What's the revenue growth for companies in my portfolio?"

Troubleshooting

Issue	Solution
Tools not appearing	Restart your MCP client and check logs
Connection timeout	Some operations (research, chat) take up to 120 seconds
Auth token expired	Disconnect and reconnect the connector to get a fresh token
Claude connector fails	Verify `https://mcp.kruncher.ai/mcp` is accessible
ChatGPT connection fails	Verify MCP server is running and CORS allows `chatgpt.com`