A Model Context Protocol server that provides comprehensive access to LinkedIn data and functionality, enabling data retrieval and user account management through the HorizonDataWave API.
Company Employees: Retrieve employees for a given LinkedIn company.
Google Search
HDW MCP Server exposes several tools through the MCP protocol. Each tool is defined with its name, description, and input parameters:
search_linkedin_userskeywords (optional): Any keyword for search. first_name, last_name, title, company_keywords, school_keywords (optional). current_company, past_company, location, industry, education (optional). count (optional, default: 10): Maximum number of results (max 1000). timeout (optional, default: 300): Timeout in seconds (20–1500).
Get LinkedIn Profile
Name: get_linkedin_profile
Description: Retrieve detailed profile information about a LinkedIn user.
Parameters:
user (required): User alias, URL, or URN. with_experience, with_education, with_skills (optional, default: true).
Get LinkedIn Email User
Name: get_linkedin_email_user
Description: Look up LinkedIn user details by email.
Parameters:
email (required): Email address. count (optional, default: 5). timeout (optional, default: 300).
Get LinkedIn User Posts
Name: get_linkedin_user_posts
Description: Retrieve posts for a LinkedIn user by URN.
Parameters:
urn (required): User URN (must include prefix, e.g. fsd_profile:...). count (optional, default: 10). timeout (optional, default: 300).
Get LinkedIn User Reactions
Name: get_linkedin_user_reactions
Description: Retrieve reactions for a LinkedIn user by URN.
Parameters:
urn (required). count (optional, default: 10). timeout (optional, default: 300).
Get LinkedIn Chat Messages
Name: get_linkedin_chat_messages
Description: Retrieve top chat messages from the LinkedIn management API.
Parameters:
user (required): User URN (with prefix). count (optional, default: 20). timeout (optional, default: 300).
Send LinkedIn Chat Message
Name: send_linkedin_chat_message
Description: Send a chat message using the LinkedIn management API.
Parameters:
user (required): Recipient user URN (with prefix). text (required): Message text. timeout (optional, default: 300).
Send LinkedIn Connection Request
Name: send_linkedin_connection
Description: Send a connection invitation to a LinkedIn user.
Parameters:
user (required). timeout (optional, default: 300).
Send LinkedIn Post Comment
Name: send_linkedin_post_comment
Description: Create a comment on a LinkedIn post or reply.
Parameters:
text (required): Comment text. urn (required): Activity or comment URN. timeout (optional, default: 300).
Get LinkedIn User Connections
Name: get_linkedin_user_connections
Description: Retrieve a list of LinkedIn user connections.
Parameters:
connected_after (optional): Timestamp filter. count (optional, default: 20). timeout (optional, default: 300).Get LinkedIn Post Reposts
Name: get_linkedin_post_reposts
Description: Retrieve reposts for a LinkedIn post.
Parameters:
urn (required): Post URN (must start with activity:). count (optional, default: 10). timeout (optional, default: 300).Get LinkedIn Post Comments
Name: get_linkedin_post_comments
Description: Retrieve comments for a LinkedIn post.
Parameters:
urn (required). sort (optional, default: "relevance"; allowed values: "relevance", "recent"). count (optional, default: 10). timeout (optional, default: 300).Get LinkedIn Google Company
Name: get_linkedin_google_company
Description: Search for LinkedIn companies via Google – the first result is typically the best match.
Parameters:
keywords (required): Array of company keywords. with_urn (optional, default: false). count_per_keyword (optional, default: 1; range 1–10). timeout (optional, default: 300).Get LinkedIn Company
Name: get_linkedin_company
Description: Retrieve detailed information about a LinkedIn company.
Parameters:
company (required): Company alias, URL, or URN. timeout (optional, default: 300).Get LinkedIn Company Employees
Name: get_linkedin_company_employees
Description: Retrieve employees of a LinkedIn company.
Parameters:
companies (required): Array of company URNs. keywords, first_name, last_name (optional). count (optional, default: 10). timeout (optional, default: 300).Open your terminal and run the following commands:
# Clone the repository
git clone https://github.com/horizondatawave/hdw-mcp-server.git
# Change directory to the project folder
cd hdw-mcp-server
# Install dependencies
npm installRegister at app.horizondatawave.ai to get your API key and 100 free credits. You will receive your HDW_ACCESS_TOKEN and HDW_ACCOUNT_ID.
Create a .env file in the root of your project with the following content:
HDW_ACCESS_TOKEN=YOUR_HD_W_ACCESS_TOKEN
HDW_ACCOUNT_ID=YOUR_HD_W_ACCOUNT_IDUpdate your Claude configuration file (claude_desktop_config.json) with the following content:
{
"mcpServers": {
"hdw": {
"command": "npx",
"args": ["@horizondatawave/mcp"],
"env": {
"HDW_ACCESS_TOKEN": "YOUR_HD_W_ACCESS_TOKEN",
"HDW_ACCOUNT_ID": "YOUR_HD_W_ACCOUNT_ID"
}
}
}
}~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%Claudeclaude_desktop_config.jsonEasy way:
Open Cursor Settings and add a new MCP server with the command:
env HDW_ACCESS_TOKEN=your-access-token HDW_ACCOUNT_ID=your-account-id node /path/to/your/build/index.jsrun.template.sh to a new file (e.g. run.sh), update it with your credentials, and configure Cursor to run:
sh /path/to/your/run.shUpdate your Windsurf configuration file (mcp_config.json) with the following content:
{
"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"
}
}
}
}Below is an example configuration for an MCP client (e.g., a custom 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"
}
}
}
}This project is licensed under the MIT License.