📌Overview

Purpose: To provide comprehensive access and management of LinkedIn data through the HorizonDataWave API using the Model Context Protocol (MCP) server.

Overview: The HDW MCP Server is designed to facilitate seamless retrieval and management of LinkedIn data, enabling users to interact with LinkedIn functionalities efficiently. The server supports a wide range of tools that allow for user and company searches, profile lookups, posts handling, and enhanced account management features.

Key Features:

LinkedIn Users Search: Enables targeted searches for LinkedIn users using various criteria such as name, title, and location.
Profile Lookup: Lets users access detailed information of LinkedIn profiles effortlessly.
Account Management: Offers functionalities such as sending chat messages, connection invitations, and managing user connections, streamlining user interactions within LinkedIn.
Company Search & Details: Provides tools to find LinkedIn companies, retrieve their information, and explore their employees effectively.

HDW MCP Server

A Model Context Protocol (MCP) server that provides comprehensive access to LinkedIn data and functionalities using the HorizonDataWave API. It enables data retrieval and robust management of user accounts.

Features

LinkedIn Users Search: Filter and search LinkedIn users by keywords, name, title, company, location, industry, and education.
Profile Lookup: Retrieve detailed profile information for a LinkedIn user.
Email Lookup: Find LinkedIn user details by email address.
Posts & Reactions: Retrieve a user's posts and associated reactions.
Post Reposts & Comments: Retrieve reposts and comments for a specific LinkedIn post.
Account Management:
- Retrieve and send chat messages via the LinkedIn management API.
- Send connection invitations to LinkedIn users.
- Create comments on LinkedIn posts or replies.
- Retrieve a list of a user's LinkedIn connections.
Company Search & Details:
- Find LinkedIn companies using Google search (first result typically the best match).
- Retrieve detailed information about a LinkedIn company.
- Retrieve employees for a given LinkedIn company.

Tools

HDW MCP Server exposes several tools through the MCP protocol with defined names, descriptions, and input parameters:

Search LinkedIn Users
Search for LinkedIn users with various filters.
Parameters include keywords, names, titles, companies, locations, industries, education, count (max 1000), and timeout.
Get LinkedIn Profile
Retrieve detailed profile information about a LinkedIn user.
Parameters include user alias/URL/URN and options to include experience, education, and skills.
Get LinkedIn Email User
Look up LinkedIn user details by email.
Parameters include email, count, and timeout.
Get LinkedIn User Posts
Retrieve posts for a LinkedIn user by URN.
Parameters include user URN, count, and timeout.
Get LinkedIn User Reactions
Retrieve reactions for a LinkedIn user by URN.
Parameters include user URN, count, and timeout.
Get LinkedIn Chat Messages
Retrieve top chat messages from LinkedIn management API.
Parameters include user URN, count, and timeout.
Send LinkedIn Chat Message
Send a chat message using LinkedIn management API.
Parameters include recipient user URN, message text, and timeout.
Send LinkedIn Connection Request
Send a connection invitation to a LinkedIn user.
Parameters include user and timeout.
Send LinkedIn Post Comment
Create a comment on a LinkedIn post or reply.
Parameters include comment text, activity or comment URN, and timeout.
Get LinkedIn User Connections
Retrieve a list of LinkedIn user connections.
Parameters include an optional "connected_after" timestamp filter, count, and timeout.
Get LinkedIn Post Reposts
Retrieve reposts for a LinkedIn post.
Parameters include post URN, count, and timeout.
Get LinkedIn Post Comments
Retrieve comments for a LinkedIn post.
Parameters include post URN, sort method ("relevance" or "recent"), count, and timeout.
Get LinkedIn Google Company
Search LinkedIn companies via Google search.
Parameters include an array of company keywords, with_urn flag, count per keyword, and timeout.
Get LinkedIn Company
Retrieve detailed information about a LinkedIn company.
Parameters include company alias/URL/URN and timeout.
Get LinkedIn Company Employees
Retrieve employees of a LinkedIn company.
Parameters include array of company URNs, optional keywords, first and last names, count, and timeout.

Setup Guide

1. Clone the Repository (macOS)

Open your terminal and run:

git clone https://github.com/horizondatawave/hdw-mcp-server.git
cd hdw-mcp-server
npm install

2. Obtain Your API Credentials

Register at https://app.horizondatawave.ai to get your API key and 100 free credits. You will receive your HDW_ACCESS_TOKEN and HDW_ACCOUNT_ID.

3. Configure the Environment

Create a .env file in your project root with:

HDW_ACCESS_TOKEN=YOUR_HD_W_ACCESS_TOKEN
HDW_ACCOUNT_ID=YOUR_HD_W_ACCOUNT_ID

4. Client Configuration

4.1 Claude Desktop

Update your Claude config file (claude_desktop_config.json):

{
  "mcpServers": {
    "hdw": {
      "command": "npx",
      "args": ["@horizondatawave/mcp"],
      "env": {
        "HDW_ACCESS_TOKEN": "YOUR_HD_W_ACCESS_TOKEN",
        "HDW_ACCOUNT_ID": "YOUR_HD_W_ACCOUNT_ID"
      }
    }
  }
}

Configuration file locations:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

4.2 Cursor

Easy way:
Open Cursor Settings and add a new MCP server with this command:

env HDW_ACCESS_TOKEN=your-access-token HDW_ACCOUNT_ID=your-account-id node /path/to/your/build/index.js

Safe way:
Copy run.template.sh to a new file (e.g., run.sh), update with your credentials, and configure Cursor to run:

sh /path/to/your/run.sh

4.3 Windsurf

Update your Windsurf config file (mcp_config.json):

{
  "mcpServers": {
    "hdw": {
      "command": "node",
      "args": ["/path/to/your/build/index.js"],
      "env": {
        "HDW_ACCESS_TOKEN": "YOUR_HD_W_ACCESS_TOKEN",
        "HDW_ACCOUNT_ID": "YOUR_HD_W_ACCOUNT_ID"
      }
    }
  }
}

Note: You can disable official web tools after configuration to conserve API credits.

MCP Client Example Configuration

Example for a custom MCP client integration:

{
  "mcpServers": {
    "hdw": {
      "command": "npx",
      "args": ["@horizondatawave/mcp"],
      "env": {
        "HDW_ACCESS_TOKEN": "YOUR_HD_W_ACCESS_TOKEN",
        "HDW_ACCOUNT_ID": "YOUR_HD_W_ACCOUNT_ID"
      }
    }
  }
}

Replace paths and credentials with your own values.

License

This project is licensed under the MIT License.