Skip to main content

Harmonic MCP Server - Getting Started Guide

Harmonic Team avatar
Written by Harmonic Team
Updated over a week ago

Harmonic MCP is a Model Context Protocol (MCP) server that connects applications and workflows to Harmonic's data platform. Use it with AI assistants, automation pipelines, custom integrations, or any MCP-compatible client.

What is Harmonic MCP?

The Harmonic MCP server provides AI assistants with access to:

Company Enrichment

Get detailed information about companies including funding, location, founders, and more


People Enrichment

Access professional profiles with work experience, education, and contact information


Smart Search

Find companies and people using natural language queries


Network Mapping

Discover connections between your team and companies/people


List Management

Create and manage lists of companies and people


Investor Data

Access and search investor information

Prerequisites

  • A Harmonic account (sign up at console.harmonic.ai)

  • An MCP-compatible client (AI chatbots like Claude Desktop/Web, automation tools, or custom applications)

Authentication Options

You can authenticate with the Harmonic MCP server using either method:

  • OAuth 2.0 – Recommended for interactive applications. The OAuth flow will redirect you to console.harmonic.ai to log in.

  • API Key – Recommended for programmatic workflows and server-to-server integrations. Get your API key from the API Usage Dashboard.

Quick Setup

Connection Details

The Harmonic MCP server is available at:

Step 1: Configure Your MCP Client

The Harmonic MCP server uses OAuth 2.0 authentication. Your MCP client will automatically handle the OAuth flow when you configure the server.

For Claude Desktop

Add the Harmonic MCP server to your Claude Desktop configuration file:

For SSE Transport (Recommended):

json {
   "mcpServers": {
     "harmonic": {
       "transport": {
         "type": "sse",
         "url": "https://mcp.api.harmonic.ai/sse"
       }
     }
   }
 }

Or HTTP Transport:

json {
   "mcpServers": {
     "harmonic": {
       "transport": {
         "type": "http",
         "url": "https://mcp.api.harmonic.ai"
       }
     }
   }
 }

For Claude Web

1. Navigate to claude.ai
2. Go to Settings → Integrations
3. Click "Add Server"
4. Enter the server URL: https://mcp.api.harmonic.ai/sse
5. Follow the OAuth authentication flow

For Other MCP Clients

Consult your MCP client's documentation for how to add a server. You'll need:

Step 2: Authenticate

  1. Restart your MCP client after updating the configuration

  2. When the client connects to the Harmonic MCP server, it will automatically detect OAuth endpoints

  3. You'll be prompted to authenticate via Harmonic's console

  4. After authentication, your client will store your access token and refresh it automatically

Note: The OAuth flow will redirect you to console.harmonic.ai to log in, then redirect back to complete authentication.

Available Tools

The Harmonic MCP server provides 26 tools organized into categories:

Enrichment Tools

  • enrich_company: Get detailed data for a single company by website, LinkedIn, Crunchbase, etc.

  • enrich_person: Enrich a person by LinkedIn URL

Search Tools

  • search_companies_natural_language: Search for multiple companies matching criteria using natural language

  • typeahead_search: Fast typeahead search for companies, people, and investors by name/domain

Saved Search Tools

  • get_saved_search_companies_results: Get company saved search results (supports pagination)

  • get_saved_search_companies_net_new: Get net new company results for subscribed searches

  • get_saved_search_people_results: Get people saved search results (supports pagination)

  • get_saved_search_people_net_new: Get net new people results for subscribed searches

  • get_saved_search_investors_results: Get investor saved search results (supports pagination)

  • get_saved_search_investors_net_new: Get net new investor results for subscribed searches

  • list_saved_searches: List all saved searches you have access to

Network Mapping Tools

  • get_company_user_connections: Get team network connections to a company

  • get_person_user_connections: Get team network connections to a personList

