Read one startup pitch with its score, roast and anonymised decisions
pitchspark_get_pitch_v2Read one startup pitch by id and choose what comes back with "sections": "pitch" (the full public pitch, the same object as pitchspark_get_pitch_v1), "score" (score and roast, as pitchspark_get_score_v1), "decisions" (anonymised decision aggregates by signed-in users, as pitchspark_get_decision_summary_v1). Default: all three. Use when: an investor wants the whole picture of one shortlisted pitch in one call. Prefer the single-purpose tools when you only need one part. Do not use for: searching (pitchspark_search_pitches_v2), founder contact details, financials, decks or data rooms (never returned), investment advice. Anonymous callers can use it under the daily allowance; dimension scores and analyses need an API key, and the decisions section an investor API key. Decision data from signed-in PitchSpark users needs a PitchSpark API key from an investor account (self-declared; PitchSpark does not verify accreditation): without one every decision block is available false with reason key_required. It is anonymised: counts of distinct people only, as bands ("5-9", "10-24", "25-49", "50+"), never who; shares and rates to the nearest 0.05; the pitch's founders, team and PitchSpark staff are never counted; guest and anonymous viewers are never counted; every block is withheld (reason below_min_k) when fewer than 5 distinct people are behind it, and a split (positive vs pass, rating bands) is withheld when any part of it would be under 5; no investor comment text is ever returned. Who is counted: ratings, reading time, sections and score views count ANY signed-in non-owner user (the writers check no account type), and likes, passes and pass reasons count signed-in users who swiped or gave pass feedback (also not restricted to investor accounts); only the caller of this tool must hold an investor key. Some fields are withheld pending a review (reason hidden_pending_review, or absent from a list): the team-related pass reasons and the pass rate (the likes-vs-passes thumbs block, the search card signal, investors_considered and the card-dwell figures). Treat a withheld field as no signal. An id that does not exist, a pitch that is not public and a pitch whose founders opted out of AI agents all answer NOT_FOUND. 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": {
"id": "<id>"
},
"name": "pitchspark_get_pitch_v2"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The pitch id from a search result ("id"). | |
| sections | No | Which parts to return. Default ["pitch","score","decisions"]. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present only when the call failed (isError true). | |
| pitch | No | pitchspark_get_pitch_v1's pitch object (same keys), present when sections includes "pitch". | |
| score | No | ||
| sections | No | ||
| decisions | No | Anonymised decision aggregates by signed-in PitchSpark users (not only investors); readable with investor API keys only (every block reason key_required otherwise). Counts are bands ("5-9", "10-24", "25-49", "50+"); every block is withheld below min_k distinct signed-in users (the counts cover any signed-in non-owner user, not only investor accounts). | |
| attribution | No |