README.md•1.38 kB
# Hunter.io MCP Server
This is a Model Context Protocol (MCP) server that integrates with the Hunter.io API to provide email finding and verification capabilities.
## Features
- Find email addresses using domain and name information
- Verify email addresses for deliverability and validity
## Setup
### Local Setup
1. Clone this repository
2. Install dependencies:
```
npm install
```
3. Create a `.env` file based on `.env.example` and add your Hunter.io API key:
```
HUNTER_API_KEY=your_api_key_here
```
4. Build the server:
```
npm run build
```
5. Start the server:
```
npm start
```
### Docker Setup
1. Clone this repository
2. Create a `.env` file with your Hunter.io API key
3. Build and run using Docker Compose:
```
docker-compose up -d
```
## MCP Configuration
To use this server with an MCP client, add the following configuration to your MCP settings file:
```json
{
"mcpServers": {
"hunter.io": {
"command": "node",
"args": ["path/to/hunter.io/dist/index.js"],
"env": {
"HUNTER_API_KEY": "your_api_key_here"
},
"disabled": false,
"autoApprove": []
}
}
}
```
## Available Tools
- `hunter_find_email`: Find an email address using domain and name information
- `hunter_verify_email`: Verify if an email address is valid and deliverable
## License
ISC