Investors: save a startup pitch to your PitchSpark saved pitches
pitchspark_watch_pitch_v1For investors: save one startup pitch to the investor's own PitchSpark saved pitches, to come back to it on pitchspark.io. Use when: an investor wants to save, bookmark, watch or shortlist a pitch found through pitchspark_search_pitches_v1 or pitchspark_get_pitch_v1. Do not use for: contacting the founders (use pitchspark_request_intro_v1); reading pitches; anything the investor has not asked for. Requires a PitchSpark API key (psk_...) from an investor account (self-declared; PitchSpark does not verify accreditation), sent as "Authorization: Bearer psk_..." or in the X-API-Key header; calls without a key, with a submit token (pss_...) or with a key from a non-investor account return UNAUTHORIZED. Saving the same pitch again changes nothing. The founders are not contacted. PitchSpark records the save as interest in the pitch, which can appear in the founders' pitch statistics, where investors are numbered and never named. Returns {"status","pitch_id","next_steps"}: status "watching" (saved now), "already_watching" (it was already saved) or "limit_reached" (a free account already holds 10 saved pitches; nothing is saved; Pro is unlimited). An id that does not exist, a pitch that is not public, and a pitch whose founders have opted out of AI agents all answer NOT_FOUND; a pitch the investor owns or is on the team of is INVALID_ARGUMENT. Limits: 100 calls per API key per UTC day (RATE_LIMITED with retry_after_seconds after that), and 30 tool calls per minute per connection. Uses none of the daily pitch allowance. Calls are logged. Errors are JSON {"error":{"code","message","retry_after_seconds"}}: UNAUTHORIZED, INVALID_ARGUMENT, NOT_FOUND, RATE_LIMITED, INTERNAL.
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": {
"pitch_id": "<pitch_id>"
},
"name": "pitchspark_watch_pitch_v1"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pitch_id | Yes | The pitch id, copied exactly from the "id" field of a search or details result: 1 to 64 letters, digits, "_" or "-". Ids are not derived from company names; an id that does not exist answers NOT_FOUND. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present only when the call failed (isError true). | |
| status | No | ||
| pitch_id | No | ||
| next_steps | No |