HDW MCP Server
A Model Context Protocol (MCP) server that provides comprehensive access to LinkedIn data and functionalities using the HorizonDataWave API, enabling not only data retrieval but also robust management of user accounts.
Features
- LinkedIn Users Search: Filter and search for 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:
- Company Search & Details:
- Google Search
Tools
HDW MCP Server exposes several tools through the MCP protocol. Each tool is defined with its name, description, and input parameters:
- Search LinkedIn UsersName:
search_linkedin_usersDescription: Search for LinkedIn users with various filters.Parameters:
- Get LinkedIn ProfileName:
get_linkedin_profileDescription: Retrieve detailed profile information about a LinkedIn user.Parameters:
- Get LinkedIn Email UserName:
get_linkedin_email_userDescription: Look up LinkedIn user details by email.Parameters:
- Get LinkedIn User PostsName:
get_linkedin_user_postsDescription: Retrieve posts for a LinkedIn user by URN.Parameters:
- Get LinkedIn User ReactionsName:
get_linkedin_user_reactionsDescription: Retrieve reactions for a LinkedIn user by URN.Parameters:
- Get LinkedIn Chat MessagesName:
get_linkedin_chat_messagesDescription: Retrieve top chat messages from the LinkedIn management API.Parameters:
- Send LinkedIn Chat MessageName:
send_linkedin_chat_messageDescription: Send a chat message using the LinkedIn management API.Parameters:
- Send LinkedIn Connection RequestName:
send_linkedin_connectionDescription: Send a connection invitation to a LinkedIn user.Parameters:
- Send LinkedIn Post CommentName:
send_linkedin_post_commentDescription: Create a comment on a LinkedIn post or reply.Parameters:
- Get LinkedIn User ConnectionsName:
get_linkedin_user_connectionsDescription: Retrieve a list of LinkedIn user connections.Parameters:
- Get LinkedIn Post RepostsName:
get_linkedin_post_repostsDescription: Retrieve reposts for a LinkedIn post.Parameters:
- Get LinkedIn Post CommentsName:
get_linkedin_post_commentsDescription: Retrieve comments for a LinkedIn post.Parameters:
- Get LinkedIn Google CompanyName:
get_linkedin_google_companyDescription: Search for LinkedIn companies via Google the first result is typically the best match.Parameters:
- Get LinkedIn CompanyName:
get_linkedin_companyDescription: Retrieve detailed information about a LinkedIn company.Parameters:
- Get LinkedIn Company EmployeesName:
get_linkedin_company_employeesDescription: Retrieve employees of a LinkedIn company.Parameters:
Setup Guide
1. Clone the Repository (macOS)
Open your terminal and run the following commands:
2. Obtain Your API Credentials
Register at 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 the root of your project with the following content:4. Client Configuration
4.1 Claude Desktop
Update your Claude configuration file (
claude_desktop_config.json) with the following content:Configuration file location:
- 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 the command:
Safe way:Copy the provided template
run.template.sh to a new file (e.g. run.sh), update it with your credentials, and configure Cursor to run:4.3 Windsurf
Update your Windsurf configuration file (
mcp_config.json) with the following content:Note: After configuration, you can disable official web tools to conserve your API credits.
MCP Client Example Configuration
Below is an example configuration for an MCP client (e.g., a custom integration):
Replace the paths and credentials with your own values.
License
This project is licensed under the MIT License.
HDW MCP Server
A Model Context Protocol (MCP) server that provides comprehensive access to LinkedIn data and functionalities using the HorizonDataWave API, enabling not only data retrieval but also robust management of user accounts.
Features
- LinkedIn Users Search: Filter and search for 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:
- Company Search & Details:
- Google Search
Tools
HDW MCP Server exposes several tools through the MCP protocol. Each tool is defined with its name, description, and input parameters:
- Search LinkedIn UsersName:
search_linkedin_usersDescription: Search for LinkedIn users with various filters.Parameters:
- Get LinkedIn ProfileName:
get_linkedin_profileDescription: Retrieve detailed profile information about a LinkedIn user.Parameters:
- Get LinkedIn Email UserName:
get_linkedin_email_userDescription: Look up LinkedIn user details by email.Parameters:
- Get LinkedIn User PostsName:
get_linkedin_user_postsDescription: Retrieve posts for a LinkedIn user by URN.Parameters:
- Get LinkedIn User ReactionsName:
get_linkedin_user_reactionsDescription: Retrieve reactions for a LinkedIn user by URN.Parameters:
- Get LinkedIn Chat MessagesName:
get_linkedin_chat_messagesDescription: Retrieve top chat messages from the LinkedIn management API.Parameters:
- Send LinkedIn Chat MessageName:
send_linkedin_chat_messageDescription: Send a chat message using the LinkedIn management API.Parameters:
- Send LinkedIn Connection RequestName:
send_linkedin_connectionDescription: Send a connection invitation to a LinkedIn user.Parameters:
- Send LinkedIn Post CommentName:
send_linkedin_post_commentDescription: Create a comment on a LinkedIn post or reply.Parameters:
- Get LinkedIn User ConnectionsName:
get_linkedin_user_connectionsDescription: Retrieve a list of LinkedIn user connections.Parameters:
- Get LinkedIn Post RepostsName:
get_linkedin_post_repostsDescription: Retrieve reposts for a LinkedIn post.Parameters:
- Get LinkedIn Post CommentsName:
get_linkedin_post_commentsDescription: Retrieve comments for a LinkedIn post.Parameters:
- Get LinkedIn Google CompanyName:
get_linkedin_google_companyDescription: Search for LinkedIn companies via Google the first result is typically the best match.Parameters:
- Get LinkedIn CompanyName:
get_linkedin_companyDescription: Retrieve detailed information about a LinkedIn company.Parameters:
- Get LinkedIn Company EmployeesName:
get_linkedin_company_employeesDescription: Retrieve employees of a LinkedIn company.Parameters:
Setup Guide
1. Clone the Repository (macOS)
Open your terminal and run the following commands:
2. Obtain Your API Credentials
Register at 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 the root of your project with the following content:4. Client Configuration
4.1 Claude Desktop
Update your Claude configuration file (
claude_desktop_config.json) with the following content:Configuration file location:
- 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 the command:
Safe way:Copy the provided template
run.template.sh to a new file (e.g. run.sh), update it with your credentials, and configure Cursor to run:4.3 Windsurf
Update your Windsurf configuration file (
mcp_config.json) with the following content:Note: After configuration, you can disable official web tools to conserve your API credits.
MCP Client Example Configuration
Below is an example configuration for an MCP client (e.g., a custom integration):
Replace the paths and credentials with your own values.
License
This project is licensed under the MIT License.