Skip to content

Leadsforge

Find phone numbers

Request phone number finding. Two input modes (mutually exclusive): (1) personIDs - array of IDs obtained from POST /search, (2) people - array of objects, each with either linkedinURL (e.g. "https://www.linkedin.com/in/john-doe") or firstName + lastName + company name (e.g. "Salesforge", not a URL). Max 500 items. Original input fields are echoed back on each result for correlation. People array entries are deduplicated by normalized linkedinURL or by case-insensitive firstName+lastName+company; only one result is returned per unique person, so duplicate entries (e.g. two CRM records pointing at the same person with different externalIDs) will lose the externalIDs of the duplicates - send unique people if you need each externalID echoed back. Each person in the people array may include an optional externalID (max 128 chars), a pure passthrough value persisted with the result and echoed back in the webhook payload and GET /results response for client-side correlation; externalID is not supported in personIDs mode. Example with people: {"people": [{"linkedinURL": "https://www.linkedin.com/in/john-doe", "externalID": "crm-42"}, {"firstName": "Jane", "lastName": "Smith", "company": "Salesforge"}], "webhookURL": "https://example.com/webhook"}. Example with personIDs: {"personIDs": ["p_abc123", "p_def456"]}. Agentik values credits at $0.011125 (account plan $89/8,000 credits). Reserve the maximum; charge only observed successful results/consumed credits. Failed lookups are free. Returns an Agentik RUNNING operation. Poll get_run for settlement, and use the corresponding get-*-results tool with jobID for paginated data.

Usage based LeadsforgeEnrichmentleadsforge/find-phones-batchListed

Activation pending; your agent will see it as unavailable until then.

Use this tool with your agent

Give this to your agent
Use my connected Agentik MCP server. I want to use the tool leadsforge/find-phones-batch (Find phone numbers). Call inspect_tool with {"tool_id": "leadsforge/find-phones-batch"} first and tell me the price before anything runs. Ask me for the inputs it needs; never invent values, IDs or file URLs. When I confirm, call run_tool with tool_id "leadsforge/find-phones-batch" and my inputs, follow it with get_run if it is still running, and give me the result and the price Agentik reports. If the tool is unavailable, say so and use discover_tools to propose an alternative.
Show the prompt

Paste it into Claude, ChatGPT or Codex: your agent takes it from there, and shows the price before it runs.

Parameters

NameTypeRequiredDescription
clientRequestIDstringNo
peopleobject[]No
personIDsstring[]No
saveToListbooleanNo
webhookURLstringNo

How your agent calls it

First inspect_tool for the current schema and price, then run_tool with the published example after confirming your inputs:

{
  "tool_id": "leadsforge/find-phones-batch",
  "input": {
    "people": [
      {
        "firstName": "Frank",
        "lastName": "Sondors",
        "company": "Salesforge"
      }
    ]
  }
}

Price and billing

Price
Usage based
Model
Usage based
Detail
Billed at the cost the provider reports for the call, never above $55.62499999999999. Your agent sees the maximum before running.
License
Provider data use is subject to the Leadsforge agreement; redistribution terms must cover Agentik.
  • The provider’s price, 0% markup.
  • One prepaid balance for every provider; your agent sees the price before it runs.
  • Pay for measured usage; unused reservations are released.