Company Contracts

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.

Retrieve contract intelligence for a specific company — ICT outsourcing deals (via GSIs such as Accenture, IBM, Cognizant) and U.S. federal government contract awards (USAspending.gov). Accepts a batch: pass hg_ids and/or domains (up to 25 companies) and receive one entry per company under companies[]. Returns vendor name, deal value, contract title/summary, dates, service lines, pricing, and customer context. Federal enrichment (include_federal_contracts) is single-company only — pass exactly one hg_id or domain. IMPORTANT: with include_federal_contracts=true, company_name (exact legal entity, e.g. "Booz Allen Hamilton") is REQUIRED when the domain does not resolve to an HG record (empty organization_id) — without it federal search can return contracts_found:0; recommended otherwise. Data is from publicly announced contracts and is not comprehensive. Federal data is OFF by default — enable it for defense/government IT vendors or any suspected federal awardee (requires the datagov integration). Note: in federal records, vendor_name is the awarding agency, not a commercial vendor. Use this when a user asks: which IT vendors or GSIs a company works with; what outsourcing contracts a company has awarded; what U.S. federal awards a specific company has won. Do NOT use when: searching across many companies for federal contracts by keyword, NAICS code, or agency — use search_federal_contracts instead. Looking for prime/subcontract teaming relationships on government deals — use company_gov_relationships instead. Estimating a company's vendor spend by category — use company_spend instead. Looking for open solicitations a company might bid on (not past awards) — use company_gov_opportunities instead. Do NOT use for company size, industry, revenue, or HQ location — use company_firmographic instead.

Credits

1 — Per call. See the full credit table for how AI Credits work.

Parameters

Name	Type	Default	Description
hg_ids	array	-	HG Insights company IDs for batch contract lookup (up to 25). Each is 31-32 alphanumeric/hex chars, from a previous search_companies result. Provide hg_ids or domains (at least one is required); both may be combined. NOTE: include_federal_contracts requires exactly one company across hg_ids+domains.
domains	array	-	Company domains for batch contract lookup (e.g. ["salesforce.com", "cisco.com"], up to 25). Protocol prefixes, leading www., and trailing paths are stripped automatically; case is normalized. Provide hg_ids or domains; both may be combined. NOTE: include_federal_contracts requires exactly one company.
company_name	string	-	Legal or common name of the company (e.g., "Booz Allen Hamilton", "Palantir Technologies"). For federal lookups (include_federal_contracts=true): REQUIRED on the name-only path — i.e. when the domain does not resolve to an HG record (empty organization_id) such as many defense contractors — since providing the exact legal entity name is what enables federal data when domain resolution fails. When the company resolves in HG, company_name is recommended as a safety net (the tool otherwise derives the federal search key from the resolved record).
active_only	boolean	false	When true, returns only currently active contracts (end_date >= today or no end_date). When false (default), returns all contracts regardless of status.
vendor_name	string	-	Restrict to contracts with this counterparty vendor/GSI (e.g. "Accenture", "Microsoft"). Sent server-side as an upstream vendor-name filter, so pass the full vendor name rather than a fragment.
min_deal_value	number	-	Only return contracts whose total deal value is at least this many USD (e.g. 1000000 for $1M+). Applied client-side to the returned page.
max_deal_value	number	-	Only return contracts whose total deal value is at most this many USD. Applied client-side to the returned page.
start_date_after	string	-	Filter contracts starting after this date (ISO format YYYY-MM-DD, e.g., "2022-01-01"). Applied to the start_date field.
start_date_before	string	-	Filter contracts starting before this date (ISO format YYYY-MM-DD, e.g., "2024-12-31"). Applied to the start_date field.
end_date_before	string	-	Filter contracts ending before this date (ISO format YYYY-MM-DD, e.g., "2025-12-31").
end_date_after	string	-	Filter contracts ending after this date (ISO format YYYY-MM-DD, e.g., "2025-01-01").
limit	number	50	Maximum number of contracts to return (default: 50, max: 100).
offset	number	0	Pagination offset — skip the first N contracts (default: 0). Use when has_more:true in a result: re-call with offset = previous_offset + limit to fetch the next page. In batch calls (multiple hg_ids or domains), offset applies uniformly to all requested companies.
include_federal_contracts	boolean	false	Include U.S. federal government contract data from USAspending.gov. Requires the datagov integration (SAM.gov API key) to be configured. Always set to true for defense contractors, government IT vendors, and any company suspected of having federal awards. Pass company_name (exact legal name) alongside this flag: it is REQUIRED on the name-only path (domain does not resolve to an HG record / empty organization_id), where omitting it lets the federal search key degrade to the bare domain and can silently return 0 contracts; it is recommended as a safety net when the company resolves in HG. Federal lookup requires the domain to resolve to an HG company record (non-empty organization_id). If organization_id is empty in the response, the domain is not in the HG database and federal data cannot be fetched regardless of this flag — use search_federal_contracts with recipientName instead for those companies. Note: naics_code and psc_code in returned federal records are often empty. When enabled, response includes federal awards merged with HG contracts, SAM.gov entity data (UEI, CAGE code, business types), and federal data status metadata.

Required Integrations

This tool is only available when your organization has the following integration configured in the Phoenix Integrations settings:

• HG Insights (Data API) (hginsights_v2__data_api)

Use Cases

• Which IT vendors or GSIs (Accenture, IBM, Cognizant) does a company have outsourcing contracts with?
• What are a company's largest outsourcing deals by value? — filter with min_deal_value
• Which contracts start in a given window? — start_date_after + start_date_before
• Show only currently active contracts for an account — active_only:true
• What U.S. federal awards has a defense/government IT vendor won? — include_federal_contracts:true (adds USAspending + SAM.gov data)

