Save a startup search (query and filters) to re-run later
pitchspark_save_search_v1Save a search (the query and filters of pitchspark_search_pitches_v2) under the caller's API key, to list and re-run later with pitchspark_list_saved_searches_v1. Use when: the investor asks to save or remember a search. Do not use for: alerts (not delivered yet: saving does not send anything), running the search (pitchspark_search_pitches_v2). Requires a PitchSpark API key with the searches:write scope (keys without a scope list hold it). Idempotent: the same normalised query and filters under the same key returns the existing saved search (status "already_saved") and writes nothing new. At most 20 saved searches per key (status "limit_reached"); 50 saves per key per UTC day (RATE_LIMITED). Do not put personal data (names, emails, phone numbers, anything about a person) in "name" or "query": they are stored for up to 180 days. Emails and phone numbers that do appear are stored as [redacted]. Saved searches are deleted 180 days after they were last saved, and with the account. Returns {"status","saved_search","max_per_key","next_steps"}.
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_save_search_v1"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | A short label, e.g. "Seed fintech in Europe". | |
| 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 |
| 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. | |
| 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 |
|---|---|---|---|
| error | No | Present only when the call failed (isError true). | |
| status | No | ||
| next_steps | No | ||
| max_per_key | No | ||
| saved_search | No |