---
title: "Get Linkedin Profile"
method: POST
path: "/mcp/tools/get_linkedin_profile"
tags: ["mcp"]
---

# Get Linkedin Profile

`POST /mcp/tools/get_linkedin_profile`

## 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/get_linkedin_profile`
- Auth: HTTP bearer

Look up LinkedIn profile(s) for a person, or several known people at once.

At least one of name, linkedin_id, iridium_handle, linkedin_ids, or iridium_handles
must be provided. company, education, location, headline_keywords are optional hints
that narrow a name-based search.

Costs one profile touch per person against the daily budget — this is the expensive way
to look someone up, and the right one when you already know WHO you want. To find people
you cannot yet name, use find_prospects.

Returns {"results": [...], "total": N, "query_used": str | None}.
Results are fully read: about, current_role, past_companies, education,
certifications, skills, recent_posts, prof_handle, and the two profile BADGES as
`is_hiring` / `is_open_to_work`. Opening the profile is the only thing that reveals those
badges, and this call already opened it, so they cost nothing extra here — this is the
cheapest confirmation available for a person you can already name. (`find_prospects` with
max_touches does the same for people you cannot yet name, one touch each.)

## Request body

- GetLinkedInProfileRequest
  - `name` string, nullable
  - `linkedin_id` string, nullable
  - `iridium_handle` string, nullable
  - `linkedin_ids` string[], nullable
  - `iridium_handles` string[], nullable
  - `company` string[], nullable
  - `education` string[], nullable
  - `location` string, nullable
  - `headline_keywords` string[], nullable

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