Management Tools

  • get_company_list_entries: Get entries from a company list

  • create_company_list: Create a new company list

  • add_companies_to_list: Add companies to an existing list

  • get_people_list_entries: Get entries from a people list

  • create_people_list: Create a new people list

  • add_people_to_list: Add people to an existing listLookup Tools

  • get_companies_by_id: Get companies by ID or URN (batch lookup up to 50)

  • get_persons_by_id: Get persons by ID (batch lookup up to 50)

  • get_investor: Get investor by canonical URLInvestor Tools

  • Additional investor-specific search and enrichment capabilities

Best Practices

Tool Safety Hints: Read-Only vs. Destructive Actions

Each tool exposed by the Harmonic MCP server includes hints indicating whether it performs read-only or destructive (write) operations:

  • Read-only tools (e.g., enrich_company, search_companies_natural_language, get_company_list_entries) only retrieve data and are safe to execute automatically.

  • Destructive tools (e.g., add_companies_to_list, create_company_list, add_people_to_list) modify data and should be treated with caution.

Recommendation for client implementations: Before executing any tool marked as destructive, consider implementing human-in-the-loop (HITL) confirmation steps or other safeguards appropriate to your workflow. This ensures users have visibility and control over actions that create or modify data in Harmonic.

Example Use Cases

Example 1: Enrich a Company

Prompt: "Get detailed information about Anthropic, including their funding, location, and founders."

Your AI assistant will use the enrich_company tool to retrieve comprehensive company data.

Example 2: Search for Companies

Prompt: "Find fintech companies in New York that raised Series B funding in the last 6 months."

Your AI assistant will use search_companies_natural_language to find matching companies.

Example 3: Create a Company List

Prompt: "Create a list called 'AI Startups' and add Anthropic, OpenAI, and Cohere to it."

Your AI assistant will:

  1. Use typeahead_search to find company URNs

  2. Use create_company_list to create the list

  3. Use add_companies_to_list to populate it

  4. Return the list ID for future reference

Example 4: Map Your Network

Prompt: "Show me which people on my team are connected to Stripe."

Your AI assistant will use get_company_user_connections to identify team connections.

Privacy and Data Handling

Data Collection and Usage

The Harmonic MCP server acts as a secure proxy between your AI assistant and the Harmonic API. Here's how we handle your data:

  • Authentication Tokens: Your JWT tokens are used only to authenticate requests to the Harmonic API. They are not stored, logged, or shared with third parties.

  • OAuth State: Temporary OAuth state is stored in Google Cloud Datastore with a 10-minute expiration for the OAuth flow only.

  • Request Data: Tool parameters and responses are passed through the server but not stored or logged.

  • No Conversation Data: The server does not collect or store conversation data from your AI assistant.

Privacy Policy

For complete information about how Harmonic collects, uses, and retains data, please see our Privacy Policy.

Security

  • OAuth 2.0: The server uses OAuth 2.0 with Firebase JWT tokens signed using certificates from Google's recognized certificate authority

  • HTTPS: All communications are encrypted via HTTPS

  • Authentication Required: All requests require valid authentication (JWT token)

Troubleshooting

"Unauthorized" Error

  • Possible causes:

    • OAuth authentication failed or was cancelled

    • Token expired and refresh failed

    • OAuth callback URL not properly configured

  • Solutions:

    • Check that you completed the OAuth flow in your browser

    • Verify your Harmonic account is active and accessible

    • Try removing and re-adding the MCP server configuration to trigger a new OAuth flow

    • Check your MCP client logs for OAuth errors

Tools Not Appearing

  • Possible causes:

    • MCP server not properly configured

    • Authentication failed

    • Client needs restart

  • Solutions:

    • Verify your configuration is correct

    • Check authentication credentials

    • Restart your MCP client after configuration changes

Rate Limiting

  • If you encounter rate limit errors:

    • The Harmonic API has rate limits to ensure fair usage

    • Wait a moment before making additional requests

    • Consider using field groups to request only needed data

Support

For issues or questions:

Additional Resources

──────────

Last Updated: January 2026
​Version: 1.1.0

Related Articles
Harmonic Data Fields
Harmonic Chrome Extension
Getting Started with the Harmonic API
Harmonic API Playbook
Did this answer your question?