Quickstart
Ship your first LinkFetch call in 90 seconds.
LinkFetch gives AI agents typed LinkedIn data — profiles, companies, jobs — through one REST API, typed SDKs, and a native MCP server for Claude Desktop and Cursor.
Every response ships with a provenance stamp (source, fetched_at,
freshness_days) and every profile lookup is rooted in the end user's own
LinkedIn session. No fake accounts, no rented sessions.
1 — Get a key
Sign in at linkfetch.io/signin and grab your $5 in free credit.
No card required.
export LINKFETCH_KEY=sk_live_...2 — Make your first call
Pick a runtime. The TypeScript SDK is the canonical path; everything else mirrors its shape.
TypeScript
npm i @linkfetch/sdk
Python
pip install linkfetch
curl / any HTTP
POSIX-compatible.
Claude Desktop · MCP
Native tools in Claude.
import { LinkFetch } from "@linkfetch/sdk";
const ll = new LinkFetch({ apiKey: process.env.LINKFETCH_KEY! });
const { data, meta } = await ll.profiles.get({
url: "linkedin.com/in/ada-lovelace",
});
console.log(data.name, data.headline);
console.log(meta.provenance); // { source, fetched_at, freshness_days }3 — Understand the response envelope
Every call returns a two-part envelope: data with the typed record, and meta
with the provenance + request id.
{
"data": {
"name": "Ada Lovelace",
"headline": "Mathematician · First programmer",
"location": "London, UK",
"current": { "company": "Analytical Engine", "title": "Research Lead" },
"skills": ["numerical analysis", "symbolic logic"]
},
"meta": {
"request_id": "req_2Yq7zR1tDkH",
"credits_charged": 5,
"provenance": {
"source": "extension",
"fetched_at": "2026-04-23T14:02:11Z",
"freshness_days": 6
}
}
}See Provenance for the full model and Errors for the shape of failures.
4 — Wire Claude Desktop
Drop this into ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"linkfetch": {
"url": "https://mcp.linkfetch.io",
"transport": "http",
"headers": { "Authorization": "Bearer sk_live_..." }
}
}
}Restart Claude. Try: "Who are the five most recent hires at Vercel?".