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.

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

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