harmonic-mcp-server

# 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: ```bash npm install ``` Build the server: ```bash 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`: ```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 ## 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: ```bash npm run dev ``` ## API Documentation For more information about Harmonic's API, visit: https://console.harmonic.ai/docs/api-reference/introduction