Get a startup pitch's PitchSpark AI score, dimension scores and roast commentary
pitchspark_get_score_v1Get PitchSpark's AI pitch score for one pitch: the composite (0-100), the six dimensions (market, problem, traction, moat, financials, team, each 0-100 with the model's analysis) and the Roast Room commentary when the pitch was roasted. Use when: an investor asks how PitchSpark rates a pitch, or where it is strong and weak. Prefer it over pitchspark_get_pitch_v2 when only the score is needed. Do not use for: scoring your own text (pitchspark_roast_text_v1, when enabled), what signed-in users decided (pitchspark_get_decision_summary_v1), investment advice. Limits of the data: scores are published only at 70 or above; below that pitchspark_score is null and the dimensions are withheld (dimensions_withheld "not_public"): null means no public score, not a low one. Dimensions and analyses need an API key (dimensions_withheld "key_required" without one). Roast text is filtered for personal attacks and contact details. Same access as pitchspark_get_pitch_v1: anonymous callers allowed under the daily allowance. Returns {"score":{pitch_id, company_name, pitchspark_score, scale, public_min, dimensions, dimensions_withheld, scoring_version, scored_at, roast}, "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": {
"id": "<id>"
},
"name": "pitchspark_get_score_v1"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The pitch id from a search result ("id"). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present only when the call failed (isError true). | |
| score | No | ||
| attribution | No |