Search pre-seed, seed and early-stage startup pitches with filters, sorting and paging
pitchspark_search_pitches_v2Search founder-submitted startup pitches on PitchSpark with structured filters, five sort orders and cursor paging, returning lightweight cards with the public score, the top two score dimensions and a pass-rate signal (currently withheld pending review). Use when: building or paging through a filtered deal-flow list (stage, raise range, sector, HQ region, traction signals, score floor, recency), or sorting by score, recency, investor views or updates. Prefer it over pitchspark_search_pitches_v1 when you need paging, sorting or recency; pitchspark_search_pitches_v1 stays available unchanged. Do not use for: reading one pitch in depth (pitchspark_get_pitch_v2), score detail (pitchspark_get_score_v1), decision detail from signed-in users (pitchspark_get_decision_summary_v1), founder contact details, decks or data rooms (never returned), investment advice. How search works: rule-based keyword + synonym ranking over the founders' public text; there is NO semantic or embedding search yet, so concrete words work better than abstract ones. query is optional: filters alone list every match. Paging: limit (default 10; the ceiling is 10 without a key or with a free key and 25 with a paid key) and either cursor (from page.next_cursor) or offset; results stop at offset 200. Unlike pitchspark_search_pitches_v1, pitches seen before are not left out (paging needs a stable list). Returns "pitches" (each card: the pitchspark_search_pitches_v1 card keys, plus pitchspark_score (public only, 70+, else null), top_dimensions (the two strongest of the six score dimensions, 0-100, keyed callers only and only when the score is public, else null), decision_signal ({available, reason, decisions_band, pass_rate, min_k}: likes vs passes by signed-in users from stored counters, for investor API keys only (reason key_required otherwise), withheld unless there are at least 5 decisions and the likes and the passes are each 0 or at least 5; the pass rate is currently hidden pending review: reason hidden_pending_review, treat it as no signal), created_at and updated_at), "page" ({offset, limit, returned, total_matches, next_cursor, max_offset}), "sort", "search_mode" ("keyword_synonym"), "interpretation" and "attribution". Repeated identical queries are served from a short-lived cache. 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. Recommended flow: pitchspark_search_pitches_v2 (find) → pitchspark_get_pitch_v2 (read) → pitchspark_get_score_v1 (score and roast) → pitchspark_get_decision_summary_v1 (what signed-in PitchSpark users decided) → pitchspark_request_intro_v1 or pitchspark_watch_pitch_v1. Errors are JSON {"error":{"code","message","category","retryable"}}: INVALID_ARGUMENT, UNAUTHORIZED, RATE_LIMITED, INTERNAL.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "pitchspark_search_pitches_v2"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | relevance (keyword + synonym score; "top scoring" in the query still orders by score), score (public score, pitches without one last), recency (newest listing first), most_viewed_by_investors (Pitch.views_count, all viewers), recently_updated. | relevance |
| limit | No | Page size. A value above the caller's tier ceiling is reduced to it. | |
| query | No | Optional plain-English request, 1 to 200 characters, read by the same rules as pitchspark_search_pitches_v1 (sector, stage, place, raise, score and traction cues; quotes and "not X"). Keyword + synonym matching, not semantic search. | |
| 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. Not with offset. | |
| offset | No | Skip this many results instead of a cursor. Not with cursor. | |
| 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 | ||
| sort | No | ||
| error | No | Present only when the call failed (isError true). | |
| pitches | No | ||
| truncated | No | ||
| attribution | No | ||
| search_mode | No | How text matching works: keyword + synonym ranking. Semantic search is not available yet. | |
| interpretation | No |