harmonic-ai

name

harmonic-ai

description

Harmonic is a startup intelligence platform that aggregates and analyzes data on companies, founders, investors, and market activity, enabling venture capital and growth teams to discover emerging startups, track opportunities, and integrate enriched company data into workflows via APIs and bulk data access. Read and write Harmonic.ai data through One: companies, persons, companywatchlists, peoplewatchlists, savedsearches, companyattachments and more, 81 actions with real parameter documentation. Use whenever the user asks to look something up in Harmonic.ai, create or update a record there, or build code against the Harmonic.ai API.

Harmonic.ai through One

Harmonic is a startup intelligence platform that aggregates and analyzes data on companies, founders, investors, and market activity, enabling venture capital and growth teams to discover emerging startups, track opportunities, and integrate enriched company data into workflows via APIs and bulk data access.

One exposes Harmonic.ai through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform harmonic-ai if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Harmonic.ai is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Harmonic.ai account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Companies

Action	Method	Path	Action id
Batch Get Company By Id Or Urn	GET	/companies	conn_mod_def::GKBWP4A46XE::Ll8DARErSI6909QHnNj9iQ
Get Company By ID or URN	GET	/companies/{{idOrUrn}}	conn_mod_def::GKBWQKN5bxM::O66MMdk-TUqGsBEN4oiZhQ
Get Global Company Custom Fields	GET	/companies/custom_fields	conn_mod_def::GKBWQaam7-s::h46q1c-6Sl2uSycGicAOlA
Batch Complete Upload for a Company	PUT	/companies/{{idOrUrn}}/attachments	conn_mod_def::GKBWPtXfZ_8::SJOEh1QTSjK-lb4U8V97QA
Batch Get Companies By ID or URN	POST	/companies/batchGet	conn_mod_def::GKBWPvniddg::9Omu8wQoTJ6KQCs0GM8qqw
Create Global Custom Field for Companies	POST	/companies/custom_field	conn_mod_def::GKBWP_ydd1o::mG49ZZBcTmmCMpVVmPIeXA
Get Company By Identifiers	POST	/companies	conn_mod_def::GKBWQN1BZIA::FbHuoVncQZm4s0YgBdFaFg
Global Import Companies	POST	/companies/entries	conn_mod_def::GKBWQjlIE7w::Y3Z-9EPyS4qT1NmB-pP3wQ
Link Attachments to a Company	PATCH	/companies/{{idOrUrn}}/attachments	conn_mod_def::GKBWQk2nbDM::jqjCD_PwSuuIuD3sll54SQ
Search Companies By Keywords	POST	/search/companies_by_keywords	conn_mod_def::GKBWQtQbDMY::8MtV45rlQMykFOB-AlmhRw
Update Global Custom Field	PUT	/companies/custom_field	conn_mod_def::GKBWQ05azUg::VFWGABzXSG6CuOazwP9J7A

Persons

Action	Method	Path	Action id
Batch Get Persons By Id Or Urn	GET	/persons	conn_mod_def::GKBWRla5A_Q::nYdSu3QFQvyYGor5mICCWQ
Get Person By ID or URN	GET	/persons/{{idOrUrn}}	conn_mod_def::GKBWRs4PDH0::8KPRakkTTWWw5jqSh9ePqA
Batch Get Persons by ID or URN	POST	/persons/batchGet	conn_mod_def::GKBWRY_CgU4::8mUw1RphQkCFD8Tt-Rc_MA
Delete Global Custom Field	DELETE	/persons/custom_field	conn_mod_def::GKBWRj6CbpM::-kTXFrDMRrqc6W2gRHplVw
Get Person By Canonical	POST	/persons	conn_mod_def::GKBWRtilq58::CfkNOKVCTOSPNqfGp2kOAg
Global Import People	POST	/persons/entries	conn_mod_def::GKBWRt01z2w::wEDmLC-GRd-4_7mNiBQoFw
Link Attachments to a Person	PATCH	/persons/{{idOrUrn}}/attachments	conn_mod_def::GKBWRtDsW5w::nWoKQu5hSGq-pmjplCHK9w
Update Global Custom Field for Persons	PUT	/persons/custom_field	conn_mod_def::GKBWR2JjRW8::KOIqQIVlQpCr0cgqgdw_XQ

CompanyWatchlists

