Investors: ask a startup founder for an intro through PitchSpark
pitchspark_request_intro_v1For investors: send the founders of one startup on PitchSpark a request to connect, with a short message, through PitchSpark's own in-app contact flow. Use when: an investor has read a pitch (from pitchspark_search_pitches_v1 or pitchspark_get_pitch_v1) and has asked for an introduction to its founders. Every request is sent in the investor's name, from their account. Do not use for: getting founder contact details (never returned, by this or any tool); founders contacting investors or other founders (contact is investor-initiated only); bulk or unsolicited outreach the investor has not asked for; saving a pitch for later (use pitchspark_watch_pitch_v1). 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. PitchSpark does not verify investors or founders, does not recommend investments and takes no part in any resulting deal. PitchSpark notifies the founder in the app (and by email) and the founder replies inside PitchSpark, in the investor's Mailbox. The reply never comes back through this tool, and no email address, phone number, website, social profile or calendar link of the founder is ever returned. The message reaches the founders as the investor's own words, after the line "Sent via this investor's AI assistant (PitchSpark MCP)."; email addresses (also spelled out), phone numbers, links, IP addresses and @handles are removed (replaced with [email], [phone], [link], [handle]) and it is cut to 1000 characters. Returns {"status","intro_id","next_steps"}: status "requested" (sent), "already_requested" (the investor already has a conversation with these founders; nothing new is sent; follow-ups happen in the PitchSpark Mailbox) or "quota_exhausted" (a free account has used its 3 new founder conversations this calendar month; nothing is sent, intro_id is null; Pro is unlimited). Each new conversation counts against the account's monthly allowance, shared with Contact Founder on pitchspark.io. 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: 5 calls per API key and 5 per account per UTC day (RATE_LIMITED with retry_after_seconds after that), and 30 tool calls per minute per connection. Calls are logged without the message text. 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>",
"message": "<message>"
},
"name": "pitchspark_request_intro_v1"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message | Yes | The investor's note to the founders, in the investor's words: who they are and why they are interested, e.g. "Hi, I lead seed deals in clinic software at a small fund and would love to hear how the pilots are going." Up to 1000 characters are kept. Email addresses, phone numbers, links and @handles are removed before the founder sees it. | |
| 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 | ||
| intro_id | No | ||
| next_steps | No |