Connect Bouncer to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the batch verify emails tool in Bouncer
Use the verify email tool in Bouncer
Use the verify domain tool in Bouncer
Use the check email toxicity tool in Bouncer
Use the get toxicity status tool in Bouncer
Use the get toxicity results tool in Bouncer
Supported Tools
batch_verify_emails
Batch Verify Emails
Verify multiple email addresses synchronously in a single request. Submits emails to a batch processing queue and returns results when verification is complete. Ideal for verifying small to medium lists where you need immediate results.
verify_email
Verify Email
Verify a single email address in real-time. Checks syntax, domain validity, and contacts SMTP servers to determine deliverability. Returns detailed information including deliverability status, domain characteristics (disposable, free, accept-all), account details, DNS records, email provider, deliverability score, and toxicity flag.
verify_domain
Verify Domain
Verify whether a domain has valid MX records and check its characteristics. Returns information about whether the domain accepts all emails (catch-all), is disposable, is a free email provider, and its DNS records.
check_toxicity
Check Email Toxicity
Create a toxicity check job for a list of email addresses. Identifies toxic emails such as widely circulated or breached addresses, complainers, litigators, and potential spam traps. Returns a job ID to track progress and download results.
get_toxicity_status
Get Toxicity Status
Check the status of a toxicity check job. Use this to determine whether the job has completed processing and results are ready for download.
get_toxicity_results
Get Toxicity Results
Download the results of a completed toxicity check job. Returns toxicity scores for each email address on a scale of 0–5. Higher scores indicate higher probability of the address being a spam trap or otherwise harmful.
get_batch_results
Get Batch Results
Download the results of a completed asynchronous batch email verification. Returns detailed verification data for each email. Results can be filtered by deliverability status.
create_batch_verification
Create Batch Verification
Submit a list of email addresses for asynchronous batch verification. Returns a batch ID that can be used to check status and download results later. This is the recommended approach for large email lists where the highest verification quality is needed, as Bouncer's distributed infrastructure retries verifications when required.
get_batch_status
Get Batch Status
Check the status of an asynchronous batch email verification job. Returns the current processing state, progress statistics, and timestamps. Use this to poll for completion after creating a batch verification.
check_credits
Check Credits
Check the available verification credits on your Bouncer account. Useful for monitoring usage and ensuring sufficient credits before running verifications.
finish_batch_verification
Finish Batch Verification
Request that a running verification batch finish early. Bouncer returns credits for emails that have not been verified. Processing finishes asynchronously; completed results remain available for download.
delete_batch_verification
Delete Batch Verification
Delete the emails and results associated with a verification batch. Deleted results cannot be downloaded again. Bouncer rejects deletion when the batch is in an incompatible state.
delete_toxicity_job
Delete Toxicity Job
Delete a toxicity check job and its stored email list and results from Bouncer.
Enable Bouncer in Metorial. In your Metorial portal, enable the Bouncer MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Bouncer tools.
Enable Bouncer in Metorial. In your Metorial portal, enable the Bouncer MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Bouncer tools.
Enable Bouncer in Metorial. In your Metorial portal, enable the Bouncer MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Bouncer tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Bouncer in Metorial. In your Metorial portal, enable the Bouncer MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Bouncer tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Bouncer in Metorial. In your Metorial portal, enable the Bouncer MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Bouncer tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Bouncer through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Bouncer and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Bouncer tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Verify and validate email addresses for deliverability, toxicity, and domain health. Perform real-time single email verification or batch verify up to 500,000 emails asynchronously. Check if emails are deliverable, undeliverable, risky, or unknown, and detect disposable, role-based, or catch-all addresses. Run toxicity checks to identify breached, spam-trap, or complainer emails on a 1-5 scale. Verify domain MX records and catch-all behavior. Monitor account credit balance for usage tracking.
Frequently asked questions
Common questions about connecting Bouncer to AI agents with Metorial.
How many tools does the Bouncer MCP server have?
The Bouncer MCP server exposes 13 tools, including Batch Verify Emails, Verify Email, Verify Domain. Each one is governed and traced through Metorial.
Does the Bouncer MCP server support triggers?
Bouncer exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Bouncer MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Bouncer MCP server through the same Metorial URL.
How do I give only some teams access to Bouncer?
Use role-based access control to decide which teams, users, and agents can use Bouncer and which of its tools they can call.
Can I self-host the Bouncer MCP server?
Yes. Metorial is open source, so you can run the Bouncer MCP server yourself or use the hosted gateway.
Connect Bouncer to production AI agents
See how Metorial gives your team governed access to Bouncer, with tracing and security controls built in.