Action	Method	Path	Action id
Get Company Watchlist	GET	/watchlists/companies/{{idOrUrn}}	conn_mod_def::GKBWQS5dQEE::sDf6uT0dQ02sgD_o3b6uIQ
Get Company Watchlists By Owner	GET	/watchlists/companies	conn_mod_def::GKBWQc6bZOk::fgh2p3f_TI-8s9kEAOIPVg
Add Companies To a Company Watchlist	POST	/watchlists/companies/{{idOrUrn}}:addCompanies	conn_mod_def::GKBWPuIJjLg::yxV0CmoORKC_K27oxDRpoA
Batch Delete Entries from a Company Watchlist	POST	/watchlists/companies/{{idOrUrn}}/entries:batchDelete	conn_mod_def::GKBWP4PyA5o::63R1TQD7QCKlwwLRi2T2TQ
Create Company Watchlist	POST	/watchlists/companies	conn_mod_def::GKBWP3zA8_o::c6HaSGUqTjitG2GauoARvA
Delete Company Watchlist	DELETE	/watchlists/companies/{{idOrUrn}}	conn_mod_def::GKBWP_m4iEc::zLNdqdWUTBy62OBLkZ0MxA
Update Company Watchlist	PUT	/watchlists/companies/{{idOrUrn}}	conn_mod_def::GKBWQr4_H1Q::BEWn4swwSkmv0-rfvB0Kfg

PeopleWatchlists

Action	Method	Path	Action id
Get a People Watchlist	GET	/watchlists/people/{{idOrUrn}}	conn_mod_def::GKBWRGPzx6M::KD_xw2fbTtGf_LqO9BYrgw
Get People Watchlists By Owner	GET	/watchlists/people	conn_mod_def::GKBWRF-JZIU::1mf3AJbGSq-Wh9hmhGnYqw
Add People To A People Watchlist	POST	/watchlists/people/{{idOrUrn}}:addPeople	conn_mod_def::GKBWQ1cwOIs::VoYdbUOYRAys9UjdXSQ96w
Create People Watchlist	POST	/watchlists/people	conn_mod_def::GKBWQ9O0lQI::p4bXCGh_TO6qzhLOJ_mhMw
Delete a People Watchlist	DELETE	/watchlists/people/{{idOrUrn}}	conn_mod_def::GKBWQ9FE7AU::YaeSingAQ9GO9Wgkrp2OfQ
Remove Person From a People Watchlist	POST	/watchlists/people/{{idOrUrn}}:removePeople	conn_mod_def::GKBWRP6O338::7Wi_SQCCRXqEeh_1fB8ang
Update a People Watchlist	PUT	/watchlists/people/{{idOrUrn}}	conn_mod_def::GKBWRPE5vnY::xIP7u3orT3Gs_mW3iPEyWA

SavedSearches

Action	Method	Path	Action id
Get Saved Search By Owner	GET	/saved_searches	conn_mod_def::GKBWR9Rx3P8::geJYC-tRR5648L0wxZBJew
Get Saved Searches By Owner	GET	/savedSearches	conn_mod_def::GKBWR9z3ne8::p4D26YcNR3S22lJtiZRgVA
Clear Net New Results for a Saved Search	POST	/savedSearches/{{idOrUrn}}/clear_net_new_results	conn_mod_def::GKBWR1-KoBA::UQ_7hS1LQ922Og1X3ovjTA
Clear Net New Results for a Saved Search	POST	/saved_searches/{{idOrUrn}}/clear_net_new_results	conn_mod_def::GKBWR2esLH8::APwTBClBRveoZxAQXheovQ
Create Saved Search	POST	/saved_searches	conn_mod_def::GKBWR1JVsZU::xUQgyZN2ReSD7_T4tGmjaQ
Create Saved Search	POST	/savedSearches	conn_mod_def::GKBWR1PVH70::Bf2cbtO3Sd-kvtaTZtxFlQ

CompanyAttachments

Action	Method	Path	Action id
Get a Company's Attachment Content	GET	/companies/{{idOrUrn}}/attachments/{{urn}}	conn_mod_def::GKBWQKEIrDA::W1xjcGM7RjuFKOQtG3KVjg
Batch Create Attachments for a Company	POST	/companies/{{idOrUrn}}/attachments	conn_mod_def::GKBWPth_hkQ::DYf5BOiDRVSs2uqdGHqH4A
Batch Get Company Attachments	POST	/companies/attachments	conn_mod_def::GKBWPtIChHo::CgqmrLLfSky2owi365_Yhw
Delete a Company's Attachment	DELETE	/companies/{{idOrUrn}}/attachments/{{urn}}	conn_mod_def::GKBWP_6YS-o::66ks5ucKR9a3t8DqzjyfEQ

CompanyWatchlistCustomFields

