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:
- Chat Functionality: Retrieve and send chat messages via the LinkedIn management API.
- Connection Management: Send connection invitations to LinkedIn users.
- Post Commenting: Create comments on LinkedIn posts or replies.
- User Connections: Retrieve a list of a user's LinkedIn connections.
- Company Search & Details:
- Google Company Search: Find LinkedIn companies using Google search – the first result is typically the best match.
- Company Lookup: Retrieve detailed information about a LinkedIn company.
- Company Employees: Retrieve employees for a given LinkedIn company.

- Google Search

---

Tools

HDW MCP Server exposes several tools through the MCP protocol. Each tool is defined with its name, description, and input parameters:

1. Search LinkedIn Users
Name: search_linkedin_users
Description: Search for LinkedIn users with various filters.
Parameters:
- keywords (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).

2. 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).

3. 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).

4. 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).

5. 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).

6. 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).

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

8. Send LinkedIn Connection Request
Name: send_linkedin_connection
Description: Send a connection invitation to a LinkedIn user.
Parameters:
- user (required).
- timeout (optional, default: 300).

9. 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).

10. 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).

11. 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).

12. 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).

13. 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).

14. 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).

15. 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).

---

Setup Guide

1. Clone the Repository (macOS)

Open your terminal and run the following commands:

```bash