gtm.devdocs
research

Person research API

research_person

5 credits / call

Research one professional for personalized outreach: what they're publicly known for (talks, podcasts, interviews, articles, announcements), each fact backed by an exact quoted passage from a fetched web page, plus outreach hooks built only on those facts. Give their full name and company (name or domain); title and LinkedIn URL help with namesakes. Public professional facts only. Facts whose source doesn't mention the person by full name, or whose quote isn't in the page, are removed (see unverified_dropped). Optionally steer with a focus (e.g. "what do they say about outbound"). Takes ~20-40s.

Get an API key free trial credits · no card

Parameters

paramtypedescription
company requiredstringTheir current company: name, domain, or org_id (from resolve_company).
name requiredstringThe person's full name, e.g. "Jane Doe".
focusstringOptional angle, e.g. "their views on AI in sales".
linkedin_urlstringTheir LinkedIn profile URL, if known. Optional.
titlestringTheir current title, if known. Optional; helps with namesakes.

Call it from your agent (MCP)

Connect once and research_person appears in your agent’s toolbox next to every other gtm.dev tool. Claude Code:

claude mcp add --transport http gtm https://mcp.gtm.dev \
  --header "Authorization: Bearer YOUR_API_KEY"

Under the hood, the client sends:

curl -X POST https://mcp.gtm.dev \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"research_person","arguments":{"name":"Kyle Norton","company":"owner.com"}}}'

other clients (cursor, claude desktop, openai agents sdk, langchain): mcp setup

Call it over REST

curl -X POST https://api.gtm.dev/v1/tools/research_person \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Kyle Norton","company":"owner.com"}'

Errors (401, 402, 429, 400) are listed in the REST reference. Calls that error are not billed — see pricing.

Related tools