npm.io
1.0.1 • Published 2d agoCLI

linkydy-mcp

Licence
MIT
Version
1.0.1
Deps
3
Size
14 kB
Vulns
0
Weekly
0

Linkydy MCP Server (linkydy-mcp)

Linkydy is a LinkedIn MCP (Model Context Protocol) server + Chrome extension: your AI agent searches LinkedIn leads, finds verified business emails, and runs outreach through YOUR browser session — with the extension enforcing every safety limit.

Works with any MCP client: Claude (Desktop & Code), ChatGPT, Grok, Cursor, and others.

How it works

The server never touches LinkedIn directly. It's a thin relay: your agent → this server → (local WebSocket) → the extension → LinkedIn, using your logged-in session. Nothing is sent to any third party.

Premium only. The outreach tools work only while your extension is on a paid plan. Free accounts get a clear premium_required response.

Setup (2 minutes)

  1. Install the Linkydy extension and sign in.
  2. In the extension dashboard open AI Agent (MCP) and copy your pairing token.
  3. Add this to your MCP client config (example for Claude Desktop — claude_desktop_config.json):
{
  "mcpServers": {
    "linkydy": {
      "command": "npx",
      "args": ["-y", "linkydy-mcp"],
      "env": { "LINKYDY_TOKEN": "PASTE_YOUR_TOKEN_HERE" }
    }
  }
}
  1. Restart your MCP client. On the extension's AI Agent (MCP) page, turn the connection On. You're paired.

Tools

Tool What it does
search_leads Find & save leads by keywords, title, company, location, industry, network
list_leads List saved leads (optionally filtered)
send_connection Send one connection request (+ personalized message); returns sent / skipped / failed / blocked
react_to_posts Like/celebrate a person's recent posts
comment_on_post Comment on a person's recent post
find_email Find a verified email (needs your Apollo.io key)
get_campaign_stats Sent / accepted / pending / acceptance rate
get_safety_status Invites sent today (informational — no artificial cap; helps you self-pace)
get_account Sign-in / Premium status

Example prompts

  • "Find 20 recruiters at Google in Germany and save them."
  • "List my leads at Google, then send each a connection request: Hi {{FIRST_NAME}}, saw you lead hiring at {{COMPANY}} — would love to connect."
  • "How many invites have I sent today? Pace them so it looks human."

Safety

  • The extension spaces actions out and auto-pauses if LinkedIn pushes back (its own invite limit / rate limit). There is no artificial daily cap — a warmed account can do as much as LinkedIn allows — but the agent should pace invites to look human, and get_safety_status reports today's count to help.
  • The server listens on 127.0.0.1 only and refuses any client without your token.

Env vars

Var Default Meaning
LINKYDY_TOKEN Pairing token from the extension (required)
LINKYDY_PORT 8765 Local WebSocket port

License

MIT

Keywords