Founders only: create a draft of your own startup pitch on PitchSpark
pitchspark_submit_pitch_v1For founders: create a DRAFT startup pitch on the signed-in founder's own PitchSpark account from five facts: company name, sector, funding stage, the amount being raised in US dollars, and a one-paragraph problem statement. Use when: only when a founder explicitly asks to create a draft of their own pitch and has given you a PitchSpark submit token (pss_...). Do not use for: investors; searching or reading pitches (use pitchspark_search_pitches_v1 and pitchspark_get_pitch_v1); anything the founder has not explicitly asked for. Requires a PitchSpark submit token: the founder generates one in PitchSpark Settings (Submit tokens), copies it once and gives it to the assistant, which sends it as the header "Authorization: Bearer pss_...". A submit token works only for this tool and only creates drafts; it expires 30 days after it is created and the founder can revoke it in Settings at any time. PitchSpark API keys (psk_...) and sign-in session tokens are refused, and there are no anonymous submissions. The draft is not listed, searchable (through this server or on PitchSpark) or scored until the founder completes it and submits it for review in Pitch Studio, at the edit_url returned. One call creates at most one pitch, subject to the account's pitch limit; a company the founder already has a pitch for is refused rather than listed twice. Nothing else changes: no score, feedback or existing pitch is touched and no email is sent. The tagline is the first sentence of the problem statement (at most 100 characters); the founder can change it in Pitch Studio. Returns {"pitch_id","status":"draft","company_name","edit_url"}. Limits: 5 submissions per account per hour, and 30 tool calls per minute per connection. Errors are JSON {"error":{"code","message","retry_after_seconds"}}: UNAUTHORIZED (no submit token, or one that is unknown, revoked or expired, or an API key or session token was sent instead; the message says how to get a submit token and how to sign up at pitchspark.io), INVALID_ARGUMENT, CONFLICT (the founder already has a pitch for this company), PITCH_LIMIT_REACHED (the account's pitch limit is reached), RATE_LIMITED (with retry_after_seconds), INTERNAL. Calls are logged without the company name, the problem statement or the token.
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": {
"company_name": "<company_name>",
"sector": "<sector>",
"stage": "<stage>",
"raise_amount_usd": "<raise_amount_usd>",
"problem_statement": "<problem_statement>"
},
"name": "pitchspark_submit_pitch_v1"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| stage | Yes | The funding stage of the round being raised. One of: pre_seed, seed, series_a, series_b, series_c, bridge_mezzanine, growth, acquisition. Example: "seed". | |
| sector | Yes | The startup's primary sector. One of: fintech, healthtech, saas, marketplace, ai_ml, consumer, enterprise, climate, edtech, crypto, biotech, hardware, gaming, real_estate, food_beverage, fashion, travel, sports, media, femtech, cybersecurity, dev_tools, ecommerce, logistics, mobility, hr_tech, legal_tech, insurtech, proptech, agtech, energy, robotics, govtech, hospitality, other. Common names like "AI", "climate tech" or "web3" are accepted, as in search; anything else is rejected. Example: "fintech". | |
| company_name | Yes | The startup's name, 1 to 120 characters on one line, e.g. "Acme Robotics". | |
| raise_amount_usd | Yes | The amount being raised in this round, in US dollars: more than 0, at most 10000000000. Example: 1500000 for $1.5M. | |
| problem_statement | Yes | One paragraph, 40 to 1200 characters, on the problem the startup solves and for whom. No blank lines: a single line break is joined into a space, a second paragraph is rejected. Its first sentence becomes the pitch's tagline. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present only when the call failed (isError true). | |
| status | No | ||
| edit_url | No | ||
| pitch_id | No | ||
| company_name | No |