#for-agents

For Agents

TinyValidator is a server-side email verification tool built to be operated by agents. Connect over the remote MCP server at https://tinyvalidator.com/mcp (Streamable HTTP with OAuth — the get_pricing_for_volume tool needs no auth), or fall back to the REST API via the OpenAPI contract.

Copies a setup prompt: connect the MCP server, then verify one test email.

MCP OpenAPI LLMs.txt Docs

##Best fit

-Server-side signup checks before a user record is created

-Lead capture forms that need typo suggestions and disposable-email blocking

-CRM or ESP list cleaning with CSV upload and background processing

-Agent workflows that need a fast answer for whether an email looks safe to use

##Core actions

Connect over MCP

Point any MCP client at the remote server (Streamable HTTP with OAuth). The get_pricing_for_volume tool works without authentication, so you can quote pricing before an account exists.

https://tinyvalidator.com/mcp

Verify a single email

Use the synchronous verification endpoints when an agent needs an immediate decision for one address.

GET /api/v1/[email protected]

Run bulk validation

Create a job, upload a CSV to the presigned URL, then track status or wait for a webhook.

POST /api/v1/bulk-validations

Configure webhooks

Use webhook settings to receive completion events instead of polling long-running jobs.

POST /api/v1/webhooks

##Agent notes

-Use Authorization headers with a server-side API key whenever possible.

-Prefer the query-parameter verify endpoint for straightforward tool calling.

-Use bulk validation for lists instead of looping one-by-one through the verify endpoint.

-Treat suggestion, deliverability, disposable, catch_all, and role_account as distinct decision signals.

-Keep humans in the loop for irreversible actions or risky/catch-all addresses.

##Resources

MCP Server

Remote MCP server over Streamable HTTP with OAuth. get_pricing_for_volume needs no auth.

OpenAPI

Machine-readable API contract.

LLMs

Curated agent-readable overview.

Skill

Public TinyValidator skill for agent tool selection and workflow guidance.

Quickstart

First authenticated request.

Authentication

API key handling and security rules.

Verifying Emails

Single-email verification guide.

Bulk Validation

Create, upload, process, and download workflow.

Webhooks

Webhook configuration and signature verification.