Harmonic MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Harmonic MCP or direct API to discover companies, enrich people and company profiles, search market data, and manage saved searches through natural language.

Harmonic logoHarmonic
Api Key

Harmonic is a company and people data platform for discovering and enriching business contacts. It helps go-to-market and investment teams find prospects, research markets, and manage saved searches.

76 Tools

Try Harmonic now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Harmonic
Try asking
TOOLS

Supported Tools

Every Harmonic action and event your agent gets out of the box.

Batch Delete Company Attachments

OFFICIAL MIGRATION-DOC CONFLICT: Harmonic's migration documentation retires adjacent v1 attachment flows but does not document this owner-retained collection route.

Batch Delete Investor Attachments

Delete multiple investor attachments and return the deleted count.

Batch Delete Person Attachments

OFFICIAL MIGRATION-DOC CONFLICT: Harmonic's migration documentation retires adjacent v1 attachment flows but does not document this owner-retained collection route.

Batch Get Companies

Return up to 500 Harmonic companies by numeric IDs and company URNs using the JSON-body batch endpoint.

Batch Get Investor Attachments

Return attachment metadata for Harmonic investors.

Batch Get Persons

Return up to 500 Harmonic people by numeric IDs and person URNs using the JSON-body batch endpoint.

Batch Get Workspace Records

Fetch documented core fields and requested typed attribute values for multiple Workspace records of one record type.

Clear Saved Search Net-New Results

Clear net-new state for selected company or person URNs in a shared saved search.

Complete Investor Attachment Uploads

Finalize investor attachments after their bytes were sent to upload_uri values returned by initiation.

Create Import

Start an asynchronous import of up to 1,000 rows into exactly one list or record type.

Create List

Create a shared Workspace list for one record type.

Create Workspace List Attribute

Create a list-entry field from the documented metadata subset: numeric, currency, traction, select, status, or owner reference.

Create List Entries

Copy one explicit or filtered selection into a target list.

Create List Entry

Add one record to a Workspace list and optionally set values.

Create Named View

Create a saved Workspace view for exactly one list or record type.

Create Record Attachment

Upload one file of at most 500 MB to a Workspace record.

Create Workspace Record Attribute

Create a record-level field from the documented metadata subset: numeric, currency, traction, select, status, or owner reference.

Create Saved Search

Create a Harmonic saved search from an exact recursive filter, pagination, sort, and column-view configuration.

Create Scout Task

Create a Scout research task and immediately return its task_id and non-terminal status.

Delete Investor Attachment

Delete one investor attachment.

Delete List

Delete a shared Workspace list.

Delete Workspace List Attribute

Permanently delete a custom list attribute by URN.

Delete List Entries

Remove an explicit or filtered selection of memberships from one list.

Delete List Entry

Remove one membership from a Workspace list.

Delete Named View

Permanently delete a Workspace named view.

Delete Record Attachment

Permanently delete a file attached to a Workspace record.

Delete Workspace Record Attribute

Permanently delete a custom record attribute by URN.

Enrich Company

Find a company from web or social identifiers.

Enrich Person

Find a person by LinkedIn profile URL, with email used as a fallback.

Export List CSV

Stream a Workspace list as CSV using selected columns and optional documented filters and sorts.

Export Named View CSV

Stream a saved Workspace named view as CSV using its stored columns, filter, and sorts.

Export Record Type CSV

Stream Workspace records of one record type as CSV using selected columns and optional documented filters and sorts.

Get Bulk Email Enrichment Job

Read one paid bulk email enrichment job and its credit-consuming work status.

Get Bulk Email Enrichment Usage

Return the paid bulk email enrichment product's current monthly credit usage, limit, and remaining balance.

Get Companies

Return up to 50 Harmonic companies by numeric IDs and company URNs using the repeated-query GET endpoint.

Get Company

Return one Harmonic company by its numeric ID, UUID, or company URN.

Get Company User Connections

Return the workspace users connected to a Harmonic company and the email, calendar, or LinkedIn sources establishing each connection.

Get Enrichment Status

Check enrichment jobs by enrichment UUID or enrichment URN and return their current statuses.

Get Import Task

Poll an asynchronous Workspace import and return one optionally status-filtered Relay page of row results.

Get Investor Attachment Content

Return Harmonic's short-lived content URL as a downloadable file reference.

Get Named View

Return a saved Workspace view's documented filter, columns, sorts, default state, and owning list or record type.

Get Person

Return one Harmonic person by numeric ID, UUID, or person URN, optionally using company URNs to provide company context.

