Glossary

Plain-language definitions of the terms and identifiers used across the Phoenix docs and MCP tool responses. If a tool page or parameter uses a word you don't recognize, it's probably here.

Core concepts

MCP (Model Context Protocol) : An open standard that lets AI assistants (Claude, ChatGPT, and others) call external tools and data sources through one uniform interface. Phoenix exposes its data as MCP tools, so any MCP-capable client can query company intelligence without a bespoke integration. See the MCP clients guide.

Tool : A single callable operation exposed over MCP — e.g. company_firmographic or search_companies. Each has a name, an input schema (parameters), and a response shape. Browse them in the MCP Tools overview.

Agent : A pre-built Phoenix workflow that orchestrates several tools to produce a larger deliverable (e.g. an account research brief), invoked via the phoenix_* tools. See Agents.

Data types

Firmographic : Company-level attributes — legal name, headquarters location, industry, employee count, revenue, corporate hierarchy, and classification codes. Answered by company_firmographic.

Technographic : The technologies (products/vendors) a company has installed or uses, with a usage intensity signal and verification dates. Answered by company_technographic.

Intent : Signals that a company is actively researching a topic, product, or category — used to spot buying interest. Answered by company_intent and intent_category.

FAI (Functional Area Intelligence) : HG Insights' breakdown of a company's technology footprint by department / functional area (e.g. Marketing, Finance, IT) rather than by product alone — useful for seeing which teams drive adoption. See company_fai and list_fai_departments.

Modeled spend : HG Insights' estimated IT/technology spend for a company, in dollars, derived from its models rather than reported financials — treat it as a directional estimate, not an invoiced figure. Returned by company_spend. (By contrast, company_cloud_spend returns cloud/technology vendors, not dollar amounts.)

Identifiers & codes

hg_id (a.k.a. companyId) : The HG Insights company ID — a 31–32 character alphanumeric string that uniquely identifies a company in the HG data fabric. Returned as hg_id by search_companies and as companyId by the company_* tools. Pass it to a tool's hg_id parameter to look a company up precisely — prefer it over a domain whenever you have it, since a domain can be ambiguous and hg_id is exact. It takes precedence over companyDomain when both are supplied.

NAICS / SIC : Standard U.S. industry classification code systems. NAICS (North American Industry Classification System) codes are hierarchical prefixes — 54 covers all 54xxxx codes, 541512 is exact. SIC (Standard Industrial Classification) is the older system. Resolve valid codes with search_industries_naics_sic.

company_level : A company's tier in HG's Unified Company Model hierarchy — one of Group HQ (ultimate parent), Corporate Parent, Domestic Parent, Site, or Subsidiary. For a subsidiary, chain enrichment on global_hq_id to reach the ultimate parent.

Integration slugs

Each MCP tool lists the integration(s) your organization must have configured for it to be available (its "Required Integrations"). These are referenced by short slugs; enable them in the Phoenix Integrations settings.

Slug	What it is
hginsights	HG Insights core data API (technographic, spend, intent).
hginsights_v2	HG Insights v2 API (firmographics, AI maturity, and newer datasets).
hginsights_v2__data_api	HG Insights Data API (aggregated data endpoints).
hginsights_db_query	HG Insights data-warehouse query access (hg_data_query, hg_catalog).
intricately	HG Insights Cloud Dynamics (cloud footprint / spend signals).
snowflake	Your own Snowflake warehouse, joined to enrich results with your account data.
sec_api	SEC EDGAR filings access (sec_full_text_search, sec_filing_section).
datagov	U.S. federal data (SAM.gov / USAspending.gov) for government-contracting tools.
tavily	Tavily web-search provider (web_search).
apollo / zoominfo	Contact data providers (contact_search, contact_enrich).
trustradius_intent / trustradius_product_data	TrustRadius review and buyer-intent data.