Action	Method	Path	Action id
Create a Company Watchlist Custom Field	POST	/watchlists/companies/{{idOrUrn}}/custom_field	conn_mod_def::GKBWP3cPIl0::zmH-i1bNTmeTKbokE5y--g
Delete a Company Watchlist Custom Field	DELETE	/watchlists/companies/{{idOrUrn}}/custom_field	conn_mod_def::GKBWQA4-54I::oqOzDey0TjeZBSya2whYXQ
Update a Company Watchlist Custom Field	PUT	/watchlists/companies/{{idOrUrn}}/custom_field	conn_mod_def::GKBWQ1opXc8::GxfJ8kqDRxi-Q1JuA7whcQ

PersonsAttachments

Action	Method	Path	Action id
Batch Complete Upload for a Person's Attachments	PUT	/persons/{{idOrUrn}}/attachments	conn_mod_def::GKBWRZviYpQ::KYPkiNmTTV2YW2isnES6fQ
Batch Create a Person's Attachments	POST	/persons/{{idOrUrn}}/attachments	conn_mod_def::GKBWRcVHNQ0::1x3r9jwMQoCSVc-CBhFMeg
Delete a Person's Attachment	DELETE	/persons/{{idOrUrn}}/attachments/{{urn}}	conn_mod_def::GKBWRjy0FWY::hWYjefArSDme12LVBYNJWA

CompanyWatchlistEntries

Action	Method	Path	Action id
Get Company Watchlist Entries	GET	/watchlists/companies/{{idOrUrn}}/entries	conn_mod_def::GKBWQKqi78I::Uf_LTr5RRxeFJYUFpD9_EA
Add Entries to a Company Watchlist	POST	/watchlists/companies/{{idOrUrn}}/entries	conn_mod_def::GKBWP3ozYZc::5qMO1n0TSL-zHoG63Z-DFg

PeopleWatchlistEntries

Action	Method	Path	Action id
Get People Watchlist Entries	GET	/watchlists/people/{{idOrUrn}}/entries	conn_mod_def::GKBWRH_8918::VTcz8l-iQ56DRY687qz4zA
Add Entries to a People Watchlist	POST	/watchlists/people/{{idOrUrn}}/entries	conn_mod_def::GKBWRQDnktw::jqJ4VfTuQrmmy8FZkcfPmg

SavedSearchResults

Action	Method	Path	Action id
Get Saved Search Results	GET	/saved_searches:results/{{idOrUrn}}	conn_mod_def::GKBWSA9TWyo::AFjpVixuQw-kjbGTAr3GrQ
Get Saved Search Results	GET	/savedSearches:results/{{idOrUrn}}	conn_mod_def::GKBWSKzYuwU::E9zinbXbSp2hYJCmCp8aIA

SavedSearchNetNewResults

Action	Method	Path	Action id
Get Saved Search Net New Results	GET	/savedSearches/{{idOrUrn}}/net_new_results	conn_mod_def::GKBWSArEMuM::YC1PkO4-RP6QjfR1fmaCrQ
Get Saved Search Net New Results	GET	/saved_searches/{{idOrUrn}}/net_new_results	conn_mod_def::GKBWR_Y34K0::UFDZk6Z0TFWm6GNsojX2kw

PeopleWatchlistCustomFields

Action	Method	Path	Action id
Create a People Watchlist Custom Field	POST	/watchlists/people/{{idOrUrn}}/custom_field	conn_mod_def::GKBWQ-GsA9g::ZTRZT74tRbWjVlCz_d3coA
Delete a People Watchlist Custom Field	DELETE	/watchlists/people/{{idOrUrn}}/custom_field	conn_mod_def::GKBWQ99ZfaQ::4k05n7ImTTmFj0mtLPm99A

CustomFields

Action	Method	Path	Action id
Get Global Custom Fields	GET	/persons/custom_fields	conn_mod_def::GKBWRtTIdRk::qtEb4L6cQ5erbuhHdwCI4A
Delete Global Custom Field	DELETE	/companies/custom_field	conn_mod_def::GKBWQAWSrC0::RbEyzy4QRfihZazbbIBDNw

PersonAttachments

Action	Method	Path	Action id
Get a Person Attachment's Content	GET	/persons/{{idOrUrn}}/attachments/{{urn}}	conn_mod_def::GKBWRkfFaXo::45Gz_DXARcaw97APhMsckg
Batch Get Person Attachments	POST	/persons/attachments	conn_mod_def::GKBWRZNtY9E::CWbxVzxdS4aIaA1E9aN2hA

UserPeopleImportEntries

