Documentation People tools

People tools

Look up LinkedIn profiles, search for people by name or structured filters, and access raw profile data when the standard fields are not enough.

get_person_profile

Get a specific person's LinkedIn profile details. No cookies or login required.

Cost

1 credit

Parameters

Name	Type	Required	Description
`linkedin_username`	string	Yes	The LinkedIn username or profile URL.

Response shape

name, headline, about, location, openToWork, topSkills, connectionsCount, followerCount, linkedinUrl, experience[], education[], certifications[], projects[], volunteering[], skills[]

Example call

{
  "method": "tools/call",
  "params": {
    "name": "get_person_profile",
    "arguments": {
      "linkedin_username": "williamhgates"
    }
  }
}

Example response

{
  "name": "Ada Lovelace",
  "headline": "Engineering leader",
  "about": "Building analytical engines...",
  "location": "London, United Kingdom",
  "openToWork": false,
  "topSkills": [
    "Systems design",
    "Python",
    "Mathematics"
  ],
  "connectionsCount": 500,
  "followerCount": 1200,
  "linkedinUrl": "https://www.linkedin.com/in/ada-lovelace",
  "experience": [
    {
      "company": "Analytical Engines",
      "title": "Founder",
      "duration": "1842 - 1852"
    }
  ],
  "education": [],
  "certifications": [],
  "projects": [],
  "volunteering": [],
  "skills": [
    "Systems design",
    "Python",
    "Mathematics"
  ]
}

get_profile_raw

Get a person's full, unfiltered LinkedIn profile JSON — raw output for when the compact allowlisted fields are not enough.

Cost

1 credit

Parameters

Name	Type	Required	Description
`linkedin_username`	string	Yes	The LinkedIn username or profile URL.

Response shape

Full unfiltered JSON — every field LinkedIn returns for this record.

Example call

{
  "method": "tools/call",
  "params": {
    "name": "get_profile_raw",
    "arguments": {
      "linkedin_username": "williamhgates"
    }
  }
}

Example response

Full unfiltered JSON — every field LinkedIn returns for this record.

search_people

Search for people using free-text or structured filters (title, company, location). Returns a markdown table. Use get_person_profile to drill into a specific result.

Cost

2 credits per record

Parameters

Name	Type	Required	Description
`query`	string	No	Free-text search across name, title, and company.
`currentJobTitles[]`	string[]	No	Filter by current job title.
`locations[]`	string[]	No	Filter by location.
`currentCompanies[]`	string[]	No	Filter by current company name.
`start_page`	number	No	Page to start from (default 1).
`take_pages`	number	No	Number of pages to fetch (default 1).

Response shape

Markdown table with columns: name, title, company, location

Example call

{
  "method": "tools/call",
  "params": {
    "name": "search_people",
    "arguments": {
      "currentJobTitles": [
        "Software Engineer"
      ],
      "locations": [
        "San Francisco Bay Area"
      ],
      "take_pages": 1
    }
  }
}

Example response

| name | title | company | location |
| --- | --- | --- | --- |
| Ada Lovelace | Software Engineer | Analytical Engines | San Francisco, CA |
| Alan Turing | Senior Engineer | Computing Machines Ltd | San Francisco, CA |

search_people_by_name

Search for people by first and last name. Returns a markdown table with name, URL, location, and experience. The URL can be passed directly into get_person_profile.

Cost

1 credit per record

Parameters

Name	Type	Required	Description
`firstName`	string	Yes	Person's first name.
`lastName`	string	Yes	Person's last name.

Response shape

Markdown table with columns: name, url, location, experience

Example call

{
  "method": "tools/call",
  "params": {
    "name": "search_people_by_name",
    "arguments": {
      "firstName": "Ada",
      "lastName": "Lovelace"
    }
  }
}

Example response

| name | url | location | experience |
| --- | --- | --- | --- |
| Ada Lovelace | https://www.linkedin.com/in/ada-lovelace | London, UK | Founder at Analytical Engines |