Harmonic Search

Search for companies and professionals using the Harmonic.ai API.

GitHub

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

  1. Restart Claude Desktop

  2. In Claude, first set your API key:

Use the harmonic_set_api_key tool with your API key
  1. 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

相關伺服器