home / mcp / harmonic mcp server
Provides access to Harmonic.ai's API for searching companies and professionals via a standalone MCP server.
Configuration
View docs{
"mcpServers": {
"blue-yard-harmonic-mcp-server": {
"command": "node",
"args": [
"/absolute/path/to/HarmonicMCPServer/dist/standalone/index.js"
],
"env": {
"HARMONIC_API_KEY": "YOUR_API_KEY"
}
}
}
}This MCP server connects to Harmonic.ai to let you search for companies and professionals, retrieve company details by domain, and fetch person information through a single, standalone package you can run locally or integrate with an MCP client. It includes building, running, and using the server with Claude Desktop for quick queries and results.
You run Harmonic MCP as a local server and connect to it from an MCP client. The client can send requests to search for companies and people, or fetch detailed information about a specific company or professional. You’ll configure the client to use the local stdio server you start with Node, then issue tools to perform searches and retrieve results.
Prerequisites: you need Node.js and npm installed on your system. Make sure you have a working internet connection to install dependencies.
npm installBuild the server to create a standalone package that includes all dependencies. This produces a distribution you can run independently of the source code.
npm run buildThe build creates a standalone package in dist/standalone/ with all dependencies included. You will reference the index.js file inside that folder when starting the server.
To run in development mode (optional): you can start a development server with the usual development command.
npm run devUsage with Claude Desktop requires configuring a local MCP server entry. You will point the client to the local Node process that runs the standalone bundle.
The following configuration shows how to add Harmonic MCP to Claude Desktop. You must replace the placeholder path with the actual location of your built server and provide the full path to your Node binary.
{
"mcpServers": {
"harmonic": {
"command": "node",
"args": ["/absolute/path/to/HarmonicMCPServer/dist/standalone/index.js"]
}
}
}Once the Harmonic MCP server is running, you can perform the following actions through your MCP client.
- Set your Harmonic API key using the harmonic_set_api_key tool.
- Search for a company by domain using harmonic_search_company_by_domain.
- Search for companies using harmonic_search_companies.
- Search for people using harmonic_search_people.
- Retrieve saved search results using harmonic_get_saved_search_results.
- Get all active employees of a company using harmonic_get_company_employees.
The following tools are available to interact with Harmonic MCP server.
harmonic_set_api_key — Set your Harmonic API key for authentication.
harmonic_search_company_by_domain — Find a company by its website domain. Parameters: domain (required). Method: POST.
harmonic_search_companies — Find companies by a query. Parameters: query (required), size (optional, default 50), cursor (optional).
harmonic_search_people — Find people by a query. Parameters: query (required), size (optional, default 50), cursor (optional).
harmonic_get_saved_search_results — Get results from a saved search. Parameters: search_id (required), size (optional, default 50), cursor (optional).
harmonic_get_company_employees — Get all active employees for a company. Parameters: company_id (required), size (optional, default 50), cursor (optional).
Set your Harmonic API key for authentication.
Find a company by its website domain. POST domain parameter.
Find companies by a query. Parameters include query, size, and cursor.
Find people by a query. Parameters include query, size, and cursor.
Get results from a saved search by search_id with optional size and cursor.
Get all active employees for a given company_id with optional size and cursor.