Using tools
Start with a task, inspect the available tools, and review the evidence in the results.
After connecting your agent, describe your goal and the information you already have. You do not need to choose a data provider first.
Find the right tool
| Starting point | Tool to inspect |
|---|---|
| A role, company, repository, or paper; you need a list of people | people_search |
| A known person with a profile URL, email, or name and company | people_enrich |
| A public account or profile URL | social_profile |
| One known profile; you want to find the person's other accounts | people_identity_resolve |
| A known person; you need available contact details | people_contact_find |
These are starting points, not a complete list. Ask the agent to call capabilities for current capabilities, accepted identifiers, and available providers. Company search and enrichment are also listed there.
Inspect before calling
capabilities, find_tool, and endpoint read the catalog without making a paid provider call.
- Use
find_toolfor platform-specific needs such as posts, videos, or audience data. It finds API endpoints, not people. - Use
endpointto inspect a returned endpoint ID, its required parameters, price, and availability. - Use
call_toolwhen you need that exact endpoint. Supply its own parameter names; the provider's response is returned underraw. It does not automatically try another provider.
I want to find YouTube creators who review developer tools.
Use PeopleRouter to inspect the available search and channel-data tools.
Explain the required inputs, prices, and any criteria they cannot check.
Do not call providers yet.Start small, then enrich
Try a small set of results before expanding. Keep profile URLs from the search, then enrich only the people worth investigating further.
Ask for source links and an explanation of each match. A missing field means the source did not supply it. A returned contact address is not automatically verified; use the provider's explicit verification information. Some providers cannot apply every filter—ask the agent to identify those gaps when reviewing results.
See Routing and credits for call controls and Troubleshooting for errors.