MCP Server for LinkedIn and Sales Navigator

The Periodix MCP server is GTM infrastructure for AI agents. It lets agents search, enrich, extract, and act on LinkedIn and Sales Navigator using plain text. Search people, companies, posts, and jobs. Enrich any LinkedIn profile or company with full structured data. Extract post content, reactions, and comments with full text. Send connection requests, messages, and InMail, and run multi-step outreach sequences. No workflow builder, no HTTP configuration, no orchestrator. Describe what you need in natural language and the agent returns structured results or takes the action.

This works with any MCP-compatible client: Claude Code, Claude Desktop, Cursor, Windsurf, OpenAI, or your own implementation. GTM teams and automation builders use it to give their AI agents and AI SDRs a reliable execution layer, starting with LinkedIn and Sales Navigator.

Built by the team behind Periodix, an AI sales agent for LinkedIn rated 4.9/5 on G2. Periodix has been working with LinkedIn's infrastructure since 2023 and has lost 0 LinkedIn accounts across 25,000 connected profiles in the last 24 months, with automatic rate limiting on every action. The MCP server is the fastest way to give your AI agent direct access to LinkedIn search, enrichment, and outreach.

Example prompts your agent can handle

GTM workflows end to end

• "Build a list of 50 Heads of RevOps at Series A SaaS companies in the US, score them against my ICP, and draft a connection note for everyone who scores 7 or higher."
• "Find companies hiring SDRs in France this week, find the VP Sales at each one, and draft an opener tied to the open role."

Search

• "Find DevOps engineers in Germany who work at fintech companies with 50 to 100 employees."
• "Search Sales Navigator for marketing directors at fintech companies in London with 200+ employees."
• "Find open product manager jobs at startups in New York posted in the last 7 days."
• "Find AI startups in Berlin with 50-200 employees. Get full company profiles with industry, headcount, and specializations."

Enrichment

• "Get the full LinkedIn profile for https://www.linkedin.com/in/williamhgates/ including experience, skills, and current company details."
• "Get company details for https://www.linkedin.com/company/stripe/ with industry, headcount, description, and specializations."

Engagement extraction

• "Find LinkedIn posts about AI in outbound sales from this week. Get everyone who liked or commented on them, with their names, titles, companies, and what they commented."
• "Find John Smith, VP Sales at Stripe on LinkedIn. Pull his recent posts so I can personalize my first message."

Network

• "List my LinkedIn connections and show me who works as VP or Director at SaaS companies."

Outreach

• "Send a connection request to https://www.linkedin.com/in/... with a short note about their post on AI in sales."
• "Send an InMail to this Sales Navigator lead with the subject 'Quick question' and a two-sentence message."
• "How many InMail credits do I have left?"

Sequences

• "Create a 3-step sequence: a connection request, a first message 2 days after acceptance, and a follow-up 4 days later. Personalize with {{firstName|there}} and {{company|your team}}. Send on weekdays between 9:00 and 17:00 UTC."
• "Enroll these 50 leads into that sequence and spread them across my connected profiles."

The MCP server covers People, Companies, Posts, and Jobs search on LinkedIn Classic, plus Leads and Accounts on Sales Navigator, by URL or with structured filters. On top of search, it provides full profile and company enrichment, post engagement extraction (reactions and comments with full comment text and author details), user post history, your LinkedIn connection graph, outreach (connection requests, messages, InMail), and multi-step sequences. You describe what you need in words, and the agent constructs the calls for you.

Endpoint

POST https://actions.periodix.net/mcp
Authorization: Bearer <your-api-key>

Get an API key

1. Create a free account at actions.periodix.net (or sign in if you already have one). A 3-day full-access free trial starts automatically.
2. Connect at least one LinkedIn profile on the Profiles page (required for any action that operates on LinkedIn).
3. On the API keys page, click New API key and copy the token.

Connect from Claude Code

claude mcp add periodix-actions \
  --transport http \
  https://actions.periodix.net/mcp \
  --header "Authorization: Bearer <your-api-key>"

Then in any Claude Code session:

/mcp

You should see periodix-actions listed with its tools.

Connect from Claude Desktop

Add the server to claude_desktop_config.json (the file location depends on your OS, see Anthropic's docs):

{
  "mcpServers": {
    "periodix-actions": {
      "transport": {
        "type": "http",
        "url": "https://actions.periodix.net/mcp",
        "headers": {
          "Authorization": "Bearer <your-api-key>"
        }
      }
    }
  }
}

Restart Claude Desktop. The tools appear under the 🔌 menu.

Connect from Cursor / Windsurf / OpenAI / custom MCP clients

Any client that supports the Streamable HTTP MCP transport works. Point it at the same URL and pass the Authorization header. Refer to the client's documentation for the exact config shape.

Available tools

Quick test

After connecting, try this prompt in your AI agent:

"Search LinkedIn for 3 marketing managers at SaaS companies in Berlin."

If you see structured results with names, titles, companies, and profile URLs, your setup is working. Now try enrichment:

"Get the full LinkedIn profile for https://www.linkedin.com/in/williamhgates/ including experience and skills."

Then try outreach on a test contact:

"Send a connection request to https://www.linkedin.com/in/... with the note: Great post on AI in sales, would love to connect."

Troubleshooting

• Authentication errors: the API key is missing, mistyped, expired, or has been revoked. Create a new one in the dashboard and update your client config.
• No tools shown: make sure the Authorization header is set and points at https://actions.periodix.net/mcp.
• No LinkedIn profile connected: go to actions.periodix.net, navigate to the Profiles page, and connect at least one LinkedIn account. A connected profile is required for any action.
• Empty search results: try broader keywords or check that the connected profile has access to the target network. Sales Navigator searches require an active Sales Navigator subscription on the connected LinkedIn profile.
• InMail fails: InMail requires Premium, Recruiter, or Sales Navigator on the connected profile and a subject line. Check remaining credits with get-inmail-balance.
• Message to a non-connection fails: direct messages work only for 1st-degree connections and open profiles. Send a connection request first, use InMail, or use a sequence with sendConnectionRequest enabled.
• Rate limit errors: Periodix includes automatic rate limiting, but high-volume requests may be temporarily throttled. Wait a few minutes and retry.

Related:

• Getting Started

  Overview of Periodix Actions, pricing, and free trial

  n8n node

  Run the same actions in n8n workflows

  Playbooks

  Ready-made GTM pipelines for MCP, n8n, REST, and Make