Discover Prospects
Instantly search for people, read their profiles, and generate connection note drafts, all in about 10 to 15 seconds. Returns draft handles ready to approve or skip. Complement to run_outreach_pipeline, which works from the user's saved targets.
Data accuracy: profile names, companies, and headlines are fetched live from LinkedIn and reflect real, current information. Notes reference actual post content when available; when no posts are found, notes are conservative and based only on verifiable headline/company data.
suggested_send_at is a suggestion only. Nothing sends until approve_draft is explicitly called. Drafts remain in pending_review indefinitely.
Each draft includes a profile field with: about, current_role, past_companies, education, certifications, skills, follower_count, recent_posts. Display this alongside the note so the user understands who was found.
Args: query: Search query e.g. "ML engineer at Series B startup" location: Location filter e.g. "San Francisco Bay Area" limit: Max prospects to process (1-10, default 5) hiring_only: the profile BADGE (is_hiring), not post text. This tool opens every candidate's full profile anyway, so the badge is genuinely CONFIRMED here rather than guessed — the filter is applied after that fetch and costs nothing extra. Use it for "find me hiring managers to connect with". Default false (no filter). For "who POSTED about hiring", use search_posts_by_topic: different question, different people, and free. open_to_work_only: same, for the is_open_to_work BADGE. If both this and hiring_only are true, a candidate matching either badge is kept.
Request
- Base URL: https://api.iridiumhqmcp.com (the document declares no server; this is the origin it was published from)
- URL: https://api.iridiumhqmcp.com/mcp/tools/discover_prospects
- Auth: HTTP bearer
Request body
Response
Successful Response
Changes
No recorded changes to this operation across all 1 revision of this API.