Your company email, operable by any agent.

One remote MCP server. OAuth you approve. Mailboxes, Journeys, Broadcast, Product email, Approvals, and Logs, run by Claude, ChatGPT, Codex, Grok, or the agent you build.

Give your AI agent email on your own domain →

Server URL https://api.bangermail.com/mcp

https://api.bangermail.com/mcp
Streamable HTTP
OAuth 2.1, PKCE, dynamic client registration
com.bangermail/banger

Pick your agent. Follow the steps.

Choose a guide for your app, with visual setup instructions and a first prompt to try. Developer tools and CLI clients have their own guide.

The whole email operation, as tools.

More than a hundred tools, grouped the way the product is. Humans, Banger, and agents all see and change the same workspace state.

01

Onboarding and setup

Start or resume the same guided setup the app shows, as an interactive card in Claude and ChatGPT: send your first email, learn Broadcasts and Journeys, then connect your domain.

  • banger_onboarding_open_setup
  • banger_onboarding_get_state
  • banger_onboarding_save_brand
  • banger_onboarding_set_domain
  • banger_onboarding_verify_dns
  • banger_onboarding_add_inboxes
02

Mailboxes

Create hosted mailboxes on your domain or a starter address, read and search threads, triage, reply, and see what is waiting on your team.

  • banger_list_mailboxes
  • banger_create_native_mailbox
  • banger_list_threads
  • banger_search_mail
  • banger_archive_thread
  • banger_assign_thread
  • banger_send_email
  • banger_list_work
03

Product email

Receipts, confirmations, alerts, and account messages triggered by your product, with templates, previews, and delivery status per send.

  • banger_create_template
  • banger_preview_template
  • banger_get_transactional_send
  • banger_list_sends
  • banger_get_delivery_status
04

Broadcast

Build an audience, preview who will receive it, check readiness, schedule or send, and follow the timeline and per-recipient outcome.

  • banger_create_broadcast
  • banger_preview_broadcast_audience
  • banger_check_broadcast_readiness
  • banger_schedule_broadcast
  • banger_send_broadcast
  • banger_list_broadcast_timeline
05

Journeys

Every automated flow, from a one-step welcome to a multi-branch lifecycle: create, preview, enroll contacts, activate through review, and inspect executions.

  • banger_create_journey
  • banger_preview_journey
  • banger_enroll_journey_contacts
  • banger_set_journey_status
  • banger_list_journey_executions
  • banger_register_api_journey
06

Audiences

Contacts, lists, segments, and consent-checked imports, so every send targets people who agreed to hear from you.

  • banger_upsert_contact
  • banger_create_contact_list
  • banger_create_segment
  • banger_preview_segment
  • banger_request_contact_import
  • banger_validate_contact_import
07

Design and experiments

Generate and revise on-brand email designs from a starter library, keep the brand footer current, and run A/B experiments with recommended arms.

  • banger_generate_email_design
  • banger_revise_email_design
  • banger_list_starters
  • banger_get_brand
  • banger_create_experiment
  • banger_recommend_arms
08

Domains and deliverability

Add sending domains, get the exact DNS bundle, verify, prove activation with a real round trip, and watch deliverability by lane.

  • banger_create_native_sending_domain
  • banger_verify_native_sending_domain
  • banger_start_domain_activation_proof
  • banger_deliverability_summary
  • banger_pause_native_sending_lane
09

Approvals, Logs, and connections

Follow what waits for human review, read the audit trail, and read connected services and incoming webhooks without ever seeing a secret.

  • banger_list_approvals
  • banger_get_approval
  • banger_list_logs
  • banger_list_connections
  • banger_create_incoming_webhook

Least privilege, by default.

The authorization page shows the exact scope set, capped by your role. Workspaces are company boundaries; products are strict email boundaries inside them. Sensitive actions follow your approval policy, and every action lands in Logs.

mail:read

Read mailboxes, threads, and messages.

mail:write

Create mailboxes, labels, drafts, and triage threads.

