Install Jentic One Beta

Connect the MailboxValidator Email Validation to your agent

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.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fmailboxvalidator.com%2Fmailboxvalidator-validation" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fmailboxvalidator.com%2Fmailboxvalidator-validation" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic 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.

Capabilities

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

Start building with MailboxValidator Email Validation API

Explore with Jentic One

View OpenAPI Document

Use Cases

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.

Key Endpoints

1 endpoints — mailboxvalidator email validation is the full single-email validation product from mailboxvalidator.

METHOD

PATH

DESCRIPTION

GET

/v1/validation/single

Run a full single-email validation

GET

/v1/validation/single

Run a full single-email validation

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring MailboxValidator Email Validation by hand means attaching your API key to each request, targeting the api.mailboxvalidator.com host, and parsing the full validation result yourself. Through Jentic you install once, import the validation API from the API Directory, store the key once, and your agent calls it.

Permission scoping

This API offers a single-address full validation with the address carried in the request, so limit the agent to the operation it needs, the single validation call, and nothing more. Which operations run is your choice.

Credential isolation

Your MailboxValidator API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'fully validate an email address', and Jentic returns the matching MailboxValidator operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

FAQs

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.

Can I limit what my agent is allowed to do with the MailboxValidator Email Validation API?

Yes. Because you run Jentic One yourself, your own rules decide which operations and credentials the agent may use. This API exposes a single operation, the GET /v1/validation/single call, so you can scope the agent to that one validation endpoint and nothing else. Your stored API key is injected only at execution time for the calls you have allowed, keeping the agent limited to full single-address validation.

MailboxValidator Email Validation

Name: MailboxValidator Email Validation API
Brand: MailboxValidator Email Validation
Availability: InStock

Browse all Mailboxvalidator APIs

Community OpenAPI document · agent-readyData EnrichmentContact EnrichmentapiKey1 EndpointsREST

Know of an official OpenAPI document? Contribute it →

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.

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.

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.

Jentic One on Github View OpenAPI Document