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.

Parameters

Name	Type	Required	Default	Description
`hg_ids`	array	❌ No	-	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	❌ No	-	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	❌ No	-	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	❌ No	`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	❌ No	-	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	❌ No	-	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	❌ No	-	Only return contracts whose total deal value is at most this many USD. Applied client-side to the returned page.
`start_date_after`	string	❌ No	-	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	❌ No	-	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	❌ No	-	Filter contracts ending before this date (ISO format YYYY-MM-DD, e.g., "2025-12-31").
`end_date_after`	string	❌ No	-	Filter contracts ending after this date (ISO format YYYY-MM-DD, e.g., "2025-01-01").
`limit`	number	❌ No	`50`	Maximum number of contracts to return (default: 50, max: 100).
`offset`	number	❌ No	`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	❌ No	`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

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
  }
}

search_federal_contracts, company_gov_opportunities, company_gov_relationships, company_spend, company_firmographic

Parameters​

Required Integrations​

Use Cases​

Example Usage​

Related Tools​

Parameters

Required Integrations

Use Cases

Example Usage

Related Tools