# Kickbox — how to use (mcp.ai)

Connect your Kickbox account and use 2 tools for email straight from your AI agent. Connect with your own API key. Kickbox provides an API for real-time email verification, list cleaning, and quality scoring to ensure email deliverability.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_kickbox?ms=1787295780000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `kickbox_check_disposable`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/kickbox`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/kickbox/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/kickbox/check/disposable` — Tool to check if an email address or domain is from a disposable email service. Use when you need to validate whether an email is temporary or throwaway (e.g., mailinator.com, trashmail.com). This is 
  - body: { domain_or_email: string }
- `POST https://api.mcp.ai/api/kickbox/single/verification/api` — Tool to verify a single email address via Kickbox. Use when you need real-time validation of an individual email before critical workflows.
  - body: { email: string, timeout?: integer, webhook?: string, disable_catch_all?: boolean, timeout_parameter?: string }

## Example prompts
- "What can I do in Kickbox?"
- "Show me a summary of my Kickbox account"

## More
- Page: https://mcp.ai/kickbox
- Agent spec (llms.txt): https://mcp.ai/kickbox/llms.txt
- Postman collection: https://mcp.ai/kickbox/postman.json