Get Persons

Return up to 50 Harmonic people by numeric IDs and person URNs using the repeated-query GET endpoint.

Get Record Type

Return a Workspace record type, its documented attributes, and one Relay page of records.

Get Saved Search Net-New Results

Return one page of entities newly matching a shared Harmonic saved search.

Get Saved Search Results

Return one page of company, person, user, or investor results from a saved search, optionally hydrated into entity objects.

Get Scout API Usage

Return one page of usage for existing Scout API runs.

Get Scout Task

Poll an existing Scout task until its status is terminal.

Get Similar Companies

Return Harmonic company URNs ranked as similar to a source company.

Get Workspace

Return the connected team's Workspace identity, built-in record types, and documented Harmonic attribute catalogs.

Get Workspace List

Return list metadata and one filtered, sorted Relay page of entries.

Get Workspace List Entry

Return one list membership, its underlying record, and explicitly requested typed attribute values.

Get Workspace Record

Return one scoped Workspace record with requested typed values, one attachment page, and documented update-event fields.

Initiate Investor Attachment Uploads

Create attachment metadata and presigned upload destinations for an investor.

Link Company Attachments

OFFICIAL MIGRATION-DOC CONFLICT: Harmonic's migration documentation retires adjacent v1 attachment flows but does not document this owner-retained collection route.

Link Investor Attachments

Link uploaded attachments to an investor.

Link Person Attachments

OFFICIAL MIGRATION-DOC CONFLICT: Harmonic's migration documentation retires adjacent v1 attachment flows but does not document this owner-retained collection route.

List Company Employees

Return one page of person URNs associated with a company, filtered by employee group, status, or connection status.

List Saved Searches

Return the saved searches visible to the API key's team.

Reconnect Scout Task Stream

Reconnect to a Scout text/event-stream using the task_id emitted by the first event of STREAM_SCOUT_TASK.

Run Scout Task and Wait

Create a Scout research task, hold the connection until it finishes, and return markdown or json_schema-structured content.

Search Companies by Keywords

Search Harmonic companies with explicit keyword inclusion and exclusion fields.

Search Typeahead

Return Harmonic typeahead suggestions for companies, people, investors, schools, users, or locations.

Search with Agent

Search companies from a natural-language request and return Harmonic's parsed query interpretation.

Stream Scout Task

Create a Scout task, capture its mandatory first SSE task_id event, and close the initial stream immediately so the paid task is recoverable.

Submit Bulk Email Enrichment Job

Submit 1-5,000 people for paid bulk email enrichment using exactly one identifier array.

Update List

Rename a shared Workspace list.

Update Workspace List Attribute

Rename a Workspace list attribute and/or update its documented numeric, currency, traction, select, or status metadata.

Update List Entries

Set supplied attribute values on an explicit or filtered selection of list memberships.

Update List Entry

Update only the supplied attribute values on one list membership.

Update Named View

Update provided fields on a Workspace named view.

Update Workspace Record

Update only the supplied record-level values and/or shared team note.

Update Record Attachment

Rename a file attached to a Workspace record; file content is unchanged.

Update Workspace Record Attribute

Rename a Workspace record attribute and/or update its documented numeric, currency, traction, select, or status metadata.

Update Workspace Records

Set record-level attribute values across one explicit or filtered Workspace selection.

Update Workspace Team Note

Set or clear a shared record note using a record URN or Harmonic entity URN.

SETUP GUIDE

Connect Harmonic MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["harmonic"],
  mcp: true,
});
Create a session scoped to Harmonic and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Find software companies in New York with more than 100 employees",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Harmonic request
SETUP GUIDE

Connect Harmonic API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["harmonic"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Harmonic
3

Run Harmonic tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Find software companies in New York with more than 100 employees" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Harmonic tool calls through the session, and print the final answer

Why Use Composio?

AI Native Harmonic Integration

  • Supports both Harmonic MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable company and people data queries
  • Rich coverage for discovery, enrichment, saved searches, and workspace operations

Secure API Key Management

  • Securely store and use your Harmonic API key without hard-coding credentials
  • Central place to manage, scope, and revoke Harmonic access
  • Per user and per environment credentials for safer agent workflows

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Harmonic
  • Scoped, least privilege access to Harmonic resources
  • Full audit trail of agent actions to support review and compliance
FRAMEWORKS

Use Harmonic with any AI Agent Framework

Choose a Framework you want to connect Harmonic with

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with Harmonic.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Harmonic tool your agent needs.Free to start.

Start building