Action	Method	Path	Action id
Get User People Import Entries	GET	/watchlists/people/imports/{{idOrUrn}}/entries	conn_mod_def::GKBWRRNir_E::YGOmAVqLSQaU4n6oqkKKsw

PeopleWatchlistCustomField

Action	Method	Path	Action id
Update a People's Watchlist Custom Field	PUT	/watchlists/people/{{idOrUrn}}/custom_field	conn_mod_def::GKBWRRyf0xA::WHws3to8TROLI_M4uErSaQ

SimilarCompanies

Action	Method	Path	Action id
Search Similar Companies	GET	/search/similar_companies/{{idOrUrn}}	conn_mod_def::GKBWQs-6_Lk::ceFcemE9QJK0eIq6jP_6pw

SearchAgent

Action	Method	Path	Action id
Search Agent	GET	/search/search_agent	conn_mod_def::GKBWQtC7cG4::ZupL8vm5TTOH2yC8y76Dag

Search

Action	Method	Path	Action id
Typeahead Search	GET	/search/typeahead	conn_mod_def::GKBWQtFFmPg::ETrJb4Y-QQigwd0tNpHXLw

EnrichmentRequestStatus

Action	Method	Path	Action id
Get Enrichment Request Status	GET	/enrichment_status	conn_mod_def::GKBWQ1fSBpM::NzuFQ3njRXWClzylkI_kdA

CompanyWatchlistsNamedViews

Action	Method	Path	Action id
Upsert a Company Watchlist's Named Views	POST	/watchlists/companies/{{idOrUrn}}/named_views	conn_mod_def::GKBWQ1vkvIs::ymiNU4xaSze84J0bUvRpDQ

UserConnections

Action	Method	Path	Action id
Get a Company's User Connections	GET	/companies/{{idOrUrn}}/userConnections	conn_mod_def::GKBWQkUE8yo::N-eoFMu1Rna-7vXbFFEeqQ

UserCompanyImports

Action	Method	Path	Action id
Get User Company Import	GET	/watchlists/companies/imports/{{idOrUrn}}	conn_mod_def::GKBWQaxmMQw::YTLUC9C4QL2hwy3jE1rcjw

CompanyWatchlistImports

Action	Method	Path	Action id
Get Company Watchlist Imports	GET	/watchlists/companies/{{idOrUrn}}/imports	conn_mod_def::GKBWQb4InhM::YVeqxbk-RkmUq5PMQxnJvA

CompanyEmployees

Action	Method	Path	Action id
Get a Company's Employees	GET	/companies/{{idOrUrn}}/employees	conn_mod_def::GKBWQccFKgM::uvYounZWQfyc9dbSXN5K5A

UserCompanyImportEntries

Action	Method	Path	Action id
Get User Company Import Entries	GET	/watchlists/companies/imports/{{idOrUrn}}/entries	conn_mod_def::GKBWQlGbkfo::kM1HMK0FSxOTe9NG0nhHoA

UserPeopleImports

Action	Method	Path	Action id
Get User People Import	GET	/watchlists/people/imports/{{idOrUrn}}/	conn_mod_def::GKBWRFh6Zxw::fLCXAgJ7TC2NCe8L8kzkbw

PeopleWatchlistsImports

Action	Method	Path	Action id
Get a People Watchlist's Imports	GET	/watchlists/people/{{idOrUrn}}/imports	conn_mod_def::GKBWRFnw9vw::Eh4XH1vPTO2NAUY17IwtLA

PeopleWatchlistsNamedViews

Action	Method	Path	Action id
Upsert a People Watchlist's Named Views	POST	/watchlists/people/{{idOrUrn}}/named_views	conn_mod_def::GKBWRa0XRBw::ULHHjAMsTyWHhFmFEShYVg

PersonsCustomField

Action	Method	Path	Action id
Create Global Custom Field for Persons	POST	/persons/custom_field	conn_mod_def::GKBWRkeoPAs::6W-wCL2ZSgOY0onJecS5xg

PersonWatchlistEntries

Action	Method	Path	Action id
Batch Delete Entries from a Person Watchlist	POST	/watchlists/people/{{idOrUrn}}/entries:batchDelete	conn_mod_def::GKBWQ9uygOc::M9676xUsSrqyRg-7V_kGPA

Watchlists

Action	Method	Path	Action id
Remove Companies From a Company Watchlist	POST	/watchlists/companies/{{idOrUrn}}:removeCompanies	conn_mod_def::GKBWQk8c56A::rNtLF9DETHCf2MFXAw2AAw

When a call fails

The error comes from Harmonic.ai, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/harmonic-ai

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.