FoFa MCP Server

What is FoFa MCP Server?

A Model Context Protocol server that provides access to the FoFa API, enabling AI assistants to query information about internet-connected devices and services. It is designed for developers and security researchers who need to search FoFa’s database programmatically.

How to use FoFa MCP Server?

Clone the repository, install dependencies with npm install, build with npm run build, and set the environment variables FOFA_API_KEY and FOFA_EMAIL. Start the server with npm start. For integration with Claude Desktop, add the server configuration to MCP settings, including the path to the built index.js and the required environment variables.

Key features of FoFa MCP Server

• Search FoFa’s database for devices and services using custom queries.
• Retrieve user information including account details and usage statistics.
• Supports pagination with configurable page number and result size.
• Allows specifying which fields to include in search results.
• Compatible with MCP‑enabled AI assistants like Claude.

Use cases of FoFa MCP Server

• Querying FoFa for devices running a specific application (e.g., Apache HTTP Server).
• Gathering details about a set of IPs, ports, and service banners.
• Checking a user’s FoFa account balance and API usage limits.
• Automating reconnaissance or asset inventory tasks via an AI assistant.