highergov-mcp

MCP server for the HigherGov API — federal contract and grant intelligence for sales research, company enrichment, and relationship mapping.

Prerequisites

• Node.js 18+
• A HigherGov API key (request access)

Quick Start (npx)

No installation required:

HIGHERGOV_API_KEY=your-key npx highergov-mcp

Claude Desktop Configuration

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "highergov": {
      "command": "npx",
      "args": ["highergov-mcp"],
      "env": {
        "HIGHERGOV_API_KEY": "your-key-here"
      }
    }
  }
}

Claude Code Configuration

Add to your Claude Code config (~/.claude.json):

{
  "mcpServers": {
    "highergov": {
      "command": "npx",
      "args": ["highergov-mcp"],
      "env": {
        "HIGHERGOV_API_KEY": "your-key-here"
      },
      "type": "stdio"
    }
  }
}

Remote Server (VPS Deployment)

Run as an HTTP server for use as a Claude web/desktop connector:

HIGHERGOV_API_KEY=your-key npx highergov-mcp --transport http

The server starts on port 3000 by default (override with PORT env var). Connect Claude Desktop to http://your-vps:3000/mcp.

Available Tools

Company Intelligence

| Tool | Description | |------|-------------| | search_awardees | Search companies by UEI, CAGE code, NAICS, or parent company | | get_awardee_profile | Detailed company profile with registration, certifications, business types | | get_awardee_partnerships | Prime/sub teaming history with award counts and values | | get_awardee_mentor_protege | Formal mentor-protege relationships |

Award Intelligence

| Tool | Description | |------|-------------| | search_contracts | Search prime contract awards by awardee, agency, NAICS/PSC, vehicle, date | | search_idvs | Search IDIQs, GWACs, BPAs — indefinite delivery vehicles | | search_subcontracts | Search subcontract awards — map supply chains |

Opportunity Intelligence

| Tool | Description | |------|-------------| | search_opportunities | Active solicitations from SAM.gov, DIBBS, SBIR, grants, SLED | | get_opportunity_documents | Retrieve RFPs, SOWs, amendments attached to opportunities |

People & Vehicles

| Tool | Description | |------|-------------| | search_people | Government contacts (contracting officers, program managers) | | search_vehicles | Federal contract vehicles with ceiling, scope, ordering dates |

Reference

| Tool | Description | |------|-------------| | search_agencies | Federal agency hierarchy (7 levels deep, defense_flag filter) | | lookup_naics | NAICS industry code lookup | | lookup_psc | PSC product/service code lookup |

Example Workflows

Find CMMC prospects:

1. search_agencies -- find DoD sub-agencies
2. search_contracts -- filter by agency + cybersecurity NAICS/PSC codes
3. get_awardee_profile -- research the winning company
4. get_awardee_partnerships -- map their teaming relationships

Research a company:

1. search_awardees -- find by name/UEI/CAGE
2. search_contracts -- see their award history
3. get_awardee_partnerships -- see who they team with
4. search_subcontracts -- see their subcontracting activity

Explore an IDV:

1. search_idvs -- find the vehicle
2. search_contracts with parent_award_id -- find task orders
3. get_awardee_profile -- research each awardee

Development

git clone https://github.com/boejucci/highergov-mcp.git
cd highergov-mcp
npm install
cp .env.example .env  # add your API key
npm run dev            # stdio mode
npm run dev:http       # HTTP mode on port 3000
npm run build          # production build

API Reference

• HigherGov API Docs
• HigherGov API GitHub
• MCP TypeScript SDK

Rate Limits

HigherGov allows 10 requests/second and 100,000 requests/day. The MCP server enforces client-side rate limiting automatically.