Skip to main content

Harmonic MCP Server - Getting Started Guide

Written by Harmonic Team
Updated today

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.

Quick Setup

Connecting via Claude

The fastest way to get started is through Claude's built-in Connectors directory, available on both Claude Web and Claude Desktop:

  1. Go to claude.ai or open Claude Desktop

  2. Click your profile icon → Settings

  3. Select Connectors from the left menu

  4. Under the Web tab, find Harmonic ("Discover, research, and enrich companies and people")

  5. Click the + button to add it

  6. Complete the OAuth flow by logging into your Harmonic account

Once connected, you can immediately start asking Claude questions about companies, people, and investors using Harmonic's data.

Connecting via Claude Code

To add the Harmonic MCP server to Claude Code, run the following command:

bash

claude mcp add --transport http harmonic https://mcp.api.harmonic.ai/

After adding the server, authenticate by running:

bash

claude /mcp

Follow the OAuth flow to log into your Harmonic account. Once authenticated, you can start using Harmonic tools directly in Claude Code.

Connecting via ChatGPT

You can enable MCP servers on ChatGPT with a Pro, Plus, Business, Enterprise, or Education account. Follow the OpenAI documentation for setup instructions. Use the following parameters:

  • Server URL: https://mcp.api.harmonic.ai

  • Connection mechanism: OAuth

Connecting via other MCP Clients

For any MCP client that supports manual server configuration (Claude Desktop, Cursor, Windsurf, etc.), you'll need:

Most clients use a JSON configuration file. Here's an example using HTTP transport (recommended):

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

Or using SSE transport:

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

After updating the configuration, restart your MCP client. It will automatically detect the OAuth endpoints and prompt you to log in via console.harmonic.ai.

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, ChatGPT, 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.

MCP Access & Limits

How MCP usage is metered depends on how you authenticate.

Authenticating with an API Key

Requests consume API credits from your team's pool, with the same access and limitations as direct API usage. No additional configuration is needed.

Authenticating as a User (OAuth)

When you sign in through an MCP client like Claude, ChatGPT, or Cursor using your Harmonic account, your access depends on your team's API plan:

  • No API access: Each user gets 10 requests per day at no cost. Deal data is not available.

  • Limited API access: Each user gets 10 requests per day at no cost. To allow MCP requests to draw from your team's API credit pool (with no daily cap), a team admin must enable "Use API credits for MCP requests" in the MCP integration settings here.

  • Unlimited API access: There is no limit on MCP usage.

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 Zapier App [Beta]
Harmonic API Playbook
Did this answer your question?