# DeBounce — how to use (mcp.ai)

Connect your DeBounce account and use 4 tools for email straight from your AI agent. Connect with your own API key. DeBounce validates email addresses, enriches contact data, reports account usage, and processes bulk email-validation lists.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_debounce?ms=1787293380000`
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. `debounce_get_account_balance`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/debounce`
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/debounce/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/debounce/get/account/balance` — Return the connected DeBounce account's remaining validation-credit balance.
- `POST https://api.mcp.ai/api/debounce/get/api/usage` — Return the aggregate number of DeBounce API validation calls in an inclusive date range.
  - body: { end_date: string, start_date: string }
- `POST https://api.mcp.ai/api/debounce/get/bulk/validation/status` — Check progress for a bulk validation list created through the DeBounce Bulk API and return its result download URL when available.
  - body: { list_id: string }
- `POST https://api.mcp.ai/api/debounce/validate/email` — Validate one email address with DeBounce and return its deliverability result, reason, and remaining credit balance. Basic validation consumes 1 credit. Profile-photo lookup can cost 1 additional cred
  - body: { email: string, include_photo?: boolean, detect_gsuite_accept_all?: boolean, include_contact_enrichment?: boolean }

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

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