MCP server exposing PE/VC deal tools (waterfall, exit, secondary, CV, teaser) to Claude/ChatGPT
Three tools with complete input schemas and descriptions. Tool naming follows verb_noun pattern (dealdesk_run_*, dealdesk_fund_*, dealdesk_price_*). Descriptions are substantive (100-200 chars) and explain the financial domain clearly. All parameters have types and descriptions with constraints. However, output schemas are documented only in docstrings, not formally in the tool registration. Error handling is minimal, no recovery guidance or categorization. Missing parameter validation examples and no guidance on when to use each tool vs. alternatives.
Compute fund performance metrics from a cash-flow stream.
Price a secondary sale of an LP fund interest at a discount/premium to NAV.
Run a PE/VC distribution waterfall and compute LP/GP splits and carry. Distributes total_proceeds through the standard 4-tier waterfall: (1) return of capital, (2) preferred return, (3) GP catch-up, (4) carry split.
Output schemas documented only in docstrings, not in tool registration. LLMs cannot parse docstring schemas, they need formal JSON Schema in the response_schema field or explicit field descriptions in the tool definition.
No error handling or recovery guidance. Tools return raw exceptions (e.g. 'Error: ValueError: ...') without actionable next steps. LLMs cannot determine if errors are retryable, user-fixable, or fatal.
Parameter constraints are present (gt=0, ge=0, lt=1) but not explained in descriptions. E.g., 'gp_commitment_pct' has constraint 'ge=0, lt=1' but description does not state 'must be between 0 and 1 (exclusive)'. LLMs may not parse JSON Schema constraints.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 56 | 2026-07-28+ | v2 |
Tool descriptions lack context on when to use each tool vs. alternatives. E.g., dealdesk_fund_metrics and dealdesk_run_waterfall both compute fund performance, the description should clarify which to call first or when each applies.
No pagination or result limits documented. dealdesk_fund_metrics accepts an array of cashflows with no stated max length. Unbounded arrays risk context window exhaustion.