AI Agents

MCP server

Give Claude Code, Claude Desktop, Cursor, and other MCP clients full control of your Hunch workspace.

Hunch exposes a Model Context Protocol (MCP) server so AI agents can read and act on your workspace directly, list accounts, inspect signal intelligence, trigger runs, manage ICPs and the knowledge base, and more. It exposes the same capabilities as the REST API and authenticates with the same API keys.

Endpoint

https://usehunch.co/mcp

It speaks JSON-RPC 2.0 over HTTP (initialize, tools/list, tools/call), protocol version 2024-11-05.

Connect Claude Code

Run once in your terminal:

Terminal

claude mcp add hunch --transport http https://usehunch.co/mcp \
  -H "Authorization: Bearer hunch_YOUR_KEY"

Connect Claude Desktop / Cursor

Add to your MCP config file:

claude_desktop_config.json

{
  "mcpServers": {
    "hunch": {
      "type": "http",
      "url": "https://usehunch.co/mcp",
      "headers": {
        "Authorization": "Bearer hunch_YOUR_KEY"
      }
    }
  }
}

The key can also be passed as a ?key= query parameter, but the Authorization header is preferred, query strings can leak into logs.

Available tools

Every tool mirrors a REST operation, so the two surfaces stay in lockstep. Tools that spend research resources (activate_account, scan_account, run_signal, find_accounts) require an active subscription.

Workspace

get_workspacetooloptional

Workspace info: name, plan, account counts, credits remaining, subscription status.

update_workspacetooloptional

Update workspace settings (currently: name).

get_integrations_statustooloptional

Connection status for CRM, Slack, webhooks, and MCP.

Accounts

list_accountstooloptional

List accounts with filters (status, owner_id, tag, domain, industry, min_score, search) and sorting.

get_accounttooloptional

A single account with full firmographics and why-now.

create_accountstooloptional

Create one or more accounts (max 500). Dedupes by domain.

update_accounttooloptional

Update name, domain, tags, owner, or firmographics.

delete_accounttooloptional

Permanently delete an account and tear down its monitor.

activate_accounttooloptional

Activate a suggested account: consumes a credit, enriches, and starts monitoring.

reject_accounttooloptional

Reject a suggested account (status -> rejected).

add_account_tagstooloptional

Add tags to an account.

remove_account_tagstooloptional

Remove tags from an account.

assign_account_ownertooloptional

Assign or clear an account owner (a member's user id, or null).

get_account_signalstooloptional

Signal intelligence: detections, alpha, evidence, narratives, why-reach-out, drafted outreach.

get_account_monitor_eventstooloptional

The monitor activity feed for an account.

scan_accounttooloptional

Trigger a fresh research pass for one account across all active signals.

push_accounts_to_crmtooloptional

Push accounts to the connected CRMs (HubSpot and/or Salesforce) with signal context.

enrich_accounttooloptional

Run enrichment for an active account on demand: company profile, workforce breakdown, and its employee roster into People.

People

The unlimited data layer: everyone at your activated accounts, decision-maker search, verified emails, phones, lists, and CRM push. None of these draw down a credit balance.

list_peopletooloptional

List people with filters (account_id, job_level, country_code, source, has_email, list_id, search).

get_persontooloptional

One person with their account and list memberships.

find_peopletooloptional

Find decision makers from a plain-English description. Compiles a prioritized title cascade, runs it across activated accounts, attaches verified emails.

sync_account_peopletooloptional

Load or refresh the full employee roster for an active account.

get_person_emailtooloptional

Reveal the verified work email for a person.

get_person_phonetooloptional

Reveal a mobile or direct phone for a person (US coverage).

push_people_to_crmtooloptional

Push people to the connected CRMs as Contacts linked to their company. Requires a verified email per person.

list_people_liststooloptional

List saved people lists with member counts.

create_people_listtooloptional

Create a people list.

delete_people_listtooloptional

Delete a people list (people are kept).

update_people_list_memberstooloptional

Add or remove people from a list.

Signals

list_signalstooloptional

List all signal definitions.

get_signaltooloptional

A signal including its compiled detection criteria.

create_signaltooloptional

Create a signal from a plain-English buying trigger (Hunch compiles it).

update_signaltooloptional

Update a signal. Changing plain_english re-compiles it.

delete_signaltooloptional

Delete a signal.

run_signaltooloptional

Run a signal now: discovery plus a scan of active accounts.

ICPs

list_icpstooloptional

List Ideal Customer Profiles.

get_icptooloptional

An ICP including its compiled profile.

create_icptooloptional

Create an ICP from a plain-English description.

set_active_icptooloptional

Make an ICP the active one used for discovery.

delete_icptooloptional

Delete an ICP.

Runs

list_runstooloptional

List signal and discovery runs, filterable by status.

get_runtooloptional

A run's details, spec, and stats.

find_accountstooloptional

Start a discovery run to find net-new accounts matching signals plus firmographic filters.

Saved searches

list_saved_searchestooloptional

List recurring daily discovery searches.

update_saved_searchtooloptional

Enable, disable, or rename a saved search.

delete_saved_searchtooloptional

Delete a saved search.

Knowledge base

list_knowledge_basetooloptional

List knowledge base sections (company context for detection and outreach).

get_company_profiletooloptional

The workspace company profile (name, domain, business context).

create_kb_sectiontooloptional

Add a knowledge base section.

update_kb_sectiontooloptional

Update a knowledge base section.

delete_kb_sectiontooloptional

Delete a knowledge base section.

Settings & members

get_notification_settingstooloptional

Notification and delivery settings (webhook, Slack, toggles).

update_notification_settingstooloptional

Update notification settings.

list_memberstooloptional

List workspace members and roles.

Example prompts

Once connected, you can just ask your agent:

“List my hot active accounts and show me the drafted outreach for the top three.” · “Check my most recent suggested accounts, activate the best two, then find the demand generation leader at each, get their emails, and draft outreach I can send.” · “Take my highest-scoring active account, pull its best marketing decision makers, and push them to HubSpot.” · “Run my ‘New Revenue Leader’ signal.” · “Find net-new SaaS companies in EMEA showing my expansion signal.”

Because signal context (why-now briefs, evidence, drafted openers) and people data (titles, verified emails) live behind the same key, one conversation can go from “who should I talk to” to a ready-to-send email without leaving your agent.

PreviousAPI keys