Harmonic MCP Server

A Model Context Protocol (MCP) server that provides access to Harmonic.ai's API for searching companies and people/professionals.

Features

• Search companies in Harmonic's database
• Get detailed company information by domain
• Search for people/professionals
• Get detailed person information by ID
• Standalone package with all dependencies included

Building

Install dependencies:

npm install

Build the server:

npm run build

This creates a standalone package in `dist/standalone/` with all dependencies included.

Usage with Claude Desktop

1. Get your Harmonic API key from https://console.harmonic.ai/docs/dashboard

2. Add the server to your Claude Desktop configuration:

Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:

{
  "mcpServers": {
    "harmonic": {
      "command": "node",
      "args": ["/absolute/path/to/HarmonicMCPServer/dist/standalone/index.js"]
    }
  }
}

Important:

• Replace `/absolute/path/to/HarmonicMCPServer` with the actual path to your project
• Use the full path to node (find it with `which node`)
• Make sure the path has no spaces or special characters

3. Restart Claude Desktop

4. In Claude, first set your API key:

Use the harmonic_set_api_key tool with your API key

5. Now you can use the Harmonic tools:

• `harmonic_search_company_by_domain` - Search for a company by its website domain
• `harmonic_search_companies` - Search for companies by query
• `harmonic_search_people` - Search for people/professionals
• `harmonic_get_saved_search_results` - Get results from a saved search
• `harmonic_get_company_employees` - Get all active employees from a company

Available Tools

harmonic_set_api_key

Set your Harmonic API key for authentication.

Parameters:

• `api_key` (required): Your Harmonic API key

harmonic_search_company_by_domain

Search for a company by its website domain using POST method.

Parameters:

• `domain` (required): The website domain of the company (e.g., harmonic.ai)

harmonic_search_companies

Search for companies by query using GET method.

Parameters:

• `query` (required): Search query for companies
• `size` (optional): Number of results to return (default: 50)
• `cursor` (optional): Cursor for pagination

harmonic_search_people

Search for people/professionals using GET method.

Parameters:

• `query` (required): Search query for people
• `size` (optional): Number of results to return (default: 50)
• `cursor` (optional): Cursor for pagination

harmonic_get_saved_search_results

Get results from a saved search.

Parameters:

• `search_id` (required): The ID of the saved search
• `size` (optional): Number of results to return (default: 50)
• `cursor` (optional): Cursor for pagination

harmonic_get_company_employees

Get all active employees from a company.

Parameters:

• `company_id` (required): The ID of the company
• `size` (optional): Number of results to return (default: 50)
• `cursor` (optional): Cursor for pagination

Development

Run in development mode:

npm run dev

API Documentation

For more information about Harmonic's API, visit:

https://console.harmonic.ai/docs/api-reference/introduction