{"name":"Person Enrich MCP","endpoint":"/api/mcp","transport":"streamable_http_json_rpc_2_0","protocolVersion":"2024-11-05","auth":{"headers":["x-api-key","Authorization: Bearer <PERSONENRICH_API_KEY>"]},"tools":[{"name":"enrich_person","description":"One person in, everything out. Pass a LinkedIn profile URL or slug; returns the structured person (name, headline, company, location, profile_picture_url) with freshness stamps. profile_picture_url is an https link to the largest photo. LinkedIn-hosted links carry an e= expiry (unix seconds); a cache hit returns the stored link until then, and an expired link is fetched again. Costs 1 credit on a verified find — misses and cache hits are free. include_email:true additionally runs the email waterfall (+10 credits, charged only when verified; async — poll again for email_status:\"found\")."},{"name":"enrich_company","description":"One company page in, account data out. Pass a LinkedIn Company Page URL or slug; returns firmographics such as name, description, industry, website, employee count/range, follower count, founded date, organization type and locations. Costs 1 credit on a verified find — misses and cache hits are free."},{"name":"search_companies","description":"Find a LinkedIn Company Page when you have a name, a website domain, or both — not the page URL yet. Returns name, linkedin_url, public_identifier, website, industry, followers_count, and logo. Costs 1 credit when at least one page comes back; an empty search or a provider error costs nothing. limit defaults to 5 and caps at 10. Pass domain to rank website matches first (domain_match: true), then hand linkedin_url to enrich_company, company_posts, or company_employees."},{"name":"discover_lead_magnets","description":"Find LinkedIn lead-magnet posts for a niche — the posts already pulling comment-for-resource demand, so you can see what is working before you write anything. Returns post URL, author, available image URLs, snippet, engagement and freshness. Costs 1 credit per RESULT RETURNED; an empty result set or a provider error costs nothing. limit defaults to 10, capped at 25, so one call can never spend more than 25 credits."},{"name":"get_engagers","description":"Turn any LinkedIn post into a warm lead list. Pass a post URL; returns everyone who COMMENTED or REACTED, deduped to one row per person with their signals, name, headline, available image URL and profile URL — a qualifiable lead out of the box. Costs 1 credit per 25 people returned; an empty post or a provider error costs nothing. Feed the returned profile_url values to enrich_person when you want full profiles or verified emails."},{"name":"profile_posts","description":"Pull recent posts from a LinkedIn profile so an agent can reason from current public content before enriching or writing outreach. Pass a profile URL or slug; returns recent post text, URLs, and attachments (type img, video, or document, plus url and unavailable). LinkedIn-hosted media links expire at e=. Costs 1 credit per post returned; empty result sets or provider errors cost nothing. Media does not add credits. limit defaults to 10, capped at 25."},{"name":"company_posts","description":"Pull recent posts from a LinkedIn Company Page so an agent can brief from what the account is publishing. Pass a company URL or slug; returns recent post text, URLs, and attachments (type img, video, or document, plus url and unavailable). LinkedIn-hosted media links expire at e=. Costs 1 credit per post returned; empty result sets or provider errors cost nothing. Media does not add credits. limit defaults to 10, capped at 25."},{"name":"company_employees","description":"Company URL in, relevant decision-makers out. Pass a LinkedIn Company Page plus optional location, job title, and seniority filters. Returns name, headline, location, LinkedIn URL, profile_picture_url, current title, and current company. LinkedIn-hosted photo links carry an e= expiry (unix seconds); refresh the portrait with enrich_person after that. Costs 1 credit per returned person; empty sets, fresh cache hits, and provider errors cost nothing. limit defaults to 25 and caps at 100 for a synchronous call. Feed linkedin_url into enrich_person (include_email:true) for a full profile and verified email."},{"name":"get_balance","description":"Your remaining Person Enrich credits and the price list (profile 1cr, company 1cr, company search 1cr per non-empty search, work email +10cr, discovery/profile posts/company posts/company employees 1cr per returned item, engagers 1cr per block, misses & cache hits 0)."}],"docs":"/mcp","apiDocs":"/api-docs"}