Uncover MCP

What is Uncover MCP?

Uncover MCP is a Model Context Protocol (MCP) service implementation based on the projectdiscovery/uncover tool. It is designed for quickly discovering exposed hosts on the internet, integrating directly with the uncover library and supporting multiple search engines (Shodan and FOFA).

How to use Uncover MCP?

Clone the repository, build the project with go build -o uncover-mcp ./cmd/uncover-mcp, then run it as an MCP service by configuring the binary path and environment variables (SHODAN_API_KEY, FOFA_EMAIL, FOFA_KEY) in your MCP client configuration.

Key features of Uncover MCP

• Direct integration with projectdiscovery/uncover library for searching
• Support for multiple search engines (Shodan and FOFA)
• Multiple output format options
• Simple and easy-to-use MCP service interface
• Natural interaction with AI assistants

Use cases of Uncover MCP

• Security researchers quickly discovering exposed hosts on the internet
• AI-assisted exploration of attack surface via natural language queries
• Automated host discovery integrated into MCP‑enabled workflows

FAQ from Uncover MCP

What is the purpose of Uncover MCP?

It provides an MCP interface for the uncover tool, enabling AI assistants and other MCP clients to discover exposed hosts using search engines like Shodan and FOFA.

Which search engines are supported?

Currently Shodan and FOFA are supported.

How do I configure API keys?

Set the environment variables SHODAN_API_KEY, FOFA_EMAIL, and FOFA_KEY in the MCP server configuration.

Is this tool legal?

The README states: "This tool is intended for security research purposes only. Use this tool in compliance with relevant laws and regulations and the terms of use of the uncover project."

What dependencies are required?

You need Go to build the binary, plus valid API keys for the search engines you intend to use (Shodan and/or FOFA).