Search pre-seed and seed startup pitches by meaning
pitchspark_search_pitches_v3Find pre-seed and seed startups that are actively raising by what the investor means, not only the words used (e.g. "software that helps independent clinics get paid faster" finds revenue-cycle and payments pitches that never say "get paid"). Use when: an investor describes the kind of company they want in their own words (a problem, a customer, a business model) rather than exact keywords. Prefer it over pitchspark_search_pitches_v2 for descriptive queries; use pitchspark_search_pitches_v2 to sort by score, recency or views. Do not use for: reading one pitch in depth (pitchspark_get_pitch_v2), founder contact details, decks or data rooms (never returned), investment advice. The filters (sector, stage incl. "early", HQ region, raise range, minimum public score, traction, green flags, listed or updated within N days) narrow the list first; the query then ranks what is left. Ranking uses embeddings when they are available (similarity blended with the public score and recency) and falls back to the keyword + synonym ranker of pitchspark_search_pitches_v2 when they are not. Every reply states which in "search_mode" (semantic, mixed or keyword_fallback) with "fallback_reason". Returns the same lightweight cards as pitchspark_search_pitches_v2, "page" (cursor paging) and "coverage". Email addresses and phone numbers are removed from the query before it is used. 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. Errors are JSON {"error":{"code","message","category","retryable"}}: INVALID_ARGUMENT, UNAUTHORIZED, 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": {
"query": "<query>"
},
"name": "pitchspark_search_pitches_v3"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Page size. A value above the caller's tier ceiling is reduced to it. | |
| query | Yes | What the investor is looking for, in plain language, 1 to 500 characters. Ranked by meaning when semantic ranking is available, by keyword + synonym otherwise (search_mode says which). | |
| stage | No | Funding stage or list. "early" means pre_seed, seed and series_a. | |
| cursor | No | page.next_cursor from the previous call with the SAME query and filters. | |
| sector | No | Sector key or list of up to 10 (primary or additional sector). Keys: 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. | |
| location | No | HQ region key or list: us, canada, latam, uk, europe, mea, apac, global_remote. | |
| min_score | No | Public PitchSpark score at least this (values under 70 are read as 70; pitches without a public score are left out). | |
| green_flags | No | Traction signal: at least one of these founder-chosen green flags (e.g. "Profitable", "Signed LOI"). | |
| has_traction | No | Traction signal: true = only pitches with a public traction note. | |
| max_raise_usd | No | Raise at most this many US dollars (disclosed asks only). | |
| min_raise_usd | No | Raise at least this many US dollars (disclosed asks only). | |
| created_within_days | No | Recency: listed on PitchSpark within this many days. | |
| updated_within_days | No | Recency: pitch updated within this many days. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| error | No | Present only when the call failed (isError true). | |
| pitches | No | ||
| coverage | No | ||
| truncated | No | ||
| attribution | No | ||
| search_mode | No | How this reply was ranked: semantic (by meaning), mixed (by meaning, then keyword matches among pitches without a current embedding) or keyword_fallback (keyword + synonym matching, as pitchspark_search_pitches_v2). | |
| fallback_reason | No | Why the reply is not fully semantic; null when search_mode is semantic. |