# Highergov — how to use (mcp.ai)

Connect your Highergov account and use 16 tools for business intelligence straight from your AI agent. Connect with your own API key. HigherGov is a market intelligence platform providing comprehensive data on U.S. federal, state, and local government contracts and grants.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_highergov?ms=1787295780000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `highergov_get_agencies`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/highergov`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/highergov/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/highergov/get/agencies` — Retrieves government agency information from the HigherGov database with pagination support. Use this tool to: - List all federal agencies with details like name, abbreviation, type, and hierarchy - S
  - body: { page?: integer, page_size?: integer, agency_key?: integer }
- `POST https://api.mcp.ai/api/highergov/get/contract/vehicles` — Retrieve federal multi-award contract vehicles from HigherGov. Contract vehicles are pre-established contracting mechanisms that streamline procurement. Use this to list available vehicles with option
  - body: { ordering?: string, page_size?: string, page_number?: integer, vehicle_key?: integer }
- `POST https://api.mcp.ai/api/highergov/get/contracts` — Retrieve federal government contract data from HigherGov. Returns paginated list of contracts with details including awardees, agencies, amounts, dates, NAICS/PSC codes, and performance information. S
  - body: { award_id?: string, psc_code?: string, page_size?: integer, search_id?: string, naics_code?: string, awardee_key?: integer, page_number?: integer, last_modified_date?: string, awarding_agency_key?: integer }
- `POST https://api.mcp.ai/api/highergov/get/documents` — Retrieve document metadata and download URLs for files associated with government opportunities, contracts, and grants from HigherGov. **When to use:** After calling Get Opportunities, Get Contracts, 
  - body: { page?: integer, grant_id?: integer, ordering?: string, page_size?: integer, contract_id?: integer, document_id?: integer, related_key: string, opportunity_id?: integer }
- `POST https://api.mcp.ai/api/highergov/get/grant/history` — Tool to fetch historical data on grants from the HigherGov API. REQUIRED: At least one filter parameter (award_id or last_modified_date) must be provided. Use cases: - Retrieve history for a specific 
  - body: { page?: integer, award_id?: string, page_size?: integer, last_modified_date?: string }
- `POST https://api.mcp.ai/api/highergov/get/grant/opportunities` — Retrieve government grant and contract opportunities from HigherGov. Returns Federal contracts, SLED (State/Local) opportunities, grants, and SBIR opportunities with comprehensive details including ag
  - body: { page?: integer, status?: string, keyword?: string, opp_key?: integer, agency_id?: integer, page_size?: integer, search_id?: string, source_id?: integer, agency_key?: integer, posted_date?: string, version_key?: integer, captured_date?: string }
- `POST https://api.mcp.ai/api/highergov/get/grant/programs` — Tool to retrieve information on grant programs. Use when you need to list available grant programs with pagination.
  - body: { page?: integer, page_size?: integer }
- `POST https://api.mcp.ai/api/highergov/get/naics` — Retrieve NAICS (North American Industry Classification System) codes with detailed descriptions. Returns a paginated list of NAICS codes that can be filtered by code prefix and sorted. Useful for find
  - body: { ordering?: string, page_size?: integer, naics_code?: string, page_number?: integer }
- `POST https://api.mcp.ai/api/highergov/get/opportunity/history` — Retrieve historical opportunity data from HigherGov with pagination support. This tool requires at least one identifying filter (captured_date, opp_key, version_key, search_id, posted_date, source_id,
  - body: { page?: integer, opp_key?: string, page_size?: integer, search_id?: string, source_id?: string, agency_key?: integer, posted_date?: string, source_type?: string, version_key?: string, captured_date?: string }
- `POST https://api.mcp.ai/api/highergov/get/people` — Retrieves contact information for federal and state/local government personnel from HigherGov. Returns detailed contact records including names, titles, emails, phone numbers, and affiliated agencies.
  - body: { page?: integer, ordering?: string, page_size?: integer, contact_email?: string }
- `POST https://api.mcp.ai/api/highergov/get/psc` — Tool to retrieve information on Product and Service Codes. Use when fetching PSC entries with optional pagination and filtering by code.
  - body: { psc_code?: string, page_size?: integer, page_number?: integer }
- `POST https://api.mcp.ai/api/highergov/get/pursuits` — Tool to retrieve user-specific pursuits. Use when you need to fetch a user's pursuits with optional filtering by status and pagination.
  - body: { page?: integer, status?: string, opp_key?: integer, user_id?: string, page_size?: integer, search_id?: string, source_id?: string, agency_key?: integer, posted_date?: string, source_type?: string, version_key?: integer, captured_date?: string }
- `POST https://api.mcp.ai/api/highergov/get/sbir/opportunities` — Retrieve SBIR (Small Business Innovation Research) opportunities from HigherGov. SBIR is a U.S. government program that provides funding to small businesses for research and development with commercia
  - body: { opp_key?: string, ordering?: string, page_size?: string, search_id?: string, source_id?: string, agency_key?: integer, page_number?: integer, posted_date?: string, version_key?: string, captured_date?: string }
- `POST https://api.mcp.ai/api/highergov/get/sled/contract/opportunities` — Tool to retrieve state and local (SLED) contract opportunities. Uses the general Opportunity endpoint with optional filters.
  - body: { opp_key?: string, ordering?: string, page_size?: string, search_id?: string, source_id?: string, agency_key?: integer, page_number?: integer, posted_date?: string, source_type?: string, version_key?: string, captured_date?: string }
- `POST https://api.mcp.ai/api/highergov/get/subcontract/awards` — Retrieves federal subcontract award data from HigherGov. Returns paginated subcontract records with details about subcontract recipients, amounts, prime contracts, and awarding agencies. **Important**
  - body: { page?: integer, page_size?: integer, search_id?: string, last_modified_date?: string }
- `POST https://api.mcp.ai/api/highergov/get/subgrant/awards` — Retrieves federal subgrant award data from HigherGov. Returns paginated subgrant records with details about subgrant recipients, funding amounts, associated prime grants, and program information. **Im
  - body: { page?: integer, state?: string, award_id?: string, page_size?: integer, search_id?: string, fiscal_year?: integer, subgrant_id?: integer, recipient_name?: string, subgrant_number?: string, last_modified_date?: string, cfda_program_number?: string }

## Example prompts
- "What can I do in Highergov?"
- "Show me a summary of my Highergov account"

## More
- Page: https://mcp.ai/highergov
- Agent spec (llms.txt): https://mcp.ai/highergov/llms.txt
- Postman collection: https://mcp.ai/highergov/postman.json
