# NeverBounce MCP Server

This is a Model Context Protocol (MCP) server that integrates with the NeverBounce API to provide email validation capabilities.

## Features

- Validate email addresses to check if they are valid, deliverable, and safe to send to

## Setup

### Local Setup

1. Clone this repository
2. Install dependencies:
   ```
   npm install
   ```
3. Create a `.env` file based on `.env.example` and add your NeverBounce API key:
   ```
   NEVERBOUNCE_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 NeverBounce 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": {
    "neverbounce": {
      "command": "node",
      "args": ["path/to/neverbounce/dist/index.js"],
      "env": {
        "NEVERBOUNCE_API_KEY": "your_api_key_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

## Available Tools

- `neverbounce_validate_email`: Validate an email address to check if it's valid and deliverable

## License

ISC