Guides
  1. Getting Started

MCP

The Periodix MCP server lets AI agents search, enrich, and extract data from 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. No workflow builder, no HTTP configuration, no orchestrator. Describe what you need in natural language and the agent returns structured results.

This works with any MCP-compatible client: Claude Code, Claude Desktop, Cursor, Windsurf, or your own implementation.

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 the MCP server is the fastest way to give your AI agent direct access to LinkedIn search and enrichment.

Example prompts your agent can handle

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

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."

The MCP server accepts the same types as the HTTP API: People, Companies, Posts, and Jobs search on LinkedIn Classic, plus People and Companies on Sales Navigator. On top of search, it provides full profile and company enrichment, post engagement extraction (reactions and comments including full comment text and author details), user post history with full post content, and access to your LinkedIn connection graph. You describe what you need in words, and the agent constructs the query for you.

Periodix ships a Model Context Protocol (MCP) server so any MCP-aware agent — Claude Code, Claude Desktop, Cursor, Windsurf, and others — can call your actions as tools, with the same API key you already use for HTTP.

Endpoint

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

Get an API key

  1. Sign in at actions.periodix.net.
  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.
👍

Keep the token safe

The key is shown once. If you lose it, revoke it from the dashboard and create a new one.

Connect from Claude Code

claude mcp add periodix-actions \
  --transport http \
  https://actions.periodix.net/api/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 (location depends on your OS — see Anthropic's docs):

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

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

Connect from Cursor / Windsurf / 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

ToolWhat it does
linkedin-searchRun a LinkedIn search (Classic or Sales Navigator — People, Companies, Posts, Jobs) by URL and return matching rows.

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/api/mcp.
  • No LinkedIn profile connected — go to actions.periodix.net, navigate to Profiles page, and connect at least one LinkedIn account. A connected profile is required for any search or enrichment 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.
  • Rate limit errors — Periodix includes automatic rate limiting, but high-volume requests may be temporarily throttered. Wait a few minutes and retry.

Related