Metadata-Version: 2.4
Name: evaboot-mcp
Version: 0.1.0
Summary: MCP server for the Evaboot API — find emails, validate emails, and extract LinkedIn Sales Navigator data.
License-Expression: MIT
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp[cli]>=1.2.0
Description-Content-Type: text/markdown

# evaboot-mcp

MCP server for the [Evaboot](https://evaboot.com) API — find professional emails, validate emails, and extract LinkedIn Sales Navigator data from any MCP-compatible client.

## Quick start

### Claude Desktop / Claude Code

Add to your MCP config:

```json
{
  "mcpServers": {
    "evaboot": {
      "command": "uvx",
      "args": ["evaboot-mcp"],
      "env": {
        "EVABOOT_API_KEY": "your-api-token"
      }
    }
  }
}
```

Get your API token at [app.evaboot.com](https://app.evaboot.com/?page=api&int=api).

## Available tools

### Search Builder
- **generate_search_url** — Describe the leads or companies you want and get a Sales Navigator search URL.

### Account
- **check_quota** — Check credits, daily limits, and linked Sales Navigator accounts.

### Email Finder
- **find_email** — Find a professional email for one person (sync, 1 credit).
- **find_emails_bulk** — Start a bulk email-finder job (async, 1 credit/prospect).
- **list_email_finder_jobs** — List completed email-finder jobs.
- **get_email_finder_job** — Get results of an email-finder job by ID.

### Email Validation
- **validate_email** — Validate a single email address (sync, 0.5 credits).
- **validate_emails_bulk** — Start a bulk validation job (async, 0.5 credits/email).
- **list_email_validation_jobs** — List completed validation jobs.
- **get_email_validation_job** — Get results of a validation job by ID.

### LinkedIn Extraction
- **extract_from_url** — Start extraction from a Sales Navigator search/list URL (async).
- **extract_profiles** — Start extraction for specific profile URLs/IDs (async).
- **extract_single_profile** — Extract a single profile (sync).
- **list_extractions** — List completed extractions.
- **get_extraction** — Get extraction results by ID.

## Development

```bash
cd evaboot-mcp
uv sync
EVABOOT_API_KEY=your-token uv run evaboot-mcp
```

## Publishing

```bash
uv build
uv publish
```
