home / mcp / harmonic mcp server

Harmonic MCP Server

Provides programmatic access to Harmonic’s company and person enrichment APIs via 13 MCP endpoints for searching, looking up, and monitoring saved results.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "alludium-harmonic-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@alludium/harmonic-mcp-server"
      ],
      "env": {
        "HARMONIC_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can use this MCP server to access Harmonic AI API data for company and person enrichment, ideal for VC deal flow. It exposes a suite of tools that let you search, look up, and monitor companies and people, then integrate those results into your workflows and tools.

How to use

Use a compatible MCP client to connect to the Harmonic MCP server. You’ll interact with a collection of tools that perform specific Harmonic API actions, such as searching for companies, looking up company or person details, and monitoring saved searches for new results. Each tool returns structured data by default and can emit human-friendly markdown when requested.

How to install

Prerequisites: Node.js and npm should be installed on your system. You will run the MCP server via a local runtime command that uses npx to execute the package.

# Optional: install globally for convenience
npm install -g @alludium/harmonic-mcp-server

# Alternatively, run directly with npx without global install

Configuration

Set your Harmonic API key as an environment variable to authorize requests from the MCP server.

export HARMONIC_API_KEY=your_api_key_here

Usage with Claude Desktop and Claude Code

Integrate the Harmonic MCP server into Claude Desktop or Claude Code by adding an MCP server configuration that runs the MCP package with the proper environment variable.

{
  "mcpServers": {
    "harmonic": {
      "command": "npx",
      "args": ["-y", "@alludium/harmonic-mcp-server"],
      "env": {
        "HARMONIC_API_KEY": "your_api_key_here"
      }
    }
  }
}

Development mode

To run in development mode, start the server with the development script and provide your Harmonic API key as an environment variable.

HARMONIC_API_KEY=your_key npm run dev

Notes on usage patterns

You can perform complex workflows by combining multiple tools. For example, search for relevant companies, retrieve details for specific IDs, and then fetch associated employees or connections as needed. Use saved searches to monitor deal-flow momentum and only fetch net-new results to stay focused on fresh opportunities.

API Coverage and tools

The MCP server exposes a set of tools that map to Harmonic API endpoints. Each tool is designed to be used in sequences to build rich profiles of companies and people and to support deal-flow monitoring.

Troubleshooting and tips

If you encounter authentication issues, verify that HARMONIC_API_KEY is set correctly in your environment and that your key has access to Harmonic’s endpoints. If rate limiting occurs, the server will automatically throttle and retry requests.

Available tools

harmonic_search_companies

Perform a natural language search for companies, such as querying for AI startups in a city.

harmonic_search_typeahead

Provide quick autocomplete suggestions by company name or domain to speed up discovery.

harmonic_find_similar_companies

Find companies similar to a specified company by analyzing characteristics and connections.

harmonic_lookup_company

Look up a company by domain, LinkedIn URL, or other identifying attributes.

harmonic_get_company

Retrieve full details for a company by its ID.

harmonic_get_company_employees

Get employees of a company with filtering options like founders or executives.

harmonic_get_company_connections

Discover team network connections to a given company.

harmonic_lookup_person

Look up a person by LinkedIn URL or other identifiers.

harmonic_get_person

Get full details for a person by ID.

harmonic_list_saved_searches

List all saved searches or views for your workspace.

harmonic_get_saved_search_results

Fetch results from a saved search.

harmonic_get_saved_search_net_new_results

Retrieve only new results since the last check to monitor deal flow.

harmonic_clear_saved_search_net_new

Mark net-new results as seen to keep track of updated opportunities.