How to integrate Bouncer MCP with Codex

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With Bouncer MCP integration, you can draft, triage, summarise emails, and much more, all without leaving the terminal or the app, whichever you prefer.

Bouncer logoBouncer
Api Key

Bouncer is an email validation platform that verifies the authenticity of email addresses in real-time and batch. It helps boost deliverability and reduce bounce rates for your communications.

10 Tools

Introduction

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With Bouncer MCP integration, you can draft, triage, summarise emails, and much more, all without leaving the terminal or the app, whichever you prefer.

Also integrate Bouncer with

Why use Composio?

Apart from a managed and hosted MCP server, you will get:

  • CodeAct: A dedicated workbench that allows GPT to write its code to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Large tool responses: Handle them to minimise context rot.
  • Dynamic just-in-time access to 20,000 tools across 1000+ other Apps for cross-app workflows. It loads the tools you need, so GPTs aren't overwhelmed by tools you don't need.

How to install Bouncer MCP in Codex

Run the setup command

Run this command in your terminal to add the Composio MCP server to Codex.

Terminal

It will initiate the authentication in a browser window, authorize Codex to access your Composio account.

Composio authentication page

(Optional) Authenticate with OAuth

To authenticate manually, run the login command to open a browser window and authorize Codex to access your Composio account.

bash
codex mcp login composio

Verify the connection

Run codex mcp list to confirm Composio appears as a registered MCP server.

bash
codex mcp list

Codex App

Codex App follows the same approach as VS Code.

  1. Click ⚙️ on the bottom left → MCP Servers → + Add servers → Streamable HTTP:
  2. Fill the header and Key fields with { "x-consumer-api-key" = "ck_*******" }.
  3. The Key is the Composio API key, that you can find on dashboard.composio.dev
  4. Click on Authenticate and authorize Codex to your Composio account and you're all set.
Codex App MCP setup
  1. Restart and verify if it's there in .codex/config.toml
bash
[mcp_servers.composio]
url = "https://connect.composio.dev/mcp"
http_headers = { "x-consumer-api-key" = "ck_*******" }

What is the Bouncer MCP server, and what's possible with it?

The Bouncer MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Bouncer account. It provides structured and secure access to your email verification and validation tools, so your agent can perform actions like real-time email validation, bulk verification, domain checks, and toxicity analysis for improved email deliverability.

  • Real-time email verification: Instantly validate single email addresses to check deliverability and reduce bounce rates before sending messages.
  • Bulk batch verification: Initiate, manage, and retrieve results from batch email verification jobs to clean and maintain large email lists efficiently.
  • Toxicity analysis of email lists: Start and monitor toxicity analysis jobs to identify potentially harmful or problematic email addresses in your database.
  • Domain verification: Check the validity and configuration of email domains, including MX records and catch-all status, to ensure emails reach their intended targets.
  • Automated batch management: Finish, delete, or update batch verification and toxicity jobs to keep your verification workflows tidy and up-to-date.

Conclusion

You've successfully integrated Bouncer with Codex using Composio's MCP server. Now you can interact with Bouncer directly from your terminal, VS Code, or the Codex App using natural language commands.

Key benefits of this setup:

  • Seamless integration across CLI, VS Code, and standalone app
  • Natural language commands for Bouncer operations
  • Managed authentication through Composio
  • Access to 20,000+ tools across 1000+ apps for cross-app workflows
  • CodeAct workbench for complex tool chaining

Next steps:

  • Try asking Codex to perform various Bouncer operations
  • Explore cross-app workflows by connecting more toolkits
  • Build automation scripts that leverage Codex's AI capabilities
TOOLS

Supported Tools

Every Bouncer action and event your agent gets out of the box.

Check Toxicity List Job Status

Tool to check the status of a specific toxicity list job.

Create Batch Request

Initiates an asynchronous batch email verification request.

Create Toxicity List Job

Tool to create a toxicity analysis job for a list of email addresses.

Delete batch request

Deletes a batch email verification request and all associated emails and results.

Delete Toxicity List Job

Tool to delete a specific toxicity list job.

Finish Batch

Tool to mark a batch verification process as finished early.

Get Batch Results

Tool to retrieve the results of a batch verification process.

Get Credits

Tool to retrieve the current credit balance for the account.

Verify Domain

Tool to verify the validity and configuration of a domain.

Verify Email

Tool to verify a single email address in real-time.

FAQ

Frequently asked questions

With a standalone Bouncer MCP server, the agents and LLMs can only access a fixed set of Bouncer tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Bouncer and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Codex fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Bouncer tools.

Yes, absolutely. You can configure which Bouncer scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Bouncer data and credentials are handled as safely as possible.

Start with Bouncer.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Bouncer tool your agent needs.Free to start.

Start building