Example Usage

Batch outsourcing footprint for several companies

{
  "tool": "company_contracts",
  "arguments": {
    "domains": [
      "salesforce.com",
      "cisco.com"
    ]
  }
}

Active Accenture deals over $1M

{
  "tool": "company_contracts",
  "arguments": {
    "domains": [
      "cisco.com"
    ],
    "vendor_name": "Accenture",
    "active_only": true,
    "min_deal_value": 1000000
  }
}

Include U.S. federal awards for a defense contractor

{
  "tool": "company_contracts",
  "arguments": {
    "domains": [
      "boozallen.com"
    ],
    "company_name": "Booz Allen Hamilton",
    "include_federal_contracts": true
  }
}

Response Format

Field	Type	Description
companies	array
companies[].company_domain	string	The company domain that was queried (empty string when the request was keyed by hg_id and the upstream did not return a domain — see requested_hg_id in that case)
companies[].requested_hg_id	string	Echo of the requesting hg_id, present only when this row was keyed by an hg_id and the upstream omitted the domain (so callers can key the result back without a fabricated domain)
companies[].organization_id	string	The HG Insights company identifier
companies[].contract_count	number	Number of contracts on the RETURNED PAGE (after limit + client-side filters). For the full matching total, use total_matching_contracts
companies[].total_contract_value	string | null	Total value of the contracts on the RETURNED PAGE, formatted as currency (null when unavailable). Not the grand total across all pages
companies[].total_contract_value_amount	number	Total value of the contracts on the RETURNED PAGE as a numeric amount. Not the grand total across all pages
companies[].total_matching_contracts	number	Total number of contracts matching the query server-side (upstream count), across all pages. contract_count is the page-scoped subset of this
companies[].contracts	array	List of contracts
companies[].contracts[].contract_id	string	Contract identifier (upstream id field)
companies[].contracts[].vendor_name	string	Primary vendor name (from primary_vendor.name)
companies[].contracts[].title	string	Headline summary of the deal
companies[].contracts[].summary	string	Long-form description of the deal
companies[].contracts[].deal_value	string	Deal value formatted as currency
companies[].contracts[].deal_value_amount	number	Deal value in USD
companies[].contracts[].start_date	string	Contract start date (YYYY-MM-DD)
companies[].contracts[].end_date	string	Contract end date (YYYY-MM-DD)
companies[].contracts[].announcement_date	string	Date the deal was announced (YYYY-MM-DD)
companies[].contracts[].contract_term_months	number	Contract term in months
companies[].contracts[].customer_name	string	Legal name of the customer company
companies[].contracts[].signing_country	string	Country the contract was signed in
companies[].contracts[].customer_drivers	string	Stated business driver for the contract
companies[].contracts[].contract_structure	string	e.g. "Single Vendor"
companies[].contracts[].contract_event	string	e.g. "New"
companies[].contracts[].bid_process	string	e.g. "Competitive"
companies[].contracts[].service_lines	array	Service line detail
companies[].contracts[].performance_criteria	array	Performance-criteria clauses for the contract.
companies[].contracts[].pricing_structure	string	Contract pricing-structure description.
companies[].contracts[].larger_contract	boolean	Whether this record is part of a larger contract.
companies[].contracts[].source	string	Data source (present when include_federal_contracts=true)
companies[].contracts[].federal_data	object	Federal contract details (only when source='usaspending')
companies[].contracts[].federal_data.award_id	string
companies[].contracts[].federal_data.awarding_agency	string
companies[].contracts[].federal_data.awarding_sub_agency	string
companies[].contracts[].federal_data.funding_agency	string
companies[].contracts[].federal_data.contract_type	string
companies[].contracts[].federal_data.set_aside_type	string
companies[].contracts[].federal_data.naics_code	string
companies[].contracts[].federal_data.naics_description	string
companies[].contracts[].federal_data.psc_code	string
companies[].contracts[].federal_data.psc_description	string
companies[].contracts[].federal_data.place_of_performance	object
companies[].contracts[].federal_data.place_of_performance.city	string
companies[].contracts[].federal_data.place_of_performance.state	string
companies[].contracts[].federal_data.place_of_performance.country	string
companies[].has_more	boolean	Whether there are more contracts available beyond the returned set; re-call with offset = previous_offset + limit to fetch the next page
companies[].sam_entity	object	SAM.gov entity registration data (present when include_federal_contracts=true and entity is resolved)
companies[].sam_entity.uei	string	Unique Entity Identifier
companies[].sam_entity.cage_code	string	Commercial and Government Entity code
companies[].sam_entity.legal_business_name	string
companies[].sam_entity.registration_status	string
companies[].sam_entity.business_types	array	e.g., Large Business, 8(a), HUBZone
companies[].sam_entity.naics_codes	array
companies[].sam_entity.psc_codes	array
companies[].sam_entity.sam_registration_date	string
companies[].sam_entity.sam_expiration_date	string
companies[].federal_data_status	object	Metadata about the federal data fetch (present when include_federal_contracts=true)
companies[].federal_data_status.resolved	boolean	Whether the federal data fetch completed
companies[].federal_data_status.sam_entity_found	boolean	Whether a SAM.gov entity was found
companies[].federal_data_status.contracts_found	number	Number of federal contracts found
companies[].federal_data_status.data_as_of	string	Date of data freshness
companies[].federal_data_status.errors	array	Any errors during federal data fetch

Related Tools

search_federal_contracts, company_gov_opportunities, company_gov_relationships, company_spend, company_firmographic