Skip to main content

MCP Tools — v2

Coming soon

The v2 MCP API is in preview and not yet generally available. These pages document its tools and request/response shapes; live data access is limited to enrolled organizations until v2 is released.

The v2 MCP tool suite (63 tools), grouped by category. Each tool's page is generated from the live tool registry, so it always matches what the server serves. See the MCP Tools overview for data coverage, pricing, and common usage patterns.

Downloads

Data​

  • Company AI Maturity — Scores how advanced a batch of companies is at AI and data, their GenAI buying intent, and which cloud provider each centers on — call it when a user asks any of those about one or more named companies.
  • Company AI Spend — Estimated annual AI spend (USD) for companies, broken down by AI category and country, from HG Insights v2.
  • Company Cloud Spend — Map a company's cloud and internet-infrastructure vendor footprint (HG Insights v2).
  • Company Contracts — Retrieve contract intelligence for a specific company — ICT outsourcing deals (via GSIs such as Accenture, IBM, Cognizant) and U.S.
  • Company Enrich — Enrich a BATCH of up to 25 companies with multiple data sections in a single call, returned as { companies: [...] }.
  • Company FAI (Functional Area Intelligence) — Functional Area Intelligence (FAI): the DEPARTMENTAL / functional-area breakdown of technology usage at ONE company — which departments, roles, and locations use detected technologies, with per-department usage share and signal strength, per-role usage share, and decision-maker / influencer presence and titles.
  • Company Firmographic — Batch firmographic lookup for one or more known companies.
  • Company Government Opportunities — Find open U.S.
  • Company Gov Relationships — Map a single company's federal teaming partners from USAspending.gov subaward records.
  • Company Hierarchy — Traverse the UCM corporate ownership tree (parents, subsidiaries, sister companies) for ONE company by HG id or domain.
  • Company Install Time Series — Track how a company's technology adoption changes over TIME: returns a monthly installation-intensity time series per product for one company.
  • Company Intent — Get buying-intent signals for ONE SPECIFIC, ALREADY-KNOWN company, identified by company_domain or hg_id.
  • Company Operating Signals — Retrieve a single company's operating profile as categorical STAGE LABELS, rolling up HG mentions and AI-maturity data into two groups.
  • Company Spend — Estimate a company's IT spend in USD, broken down by spend category and country, from HG Insights modeled spend data (v2).
  • Company Technographic — Call this when a user asks what technology a company uses, what its tech stack is, or whether a specific product is installed.
  • Contact Enrich — Use only after contact_search (2 credits per call) has identified the person — do not use for open-ended discovery.
  • Contact Search — Discover PEOPLE (contacts) at a company by job title, seniority, and location — returns a list of individuals (name, title, seniority, LinkedIn, org), not company facts.
  • Customer Data: Discover Datasets — Auto-discover the structure of YOUR organization's own connected Snowflake data (not HG Insights data).
  • Explore Customer Data (Snowflake) — Inspect the structure of YOUR ORGANIZATION'S OWN Snowflake data (the customer's connected warehouse), not HG Insights' datasets.
  • Customer Data Query — Run a read-only SQL SELECT against the ORG'S OWN connected Snowflake data warehouse (the customer's data — e.g.
  • Get Product Attribute — Resolve HG Insights product-attribute IDs from a search theme.
  • Get Product Category — Resolve a term to the exact HG Insights taxonomy category name/id needed by company_technographic before an install query.
  • Get Product Information — Comprehensive TrustRadius product information for a software product by name — overview, rating and review count, and (optionally) pricing, competitors, integrations, and the TrustRadius score breakdown.
  • Get Product Reviews — Filtered TrustRadius reviews for a software product by name — date range, rating bounds, and pagination, with an aggregated pros/cons summary and per-review reviewer firmographics.
  • Get Vendor Information — Resolve a vendor/company name into its HG Insights vendor_id (and metadata) so you can filter other tools by that vendor.
  • HG Data Warehouse Catalog — Browse the HG Insights data warehouse SCHEMA (table/column names and types, join keys, indexing hints, sql_qualifier) to plan an hg_data_query — returns schema metadata, NOT data rows.
  • HG Data Query (SQL) — Execute read-only SQL SELECT queries against the HG Insights data warehouse.
  • List FAI Departments — Resolver for the Functional Area Intelligence (FAI) taxonomy: lists the valid FAI department and role names (with their hex-encoded IDs) from the official HG Insights catalog.
  • Intent Topic Catalog (Resolver) — RESOLVER: list valid intent topic names + hex IDs from the official HG Insights catalog (20,000+ topics).
  • Product Search and Enrich — Discover and hydrate products/technologies from the HG Insights product catalog (the technographic taxonomy of vendors, products, and categories).
  • Search Companies — Search and discover companies using the HG Insights v2 search API.
  • Search Federal Contracts — Broad SEARCH of U.S.
  • Search Government Opportunities — Broad market SEARCH of OPEN U.S.
  • Search Industries (NAICS / SIC) — RESOLVER: find industry codes (HG industry_id, NAICS, SIC) by keyword to feed into search_companies (industry_ids, naics_codes, sic_codes).
  • SEC Filing Section — Fetch the full text of one named section from a specific company's SEC 10-K (annual), 10-Q (quarterly), or 8-K (current event) filing, returned as clean text.
  • SEC Full-Text Search — Search within SEC filing content (the EDGAR full-text index) for specific terms or phrases.
  • Web Search — General-purpose web search for information that is NOT in HG Insights' proprietary data — recent news, general facts, and public-web context about people, products, or events outside HG's firmographic/technographic/intent datasets.

Agents​

  • Get Phoenix Artifact — Retrieve ONE Phoenix artifact by its id and, when the deliverable is a small HTML brief, inline its content.
  • Get Phoenix Run Status — Check the status and details of a Phoenix agent run started by phoenix_invoke_agent.
  • Invoke Phoenix Agent — Start a Phoenix AI agent run with the given inputs.
  • List Phoenix Agents — List the Phoenix AI agents this organization has published and can invoke.
  • List Phoenix Artifacts — Browse this organization's Phoenix artifacts — the canonical deliverable (one brief per succeeded agent run or upload) already produced in this org.
  • Phoenix Onboarding — Onboards a new user or agent to Phoenix: renders a branded, personalized getting-started widget recommending the best GTM workflows to run first, with a text fallback for clients that cannot render MCP-app widgets.
  • Upload Phoenix Artifact — Register an externally-produced PDF or HTML file into Phoenix as an artifact by giving a publicly-fetchable https URL to the bytes.

Admin​