MCP Subfinder Server
by copyleftdev
MCP Subfinder Server is a Model Context Protocol (MCP) server that wraps ProjectDiscovery's subfinder tool, providing a JSON-RPC API for powerful subdomain enumeration. It leverages subfinder for subdomain discovery and offers a convenient way to integrate it into other systems.
Last updated: N/A
What is MCP Subfinder Server?
MCP Subfinder Server is a wrapper around ProjectDiscovery's subfinder tool, exposing its functionality through a JSON-RPC API. It allows users to enumerate subdomains for a given domain programmatically.
How to use MCP Subfinder Server?
First, clone the repository and build the server using make build. Then, run the server using make run. Interact with the server using the JSON-RPC API at http://localhost:8080/mcp, sending POST requests with the appropriate JSON payloads as shown in the API Usage examples. Configure API keys in provider-config.yaml for optimal results.
Key features of MCP Subfinder Server
JSON-RPC API for subdomain enumeration
Recursive subdomain discovery
Source filtering capabilities
Configurable timeouts and threading
Use cases of MCP Subfinder Server
Automated subdomain discovery for penetration testing
Integration with security monitoring tools
Asset discovery for vulnerability management
Building custom subdomain enumeration workflows
FAQ from MCP Subfinder Server
What is the default port for the server?
What is the default port for the server?
The default port is 8080.
How do I specify a custom provider config file?
How do I specify a custom provider config file?
Use the PROVIDER_CONFIG environment variable: PROVIDER_CONFIG=my-custom-config.yaml make run
How can I run the server in Docker?
How can I run the server in Docker?
Use the make docker and make docker-run commands.
How do I filter the sources used for subdomain enumeration?
How do I filter the sources used for subdomain enumeration?
Use the sourcesFilter or excludeSourcesFilter options in the enumerateSubdomains API call.
Where can I find examples of API usage?
Where can I find examples of API usage?
The README provides several examples using curl to interact with the JSON-RPC API.