MCP HubMCP Hub
horizondatawave

hdw-mcp-server

by: horizondatawave

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.

13created 12/03/2025
Visit
LinkedIn
API

📌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 access to LinkedIn data and functionalities using the HorizonDataWave API for data retrieval and user account management.

Features

  • LinkedIn Users Search: Filter and search for LinkedIn users by various criteria.
  • 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.
  • Account Management:
    • Retrieve and send chat messages via the API.
    • Send connection invitations to LinkedIn users.
    • Create comments on LinkedIn posts.
    • Retrieve a list of a user's LinkedIn connections.
  • Company Search & Details:
    • Find LinkedIn companies using Google search.
    • Retrieve detailed information about a LinkedIn company.
    • Retrieve employees for a given LinkedIn company.

Tools

The HDW MCP Server exposes several tools, defined by their name, description, and input parameters:

  1. Search LinkedIn Users

    • Name: search_linkedin_users
    • Description: Search for LinkedIn users with filters.
    • Parameters: Include keywords, first_name, last_name, company, location, etc.

  2. Get LinkedIn Profile

    • Name: get_linkedin_profile
    • Description: Retrieve profile information about a LinkedIn user.
    • Parameters: User identifier, and optional flags for experience and education.

  3. Get LinkedIn Email User

    • Name: get_linkedin_email_user
    • Description: Look up LinkedIn user details by email.
    • Parameters: email (required).

  4. Get LinkedIn User Posts

    • Name: get_linkedin_user_posts
    • Description: Retrieve posts for a LinkedIn user.
    • Parameters: User URN.

  5. Get LinkedIn User Reactions

    • Name: get_linkedin_user_reactions
    • Description: Retrieve user reactions.
    • Parameters: User URN.

  6. Get LinkedIn Chat Messages

    • Name: get_linkedin_chat_messages
    • Description: Retrieve top chat messages.
    • Parameters: User URN.

  7. Send LinkedIn Chat Message

    • Name: send_linkedin_chat_message
    • Description: Send a chat message.
    • Parameters: Recipient user URN and message text.

  8. Send LinkedIn Connection Request

    • Name: send_linkedin_connection
    • Description: Send a connection invitation.

  9. Send LinkedIn Post Comment

    • Name: send_linkedin_post_comment
    • Description: Create a comment on a LinkedIn post.
    • Parameters: Comment text and URN.

  10. Get LinkedIn User Connections

    • Name: get_linkedin_user_connections
    • Description: Retrieve a list of LinkedIn user connections.

  11. Get LinkedIn Post Reposts

    • Name: get_linkedin_post_reposts
    • Description: Retrieve reposts for a LinkedIn post.

  12. Get LinkedIn Post Comments

    • Name: get_linkedin_post_comments
    • Description: Retrieve comments for a LinkedIn post.

  13. Get LinkedIn Google Company

    • Name: get_linkedin_google_company
    • Description: Search for LinkedIn companies via Google.

  14. Get LinkedIn Company

    • Name: get_linkedin_company
    • Description: Retrieve detailed information about a LinkedIn company.

  15. Get LinkedIn Company Employees

    • Name: get_linkedin_company_employees
    • Description: Retrieve LinkedIn company employees.

Setup Guide

1. Clone the Repository

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 app.horizondatawave.ai for your API key and credits.

3. Configure the Environment

Create a .env file in the project root:

HDW_ACCESS_TOKEN=YOUR_HD_W_ACCESS_TOKEN
HDW_ACCOUNT_ID=YOUR_HD_W_ACCOUNT_ID

4. Client Configuration

Update your client configuration in the respective configuration files with your API credentials.

4.1 Claude Desktop

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

4.2 Cursor

Use a command or a template script for configuration.

4.3 Windsurf

{
  "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"
      }
    }
  }
}

License

This project is licensed under the 1.