mail:send

Send mailbox email and Product email.

contacts:read

Read contacts, lists, and segments.

contacts:write

Create and update contacts, lists, segments, and imports.

campaigns:read

Read Broadcasts, Journeys, templates, and designs.

campaigns:write

Create and edit Broadcasts, Journeys, templates, and designs.

campaigns:send

Schedule or send a Broadcast, activate a Journey.

automation:read

Read Journey executions, experiments, and Logs.

automation:execute

Run governed actions and experiments.

connections:read

See which services and webhooks are connected.

connections:use

Query connected services through Banger.

connections:admin

Connect, rotate, or remove services.

workspace:admin

Onboarding, products, sending domains, API keys, and approvals.

Standard OAuth, no surprises.

Banger implements the MCP authorization spec end to end: RFC 9728 resource metadata, RFC 8414 server metadata, RFC 7591 dynamic registration, PKCE S256, RFC 8707 resource indicators, and rotating refresh tokens. Redirect URIs may be HTTPS or HTTP loopback, so both hosted clients like Grok and local CLIs like Codex register cleanly. A missing scope is filled from the setup ticket or the role, so clients that omit it still get the reviewed grant.

Protected resource metadata

GET https://api.bangermail.com/.well-known/oauth-protected-resource/mcp

Authorization server metadata

GET https://api.bangermail.com/.well-known/oauth-authorization-server

Dynamic client registration

POST https://api.bangermail.com/oauth/register (public clients, token_endpoint_auth_method none)

Authorization

GET https://api.bangermail.com/oauth/authorize (response_type code, PKCE S256, optional scope and resource)

Token

POST https://api.bangermail.com/oauth/token (authorization_code and refresh_token, rotating refresh tokens)

Unauthenticated request

401 with WWW-Authenticate: Bearer resource_metadata=... so clients start OAuth instead of assuming success

Listed in the official MCP Registry as com.bangermail/banger. Plugin manifests for Claude, Grok, and Codex live in bangermail/banger-plugin.

What agents can and cannot do.

Straight answers about access, approvals, domains, and keys.

Which agents can connect to Banger MCP?

Any client that speaks the Model Context Protocol over Streamable HTTP with OAuth: Claude and Claude Code, ChatGPT and Codex, Grok and Grok Build, Cursor, and agents you build yourself. Banger is listed in the official MCP Registry as com.bangermail/banger, and the same plugin package ships manifests for Claude, Grok, and Codex.

What does the agent get access to?

Exactly the workspace you approve on the authorization page, with the scope set shown there and capped by your role. Workspaces are company boundaries and products are strict email boundaries inside them; an agent cannot combine audiences, mailboxes, or sends across products. You can revoke the grant from Banger at any time.

Can an agent send email or launch a Broadcast on its own?

Only within your workspace approval policy. Sending, launching a Broadcast, and activating a Journey are governed actions: where your policy requires review, the agent proposes and a person approves in Banger. Governed mutations use idempotency keys, and every action lands in Logs.

Do I need a domain first?

No. Onboarding creates a permanent Banger-hosted mailbox and proves a real send-and-receive round trip before it ever asks about a domain. Adding your own domain later gives you the exact DNS bundle and a verification the agent can run for you.

Is there an API key path for scripts and CI?

Yes. Create a workspace API key in Banger with the scopes you need and send it as a Bearer token to the same endpoint. OAuth is the right path for interactive agents because it ties the grant to a person and a workspace.

What is the setup URL the Banger app gives me?

The setup screen in Banger mints a short-lived, workspace-specific URL of the form https://api.bangermail.com/mcp/setup/<ticket>. It pre-binds the grant to your workspace, your client, and the reviewed scope set so the client needs no consent page. The plain endpoint works too; it just asks you to choose the workspace.

Give your agent a real email operation.

Start with a hosted mailbox and a real round trip, add your domain when you are ready, and let the agent you already use run the rest, with you reviewing what matters.