Skip to main content

Integration Guide

Learn how to integrate FullHunt Agentic AI with your AI assistant using the Model Context Protocol (MCP).

Prerequisites​

Before you begin, ensure you have:

  1. FullHunt API Key - Get yours from FullHunt Profile Settings
  2. Professional or Enterprise Account - Sign up here if you don't have one
  3. MCP-Compatible AI Client - Such as Claude Desktop, Cursor IDE, or custom MCP client

Hosted Endpoints​

FullHunt Agentic AI is available via hosted MCP endpoints. No server setup required!

Public API Endpoint​

For Professional and standard accounts:

https://fullhunt.io/api/v1/mcp

Enterprise API Endpoint​

For Enterprise customers with dedicated infrastructure:

https://enterprise-api.fullhunt.io/api/v1/mcp

Quick Start: Claude Desktop​

The fastest way to get started is with Claude Desktop.

Step 1: Install Claude Desktop​

Download Claude Desktop from claude.ai/download

Step 2: Configure MCP Server​

Add FullHunt to your Claude Desktop configuration:

macOS/Linux: ~/.config/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "fullhunt": {
      "transport": "http",
      "url": "https://fullhunt.io/api/v1/mcp",
      "headers": {
        "X-API-KEY": "your-api-key-here"
      }
    }
  }
}
Environment Variables

You can use environment variables for your API key:

{
  "mcpServers": {
    "fullhunt": {
      "transport": "http",
      "url": "https://fullhunt.io/api/v1/mcp",
      "headers": {
        "X-API-KEY": "${env:FULLHUNT_API_KEY}"
      }
    }
  }
}

Step 3: Restart Claude Desktop​

Close and reopen Claude Desktop to load the configuration.

Step 4: Verify Connection​

In Claude Desktop, try a simple query:

"What's my current IP address?"

If configured correctly, Claude will use the get_my_ip tool from FullHunt.

Enterprise Configuration​

Enterprise customers get dedicated MCP endpoints with enhanced features and isolated infrastructure.

{
  "mcpServers": {
    "fullhunt-enterprise": {
      "transport": "http",
      "url": "https://enterprise-api.fullhunt.io/api/v1/mcp",
      "headers": {
        "X-API-KEY": "your-enterprise-api-key"
      }
    }
  }
}

Enterprise features include:

  • Dedicated infrastructure
  • Organization-wide asset management
  • Custom entity monitoring
  • Real-time alerting
  • Dark web monitoring
  • Priority support

Cursor IDE Integration​

Cursor IDE supports MCP for code-aware security analysis.

Configuration​

Add to your Cursor settings:

macOS/Linux: ~/.cursor/config.json
Windows: %APPDATA%\Cursor\config.json

{
  "mcpServers": {
    "fullhunt": {
      "transport": "http",
      "url": "https://fullhunt.io/api/v1/mcp",
      "headers": {
        "X-API-KEY": "${env:FULLHUNT_API_KEY}"
      }
    }
  }
}

Custom MCP Clients​

You can integrate FullHunt Agentic AI with any MCP-compatible client.

HTTP Transport Configuration​

{
  "server": {
    "name": "fullhunt",
    "transport": "http",
    "url": "https://fullhunt.io/api/v1/mcp",
    "headers": {
      "X-API-KEY": "your-api-key-here",
      "Content-Type": "application/json"
    }
  }
}

Authentication​

All requests require authentication via the X-API-KEY header:

X-API-KEY: your-api-key-here

Example Usage​

Once configured, you can interact with FullHunt using natural language:

Basic Queries​

"Get domain details for example.com"
"Find subdomains of example.com"
"Look up host information for api.example.com"

Complex Investigations​

"Investigate the attack surface of acme.com and identify any exposed admin panels"
"Find all vulnerabilities for the product Apache HTTP Server"
"Check if IP 1.2.3.4 is a Tor exit node"

Multi-Step Analysis​

"Analyze security.example.com:
1. Get all subdomains
2. Check for exposed admin panels
3. Find any known vulnerabilities
4. Check dark web for compromised credentials"

Enterprise Queries​

"Show me all security alerts for my organization"
"List all assets for entity 'Production Environment'"
"Find compromised credentials for @mycompany.com"

Troubleshooting​

Connection Issues​

Problem: "Failed to connect to MCP server"

Solutions:

  • Verify your API key is correct
  • Check your internet connection
  • Ensure the endpoint URL is correct
  • Verify your account has MCP access

Authentication Errors​

Problem: "Authentication failed" or "Invalid API key"

Solutions:

  • Regenerate your API key from Profile Settings
  • Check for extra spaces in your API key
  • Verify environment variable is set correctly

Tool Not Available​

Problem: "Tool not found" or "Access denied"

Solutions:

  • Verify your account tier supports the tool
  • Enterprise-only tools require an Enterprise account
  • Check Tools Reference for availability

Security Best Practices​

API Key Management​

  • Never commit API keys to version control
  • Use environment variables for storing keys
  • Rotate keys regularly
  • Use different keys for different environments

Access Control​

  • Limit API key scope when possible
  • Use read-only keys for analysis-only tasks
  • Monitor API usage regularly
  • Revoke unused keys immediately

Support​

Need help with integration?

Next Steps​

Ready to start securing with AI? Try these prompts in Claude Desktop to get started!