harmonic_set_api_keyLABSCO SUMMARY
Company and people research without the console.
Point it at a Harmonic account and the research loop happens in the conversation: resolve a domain to a company, run a query across companies or people, pull the employee list, and pick a saved search back up where it was left.
What it is
A server in front of Harmonic.ai's API for company and people research. It looks a company up by its website domain, runs company and people searches with pagination, pulls a company's employee list, and re-opens a search you saved in Harmonic.
What you get
- A company found by its website domain
- Companies matched to a search query, with a result size and a pagination cursor
- People matched to a search query, with the same paging arguments
- The active employees of a company
- The results of a search you saved in Harmonic
Requirements
A Harmonic API key from console.harmonic.ai. The key is set inside the session with harmonic_set_api_key rather than through the environment. The server is built from source with npm install and npm run build, then launched with the full path to node against dist/standalone/index.js.
Setup effort
Build from source — git clone https://github.com/blue-yard/harmonic-mcp-server.git
USE CASES
01
Checking out a company you only know by its website
Hand over the domain, get Harmonic's record for the company, then pull its current employees from the same record.
02
Building a list of companies that fit a thesis
Run the query and page through the matches with the size and cursor arguments, instead of exporting a file and filtering it.
03
Finding people worth reaching out to
Search professionals by query and page through the results in the same conversation where the outreach gets drafted.
04
Picking up a search you set up earlier
Saved searches live in Harmonic; this reads their current results back without opening the dashboard.
05
Getting authenticated at the start of a session
The key is passed in as a tool call, so it lives in the session rather than in a config file on disk.
6 tools
Listed in project docs. Your client may show a different list.
harmonic_search_company_by_domainharmonic_search_companiesharmonic_search_peopleharmonic_get_saved_search_resultsharmonic_get_company_employeesBEFORE YOU INSTALL
What to know first
Tools you get
6 tools named in the project's documentation.
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
TERMINAL
git clone https://github.com/blue-yard/harmonic-mcp-server.git
cd harmonic-mcp-server
npm install
npm run buildMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"harmonic": {
"command": "node",
"args": [
"<YOUR_PATH_TO_HARMONIC_MCP_SERVER>/dist/standalone/index.js"
]
}
}
}
