Tool Specifications

AI Agent Tool Schemas

JSON schemas and parameters for tools exposed by the BounceLayer MCP server to autonomous LLM agents.

Available Tools

1. verify_email

Real-time single email verification with 7-layer validation.

json
{
  "name": "verify_email",
  "description": "Verify a single recipient email address with direct RFC 5321 SMTP probing.",
  "parameters": {
    "type": "object",
    "properties": {
      "email": {
        "type": "string",
        "description": "The email address to verify"
      }
    },
    "required": ["email"]
  }
}

2. clean_email_list

Queue a background bulk verification job for prospect lists.

json
{
  "name": "clean_email_list",
  "description": "Submit a bulk list of emails for concurrent verification.",
  "parameters": {
    "type": "object",
    "properties": {
      "emails": {
        "type": "array",
        "items": { "type": "string" },
        "description": "Array of up to 10,000 email addresses"
      },
      "webhook_url": {
        "type": "string",
        "description": "Optional HTTP callback URL"
      }
    },
    "required": ["emails"]
  }
}

3. get_bulk_job

Check progress and download results for an asynchronous bulk job.

json
{
  "name": "get_bulk_job",
  "description": "Retrieve bulk verification status and download link.",
  "parameters": {
    "type": "object",
    "properties": {
      "job_id": { "type": "string", "description": "Unique UUID of the bulk job" }
    },
    "required": ["job_id"]
  }
}

4. get_credit_balance

Inspect active account credit pool and billing renewal date.

json
{
  "name": "get_credit_balance",
  "description": "Check available verification credits.",
  "parameters": { "type": "object", "properties": {} }
}