---
title: "Discover Prospects"
method: POST
path: "/mcp/tools/discover_prospects"
tags: ["mcp"]
---

# Discover Prospects

`POST /mcp/tools/discover_prospects`

## 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

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 body

- DiscoverProspectsRequest
  - `query` string, required
  - `location` string, required
  - `limit` integer
  - `hiring_only` boolean
  - `open_to_work_only` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/iridiumhqmcp/apis/iridium-linkedin-for-ai-agents.md) · [All operations](https://skmtc.dev/iridiumhqmcp/apis/iridium-linkedin-for-ai-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/iridiumhqmcp/apis/iridium-linkedin-for-ai-agents/revisions/b9f5e020543c?raw)