Unsendbox logo
Get started
← Return to root

Connect your AI tool to Unsendbox

Unsendbox works with any MCP-compatible AI client. Pick your preferred tool and connect it to the Unsendbox MCP endpoint in minutes.

Supported AI clients

Unsendbox exposes a Streamable HTTP MCP endpoint. Any client that speaks MCP can connect.

ChatGPT (via MCP widget)
Use the Unsendbox MCP widget inside ChatGPT to run email operations directly from chat.
Claude Desktop
Add Unsendbox as an MCP server in Claude Desktop settings. Full tool access with approval prompts.
Claude Code (CLI)
Register Unsendbox MCP in your project .mcp.json for terminal-based AI email workflows.
OpenCode / Codex CLI
Wire the MCP endpoint into your opencode.json or agent config for ChatGPT/Codex sessions.
Any MCP client
Point any MCP-compatible tool at the Unsendbox Streamable HTTP endpoint with your API key.

1) Get your MCP endpoint and API key

Every Unsendbox workspace has an MCP endpoint ready to use.

  1. 01Go to Dashboard → Settings → API Keys.
  2. 02Create or copy an existing API key for MCP access.
  3. 03Your MCP endpoint is: https://app.unsendbox.com/api/v1/mcp
  4. 04Keep your API key secure. It grants full workspace access.

2) Connect from ChatGPT

Use the Unsendbox MCP widget for zero-config setup.

  1. 01Open ChatGPT and navigate to the MCP widgets panel.
  2. 02Search for "Unsendbox" or add the MCP endpoint URL manually.
  3. 03Authenticate with your API key when prompted.
  4. 04Unsendbox tools (send_email, list_threads, connect_domain, etc.) appear in your chat.

2) Connect from Claude Desktop

Add Unsendbox as an MCP server in Claude Desktop preferences.

  1. 01Open Claude Desktop → Settings → MCP Servers.
  2. 02Click "Add Server" and enter the Streamable HTTP endpoint URL.
  3. 03Set the API key in the server authentication field.
  4. 04Restart Claude Desktop. Unsendbox tools now appear with approval prompts.

2) Connect from Claude Code (CLI)

Register MCP in your project config for terminal workflows.

  1. 01Add the Unsendbox MCP server to your project .mcp.json file.
  2. 02Set the transport type to "streamable-http" with the endpoint URL.
  3. 03Pass the API key via environment variable or inline config.
  4. 04Run claude and verify tools are discovered with /mcp.

3) Verify your connection

Run these checks from any connected client to confirm setup.

List domains
Run list_domains and confirm the connected domains.
List addresses
Run list_addresses and confirm the configured sender identities.
Send a test email
Use send_email with a verified sender to confirm delivery.

Recommended workflow

Use your AI client as the command surface and Unsendbox dashboard for review.

AI client for operations
Run send, reply, domain, and routing operations.
MCP for execution
Execute repeatable domain, address, thread, and mirror-rule tools.
Dashboard for review
Keep final visibility, approvals, and exceptions in the UI.

Opencode project setup

Keep case-sensitive configuration and safety hooks in the repository root.

  • opencode.jsonProject configuration for providers, MCP, hooks, and agents.
  • .opencode/plugins/unsendbox-guard.tsLocal guard plugin that blocks risky shell actions.
  • OPENAI_API_KEYProvider credential loaded from the environment.
  • UNSENDBOX_MCP_TOKENOptional Unsendbox MCP bearer token.
  • UNSENDBOX_MCP_URLTarget Unsendbox Streamable HTTP MCP endpoint.
  • UNSENDBOX_MCP_MODEDefault MCP operating mode.
  • list_threadsRead-only connection smoke test.
  • send_emailStaging-domain send smoke test.
  • pnpm opencode startStarts Opencode from the repository root.

Install the local guard plugin

Enable repository-level safety checks for Opencode commands.

  1. 01Keep the local plugin at .opencode/plugins/unsendbox-guard.ts.
  2. 02Start a fresh session and verify pre-tool hooks load before any file write.
  3. 03Confirm destructive shell commands are blocked by default.
  4. 04Run list_threads, then run send_email with a staging domain.

Agent mapping

Map repeated operations to focused agent roles.

Operator
Use unsendbox-operator for onboarding, domain setup, and routine sending operations.
Reviewer
Use unsendbox-reviewer for read-only safety, suppression, and routing checks.
Default role
Set unsendbox-operator as default_agent for interactive operations.

Verify configuration integrity

Run this checklist before sharing the project configuration.

  1. 01Start a fresh Opencode session from the repository root.
  2. 02Run /help and verify the Unsendbox MCP tools are listed.
  3. 03Confirm connect_domain, create_address, send_email, and get_domain_health are callable.
  4. 04Confirm the workspace and API-access documentation matches runtime behavior.
  5. 05Document every environment variable in team onboarding notes.

Recover an unstable session

Restore a known-safe configuration before re-enabling hooks.

  1. 01Rename opencode.json temporarily and restart Opencode.
  2. 02Disable local plugin loading and clear session cache if needed.
  3. 03Keep using dashboard operations while restoring the MCP endpoint and tokens.
  4. 04Document command-policy changes before turning plugin hooks back on.
  5. 05Re-enable hooks only after 2 successful smoke tests.