# hdw-mcp-server

> MCP Server

This repository hosts the HDW MCP Server, which provides comprehensive access to LinkedIn data and functionalities via the HorizonDataWave API, including user search, profile lookup, and account management.

## Overview

- **Category:** Developer Tools
- **Language:** JavaScript
- **Stars:** 63
- **Forks:** 1
- **Owner:** horizondatawave
- **GitHub:** https://github.com/horizondatawave/hdw-mcp-server
- **Created:** 2025-03-12T20:27:22+00:00
- **Updated:** 2025-03-28T09:47:40+00:00
- **Source:** https://model-context-protocol.com/servers/linkedin-data-access-account-management-server

## Setup

## Setup

### 1. Clone the Repository (macOS)

Open your terminal and run the following commands:

```bash
# 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 install
```
### 2. Obtain Your API Credentials

Register at [app.horizondatawave.ai](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 the root of your project with the following content:

```env
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 configuration file (`claude_desktop_config.json`) with the following content:

```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 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:

```bash
env HDW_ACCESS_TOKEN=your-access-token HDW_ACCOUNT_ID=your-account-id node /path/to/your/build/index.js
```
**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:

```bash
sh /path/to/your/run.sh
```
#### 4.3 Windsurf

Update your Windsurf configuration file (`mcp_config.json`) with the following content:

```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:** 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):

```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"
      }
    }
  }
}
```
Replace the paths and credentials with your own values.

## Tools

## Available Tools

1.  LinkedIn Users Search: Filter and search for LinkedIn users by keywords, name, title, company, location, industry, and education.
2.  Profile Lookup: Retrieve detailed profile information for a LinkedIn user.
3.  Email Lookup: Find LinkedIn user details by email address.
4.  Posts & Reactions: Retrieve a user's posts and associated reactions.
5.  Post Reposts & Comments: Retrieve reposts and comments for a specific LinkedIn post.
6.  Account Management: Retrieve and send chat messages, send connection invitations, create comments, and retrieve user connections.
7.  Company Search & Details: Find LinkedIn companies using Google search, retrieve detailed information, and retrieve company employees.
8.  Google Search