mogga1991/mcp-intelligence-server

MCP Intelligence Server

Advanced government contracting intelligence powered by Sam.gov and Perplexity AI

A comprehensive Model Context Protocol (MCP) server that combines real-time government contracting data from Sam.gov with AI-powered analysis from Perplexity. Built for intelligence professionals, business developers, and government contractors.

🚀 Features

Sam.gov Integration

• Search Government Opportunities - Find federal contracting opportunities with advanced filtering
• Opportunity Details - Get comprehensive opportunity information including contacts and requirements
• Entity Search - Find registered government contractors and vendors
• Entity Details - Access detailed company registration and compliance information

Perplexity AI Intelligence

• Advanced Research - Conduct comprehensive research with real-time web citations
• Opportunity Analysis - AI-powered analysis of government contracting opportunities
• Entity Investigation - Deep intelligence gathering on companies and competitors
• Market Trend Analysis - Industry analysis with government spending insights

Technical Features

• ⚡ Rate Limited APIs - Automatic throttling for both Sam.gov and Perplexity
• 🛡️ Type Safety - Full TypeScript with Zod schema validation
• 🔧 Error Handling - Comprehensive error management and logging
• 📊 Rich Responses - Formatted output with citations and metadata
• 🌐 MCP Compatible - Works with any MCP-compatible client

🛠️ Installation

Prerequisites

• Node.js 18+
• Sam.gov API key (Get one here)
• Perplexity API key (Get one here)

Quick Setup

1. Clone and install:

   git clone https://github.com/mogga1991/mcp-intelligence-server.git
   cd mcp-intelligence-server
   npm install
   

2. Configure environment:

   cp .env.example .env
   # Edit .env with your API keys
   

3. Build and test:

   npm run build
   npm run inspector
   

📋 Available Tools

Sam.gov Tools

search_government_opportunities

Find government contracting opportunities with advanced filtering options.

Parameters:

• keyword - Search terms for opportunities
• postedFrom/postedTo - Date range filters
• type - Opportunity type (Solicitation, Award Notice, etc.)
• state - State abbreviation filter
• naicsCode - NAICS industry code
• typeOfSetAside - Set-aside preferences (8A, WOSB, etc.)
• limit/offset - Pagination controls

get_opportunity_details

Get comprehensive details about a specific opportunity.

Parameters:

• noticeId - The opportunity notice ID

search_government_entities

Find registered government contractors and vendors.

Parameters:

• keyword - Search terms
• samRegistered - Registration status filter
• ueiSAM - Unique Entity Identifier
• cageCode - CAGE code
• legalBusinessName - Company name
• stateOrProvince - Location filter

get_entity_details

Get detailed entity registration information.

Parameters:

• ueiSAM - Unique Entity Identifier

Perplexity AI Tools

research_query

Conduct advanced research with real-time web data and citations.

Parameters:

• query - Research question
• model - AI model selection (small/large/huge)
• searchDomains - Specific domains to search
• searchRecency - Time filter for sources
• maxTokens - Response length control

analyze_opportunities

AI-powered analysis of government opportunities with strategic insights.

Parameters:

• opportunities - Array of opportunity objects
• analysisContext - Additional business context
• focusArea - Analysis focus (competitive, trends, etc.)

investigate_entity

Comprehensive intelligence gathering on companies and entities.

Parameters:

• entityName - Company or entity name
• context - Investigation context
• focusArea - Investigation focus area

analyze_market_trends

Industry and market analysis with government contracting insights.

Parameters:

• industry - Industry or sector to analyze
• timeframe - Analysis time period
• focusArea - Analysis focus area
• includeGovernmentData - Include federal data

🏃‍♂️ Usage Examples

Basic Opportunity Search

{
  "tool": "search_government_opportunities",
  "arguments": {
    "keyword": "cybersecurity",
    "state": "VA",
    "limit": 10
  }
}

Market Intelligence Research

{
  "tool": "research_query",
  "arguments": {
    "query": "Federal cybersecurity spending trends 2024",
    "model": "llama-3.1-sonar-large-128k-online",
    "searchRecency": "month"
  }
}

Company Investigation

{
  "tool": "investigate_entity",
  "arguments": {
    "entityName": "Palantir Technologies",
    "focusArea": "contracting-history"
  }
}

📜 Scripts

npm run dev        # Development with hot reload
npm run build      # Build for production  
npm run start      # Start production server
npm run inspector  # Test with MCP Inspector
npm run clean      # Clean build artifacts

⚙️ Configuration

Environment Variables

See .env.example for complete configuration options.

MCP Client Integration

Add to your MCP client configuration:

{
  "mcpServers": {
    "intelligence": {
      "command": "node",
      "args": ["/path/to/mcp-intelligence-server/dist/index.js"]
    }
  }
}

🧪 Development

Project Structure

src/
├── clients/           # API client implementations
│   ├── samgov-client.ts
│   └── perplexity-client.ts
├── config/            # Configuration management
│   └── environment.ts
├── tools/             # MCP tool implementations
│   ├── samgov-tools.ts
│   └── perplexity-tools.ts
└── index.ts          # Main server entry point

Adding New Tools

1. Create tool implementation in src/tools/
2. Register in src/index.ts
3. Add to tool handlers
4. Update documentation

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes with tests
4. Submit a pull request

📄 License

MIT License - see file for details.

🔗 Links

• Sam.gov API Documentation
• Perplexity API Documentation
• Model Context Protocol
• Issues & Support

⚠️ Disclaimer

This tool is for legitimate intelligence and business development purposes only. Users are responsible for complying with all applicable laws and API terms of service.

Built with ❤️ using TypeScript, Sam.gov API, and Perplexity AI