For Agents
Validate one email address and return the full MailboxValidator signal set — syntax, MX, SMTP, free, disposable, role, and score — in a single GET.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the MailboxValidator Email Validation, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with MailboxValidator Email Validation API.
Validate the syntax of an email address against RFC rules
Confirm MX record presence and run an SMTP existence check
Flag free-provider, disposable, and role-based addresses in one response
Return a numeric MailboxValidator score for downstream send/skip logic
GET STARTED
Use for: Validate the email address user@example.com end to end, Get the MailboxValidator score for a new lead before importing it, Check whether contact@example.com has a valid MX record and SMTP response, Find role-based addresses (info@, support@) in a freshly imported list
Not supported: Does not send email, manage suppression lists, or run bulk validation — use for single-address full validation only.
Jentic publishes the only available OpenAPI document for MailboxValidator Email Validation, keeping it validated and agent-ready.
MailboxValidator Email Validation is the full single-email validation product from MailboxValidator. The /v1/validation/single endpoint returns syntax checks, free-provider and disposable flags, MX record presence, SMTP existence, role-account detection, and a numeric MailboxValidator score that summarises overall deliverability. Output is available as JSON or XML and one call covers all the validation signals the vendor exposes.
Output JSON or XML controlled by a format query parameter
Patterns agents use MailboxValidator Email Validation API for, with concrete tasks.
★ Pre-Send Email Verification
Verify each recipient address before queueing a transactional email so bounces never reach the email service provider. The single-validation endpoint returns syntax, MX, SMTP, and a deliverability score in one call, which is everything a sender needs to gate a send. Validation typically runs in under a second and integrates inline with a transactional send pipeline.
Call GET /v1/validation/single?email=jane@example.com&key={key} and proceed with the SendGrid send only if score is at least 0.7.
CRM Import Cleansing
Run every imported CRM contact through MailboxValidator to attach validation metadata to the lead record. Sales reps then see deliverability score, role-based flag, and disposable flag on the contact card before they invest time in outbound outreach. A typical hygiene pass cuts bounce-driven domain reputation damage substantially.
For each new HubSpot contact created today, call /v1/validation/single and write score, is_role, and is_disposable to custom contact properties.
Agent-Driven Lead Qualification
An AI agent that processes inbound demo requests can call MailboxValidator through Jentic to qualify the email before booking a meeting. The score and role flags drive a deterministic accept/route/reject decision, and the agent can chain the call with a calendar API to book reps on the qualified leads only.
Validate every demo-request email through /v1/validation/single, then book a Calendly slot only when score is at least 0.7 and is_role is false.
1 endpoints — mailboxvalidator email validation is the full single-email validation product from mailboxvalidator.
METHOD
PATH
DESCRIPTION
/v1/validation/single
Run a full single-email validation
/v1/validation/single
Run a full single-email validation
Three things that make agents converge on Jentic-routed access.
Credential isolation
The MailboxValidator API key is stored encrypted in the Jentic vault and appended to the key query parameter at execution time. The raw key never enters agent context or logs.
Intent-based discovery
Agents search Jentic by intent (e.g., "validate an email address") and Jentic returns the GET /v1/validation/single operation with its parameter schema for direct execution.
Time to first call
Direct integration: an hour or two to wire up the key, query parameters, and JSON parsing. Through Jentic: under 15 minutes — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
MailboxValidator Free Email Checker
Lighter free-provider-only check against the same MailboxValidator infrastructure.
Use the free checker when only the free-provider verdict is needed and credit conservation matters.
mailboxlayer
Real-time email validation with MX, SMTP, disposable, and deliverability score.
Choose mailboxlayer when bulk validation in a single request is required, or when the apilayer subscription model is more convenient.
ZeroBounce
Email validation with AI-scored deliverability and abuse detection.
Choose ZeroBounce when you need pre-built integrations with email service providers and AI-scored verdicts.
Specific to using MailboxValidator Email Validation API through Jentic.
What authentication does the Email Validation API use?
The endpoint takes an API key passed as the key query parameter alongside the email being validated. The OpenAPI spec does not declare a securityScheme component; documentation lives at https://www.mailboxvalidator.com. Through Jentic the key is stored encrypted and injected at execution time.
Can I get the MailboxValidator score in JSON?
Yes. GET /v1/validation/single returns a JSON object that includes the score field plus boolean flags such as is_disposable, is_role, is_free, mx_found, and smtp_check. Set format=xml in the query string to receive XML instead.
What are the rate limits for the Email Validation API?
MailboxValidator runs on a credit-based usage model rather than per-second throttling. The single-validation endpoint consumes credits from your subscription, and the free tier provides a monthly allowance. The spec does not declare a per-second cap.
How do I run a single validation through Jentic?
Search Jentic for "validate email mailboxvalidator" to load the GET /v1/validation/single operation, then execute with email and key parameters. Inspect score, is_disposable, and smtp_check on the returned JSON object.
Is the Email Validation API free?
MailboxValidator publishes a free tier with a monthly credit allowance for /v1/validation/single. Paid plans raise the credit cap and unlock the bulk validation product offered alongside the single-email endpoint.
Does the validation endpoint detect role-based addresses?
Yes. The response includes an is_role flag that is true for generic mailbox aliases such as info@, sales@, and support@. Combined with score and is_disposable, the role flag is useful for filtering low-intent leads from B2B campaigns.