Compare 2 to 4 startup pitches side by side: scores, traction, raise and decisions
pitchspark_compare_pitches_v1Compare 2 to 4 pitches side by side: ask, stage, sector, HQ region, traction note, green flags, public score, dimension scores (keyed callers, public scores only) and compact decision aggregates (likes vs passes, average rating, top pass reasons; investor API keys only, else reason key_required; each withheld below 5 distinct signed-in users, counts as bands; the likes-vs-passes block may be withheld with reason hidden_pending_review, and the team-related pass reasons are withheld pending review). Use when: an investor is choosing between shortlisted pitches. Do not use for: more than 4 pitches (run pitchspark_search_pitches_v2 sorted by score instead), full pitch text (pitchspark_get_pitch_v2). All ids must be distinct and resolvable: any id that is missing, not public or opted out answers NOT_FOUND for the whole call, and nothing is counted. The whole comparison is delivered or nothing is (a spent allowance answers RATE_LIMITED). Returns {"pitches":[...in the order given], "attribution"}. Each pitch this tool returns counts 1 against the daily pitch allowance (the same allowance as pitchspark_search_pitches_v1), or 0 when the same API key (without a key, the same connection) already got that pitch today. Calls are logged, and each pitch returned is counted as a view.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ids": "<ids>"
},
"name": "pitchspark_compare_pitches_v1"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | 2 to 4 distinct pitch ids. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present only when the call failed (isError true). | |
| pitches | No | ||
| attribution | No |