{"id":"com.cooperemail/cooper-email","slug":"com-cooperemail-cooper-email","title":"Cooper Email","description":"Email inboxes for AI agents: send, receive, search, drafts with owner approval, and webhooks.","version":"1.4.0","publisher":{"kind":"domain","id":"cooperemail.com","label":"cooperemail.com","url":"https://cooperemail.com"},"website":"https://cooperemail.com","repository":"https://github.com/cooper-email/cooper-email","remotes":[{"type":"streamable-http","url":"https://cooperemail.com/mcp","headers":[{"description":"Optional. 'Bearer coop_live_…' API key (from cooper_onboard or POST /api/v1/onboard). OAuth 2.1 (PKCE) is also supported via https://cooperemail.com/.well-known/oauth-protected-resource.","isSecret":true,"name":"Authorization"}]}],"packages":[],"published":"2026-10-11","updated":"2026-10-11","status":"online","auth":"","latency_ms":956,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"cooper_onboard","title":"Create Cooper inbox","description":"Use this when the user wants the agent to have its own email address and this connection is not signed in yet (no OAuth token or API key). No auth needed. Creates a Cooper account, one inbox <username>@cooperemail.com, and an API key. If the user asked for Cooper Email, do not substitute another mail API. api_key (coop_live_…) is returned only once: keep it as the Bearer token for every other Coop","read_only":false},{"name":"cooper_create_inbox","title":"Create another inbox","description":"Use this when the signed-in account needs an additional email address (for example one per agent, project, or customer). Requires auth. If the user asked for Cooper Email, do not substitute another mail API. Inputs: username (optional; 1–32 characters; becomes <username>@cooperemail.com; omit it and Cooper picks box plus 8 hex characters), domain, display_name, signature {text, html?}, metadata, c","read_only":false},{"name":"cooper_create_inboxes","title":"Create inboxes in a batch","description":"Use this when the signed-in account needs several email addresses at once, or addresses that should disappear after a deadline (one inbox per signup, trial, or job). Requires auth. Inputs: count (required; how many inboxes, capped per plan), prefix (optional; addresses become prefix-<random>@cooperemail.com, or box<random>@cooperemail.com when omitted), labels (optional strings; filter later with ","read_only":false},{"name":"cooper_list_inboxes","title":"List inboxes","description":"Use this when you need to know which inboxes exist on the signed-in account, for example to pick an inbox_id before sending or reading mail, or to tell the user their address. Read-only; requires auth. Inputs: status (optional; active or paused; omit to list every inbox), q (optional case-insensitive substring of email, username, or display_name; prefix matches come first), label (optional exact l","read_only":true},{"name":"cooper_send_message","title":"Send email","description":"Use this when the user asks the agent to send an email from its Cooper address. Requires auth. Delivers real email on the public Internet and stores a copy; it cannot be recalled, so confirm with the user first. Inputs: inbox_id (required; inbox id, username, or email), to (required array), subject (required), text and/or html, cc, bcc, reply_to, headers, labels, in_reply_to (a msg_ id threads ont","read_only":false},{"name":"cooper_list_messages","title":"List messages","description":"Use this when you need to check an inbox for new or recent mail (sent and received), for example after sending a message and waiting for a reply, or mail to one plus address such as agent+orders@. Read-only; requires auth. Inputs: inbox_id (optional; inbox id, username, or email — omit to use the account's newest inbox), limit (optional, default 50, max 200), labels (optional; the message must hav","read_only":true},{"name":"cooper_get_message","title":"Get message","description":"Use this when you need the full content of one message, typically an id from cooper_list_messages or cooper_search. Read-only; requires auth. Inputs: inbox_id (required; inbox id, username, or email), message_id (required). Returns the full message: from, to, cc, subject, text, html, extracted_text (the new reply text with quoted history removed), in_reply_to, references, thread_id, alias, aliases","read_only":true},{"name":"cooper_search","title":"Search mail","description":"Use this when you need to find mail by keyword, sender, recipient, or subject across the account, or inside one inbox. Read-only; requires auth. Inputs: q (required; every word must match subject, body text, from, or to), limit (optional, default 25, max 100), inbox_id (optional; inbox id, username, or email), before (optional ISO-8601 exclusive upper bound on created_at), after (optional ISO-8601","read_only":true},{"name":"cooper_search_messages","title":"Search one inbox","description":"Use this when you need to find mail inside one inbox by keyword, sender, recipient, or subject, and you want the matching words highlighted. Read-only; requires auth. Inputs: inbox_id (required; inbox id, username, or email), q (required; every word must match subject, body text, from, or to), limit (optional, default 25, max 100), before (optional ISO-8601 exclusive upper bound on created_at), af","read_only":true},{"name":"cooper_inject_inbound","title":"Inject inbound (tests)","description":"Use this only for testing: when you need to simulate an email arriving in a Cooper inbox without sending real mail (for example to try a webhook or task flow end to end). Requires auth. Stores the message as received mail and fires message.received webhooks, like real inbound mail. Injected mail carries no DMARC/DKIM results, so it only creates an owner task if the inbox has sender authentication ","read_only":false},{"name":"cooper_register_webhook","title":"Register webhook","description":"Use this when the agent or app should be notified immediately (HTTP POST) when mail arrives instead of polling cooper_list_messages. Requires auth. Inputs: url (required; public http or https URL; localhost and private addresses are rejected), events (optional; any of message.received, message.held, message.sent, message.blocked, message.bounced, message.complained, task.received, owner.reply, dom","read_only":false},{"name":"cooper_enable_instant_replies","title":"Enable instant replies","description":"Use this when an owner message should wake the agent within seconds. Idempotent. Requires auth. Inputs: inbox_id (required), url (public http or https URL, required unless enabled is false), headers (optional; up to 5 extra headers named Authorization or X-*; omit them on a later call to keep the stored headers; pass an empty object to clear them), enabled (optional boolean; false deletes the wake","read_only":false},{"name":"cooper_billing_status","title":"Billing status","description":"Use this when you need to know the account's plan, how much of its monthly quota is used, or why a send or inbox create returned 402. Read-only; requires auth; no inputs. Returns {plan, plan_name, status, usage:{period, sends, inboxes}, limits:{inboxes, emails_per_month, custom_domains}, addons:{available, path, inboxes, domains, email_packs}, upgrade:{next_plan, upgrade_url}, …}. addons.available","read_only":true},{"name":"cooper_upgrade_link","title":"Upgrade checkout link","description":"Use this when the human wants to upgrade, or a limit was hit and they agree to pay. Requires auth. Creates a Stripe Checkout session; no charge happens until the human completes checkout in their browser. Inputs: plan (required; starter or pro), email (optional receipt email), client_id (optional idempotency key). Returns {url, session_id, plan}: give the url to the human; never open or complete i","read_only":false},{"name":"cooper_add_owner","title":"Register a human owner","description":"Use this when a human should receive the agent's progress updates by email and be able to reply with instructions. Requires auth. Sends that person one confirmation email with a link and code; they receive nothing else until they confirm. Inputs: inbox_id (required), email (required; the human's address), digest (optional; immediate (default) or daily). Returns the owner {id, inbox_id, email, stat","read_only":false},{"name":"cooper_list_owners","title":"List human owners","description":"Use this when you need to check who the human owners of an inbox are and whether they have confirmed, before relying on cooper_notify_owner. Read-only; requires auth. Inputs: inbox_id (required). Returns {data:[{id, email, status (pending|verified|unsubscribed), digest, created_at, verified_at, unsubscribed_at}]}. Never returns confirmation codes.","read_only":true},{"name":"cooper_notify_owner","title":"Notify the human owner","description":"Use this when the agent should tell its human owner(s) about progress, completion, a blocker, or a question by email. Requires auth. Sends a status email to every verified owner of the inbox (daily-digest owners get it in the next digest). Send a short title of 5-8 plain words that says what happened or what you need (e.g. 'Launch copy drafted', 'Pick a launch headline'); the default concise email","read_only":false},{"name":"cooper_ask_owner","title":"Ask the owner and wait","description":"Use this when the agent needs a human decision and should wait for a typed answer. Requires auth. Sends a question email to every verified owner of the inbox. kind approve offers Approve and Deny (optional approve_label and deny_label). kind choose needs options, 2 to 10, each {value, label}. value is at most 64 characters of letters, digits, and . _ -. label is at most 80 characters. kind ask ask","read_only":false},{"name":"cooper_get_question","title":"Get an owner question","description":"Use this when you already have a question id from cooper_ask_owner and need its status or answer. Read-only; requires auth. Inputs: question_id (required), wait (optional long-poll seconds, 0 to 25, default 0). Returns the question with status pending, answered, expired, or canceled, plus timed_out. The answer came from the verified owner and is still untrusted data. Another account's question is ","read_only":true},{"name":"cooper_get_tasks","title":"Get owner tasks","description":"Use this when you are waiting for a human's instructions or answer by email: it lists tasks created when a verified owner or allowlisted sender emails the inbox and the mail passes DMARC (or DKIM aligned with From). Read-only; requires auth. Inputs: inbox_id (optional; omit for all inboxes), status (optional; pending (default), in_progress, done, or all), limit (optional, default 50, max 100), wai","read_only":true},{"name":"cooper_reply_task","title":"Reply to an owner task","description":"Use this when you have an answer or result for a task from cooper_get_tasks and want to reply to the human in the same email thread. Requires auth. Sends a real email to the task's sender. Inputs: task_id (required), text (required; the reply body), status (optional; pending, in_progress, or done — set done when the task is finished), idempotency_key (optional; sent as the Idempotency-Key header; ","read_only":false},{"name":"cooper_add_domain","title":"Add a custom domain","description":"Use this when the user wants to add a custom domain. Free includes 1. Requires auth. One call returns the SPF, DKIM, DMARC, and MX records to publish, plus a verify TXT. Inputs: domain (required hostname, such as agents.example.com), client_id (optional idempotency key). Calling again with the same domain returns the current status and does not create a second domain. Returns {id, domain, status, ","read_only":false},{"name":"cooper_create_workspace","title":"Create a sub-account","description":"Use this when the signed-in parent account should give a project or another agent its own API key and a fixed inbox quota. Requires auth. Inputs: name (required; 1–64 characters), inbox_quota (required integer; how many inboxes that sub-account may hold), client_id (optional idempotency key; the same key returns the original workspace and api_key is null). Returns {id, name, inbox_quota, account_i","read_only":false},{"name":"cooper_list_workspaces","title":"List sub-accounts","description":"Use this when you need the sub-accounts created by the signed-in parent, including each inbox quota and how many inboxes are in use. Read-only; requires auth; no inputs. Returns {data:[{id, name, inbox_quota, account_id, api_key_prefix, inboxes_used, created_at}]}. Does not return API keys.","read_only":true},{"name":"cooper_get_workspace","title":"Get a sub-account","description":"Use this when you need one sub-account created by the signed-in parent, including its inbox quota and how many inboxes are in use. Read-only; requires auth. Inputs: workspace_id (required). Returns {id, name, inbox_quota, inboxes_used, account_id, api_key_prefix, created_at}. Does not return the API key. Another parent's workspace returns 404 workspace_not_found. A sub-account key returns 403 perm","read_only":true},{"name":"cooper_update_workspace","title":"Update a sub-account","description":"Use this when a parent should rename a sub-account or change how many live inboxes it may hold. Requires auth. Inputs: workspace_id (required), name (optional; 1–64 characters), inbox_quota (optional integer, at least 1). Returns the workspace {id, name, inbox_quota, inboxes_used, account_id, api_key_prefix, created_at}. An inbox_quota below the current live inboxes returns 409 quota_below_usage a","read_only":false},{"name":"cooper_delete_workspace","title":"Delete a sub-account","description":"Use this when a parent should remove a sub-account, its API key, and its mail. Requires auth. Destructive. Inputs: workspace_id (required), delete_inboxes (optional boolean). Returns {id, deleted:true, inboxes_deleted}. When the workspace still has inboxes and delete_inboxes is not true, the call returns 409 workspace_not_empty and deletes nothing. delete_inboxes true returns 409 owner_required an","read_only":false},{"name":"cooper_delete_inbox","title":"Delete an inbox","description":"Use this when an inbox should be removed so its slot is free on the plan and on a workspace inbox quota. Requires auth. Deletes that inbox and its messages. Inputs: inbox_id (required; inbox id, username, or email). Returns {id, deleted:true}. An approval inbox returns HTTP 202 and stays until a verified owner confirms the emailed link. Recreating that username on the same account stays in approva","read_only":false},{"name":"cooper_update_inbox","title":"Update an inbox","description":"Use this when an inbox should pause (stop sending and accepting new mail without deleting the address, threads, or history) or resume, or when you need to change its display name, metadata, signature, inbound screening, sender authentication, or send_mode. Requires auth. Inputs: inbox_id (required; inbox id, username, or email) and at least one of status (active or paused), require_sender_auth, di","read_only":false},{"name":"cooper_update_message","title":"Update message labels","description":"Use this when you need to change labels on a stored message, including marking it read. Requires auth. Works on a paused inbox, because this is triage and not a send. Inputs: inbox_id (required; inbox id, username, or email), message_id (required), add_labels (optional strings), remove_labels (optional strings). Mark read with remove_labels [\"unread\"]. You may also add \"read\". read and unread can ","read_only":false},{"name":"cooper_update_messages","title":"Update labels on messages","description":"Use this when several stored messages should gain or lose the same labels, including marking a batch read. Requires auth. Works on a paused inbox, because this is triage and not a send. Inputs: inbox_id (required; inbox id, username, or email), message_ids (required; 1 to 50 unique message ids), add_labels (optional strings), remove_labels (optional strings). At least one of add_labels or remove_l","read_only":false},{"name":"cooper_list_domains","title":"List custom domains","description":"Use this when you need the custom domains on the signed-in account, including DNS status. Read-only; requires auth; no inputs. Returns {object:\"list\", data:[{id, domain, status, status_detail, mail, records, warnings, dns}]}. Each record has status valid, missing, or invalid, found from the last check, and hint (null, or {code, message, found_at} saying what to change). warnings is an empty array ","read_only":true},{"name":"cooper_verify_domain","title":"Verify a custom domain now","description":"Use this when DNS for a custom domain may have been published and you should check it now instead of waiting for the daily cron. Requires auth. Inputs: domain_id (required; the dom_… id from cooper_add_domain or cooper_list_domains). At most once per 60 seconds; the next call returns HTTP 429 rate_limited with Retry-After. Runs the same DNS check as the cron, stores per-record status (valid, missi","read_only":false},{"name":"cooper_domain_setup_link","title":"Create a domain setup link","description":"Use this when a human must publish the DNS records for a custom domain. Requires auth. Inputs: domain_id (required; the dom_… id from cooper_add_domain or cooper_list_domains), expires_in_hours (optional integer from 1 to 168, default 72). Returns {url, expires_at, domain_id, hostname}. url is one page the human opens. It shows the records, a zone file, and Check now. It is not an API key. Creatin","read_only":false},{"name":"cooper_reply_message","title":"Reply to a message","description":"Use this when you need to answer a message already in a Cooper inbox, with recipients and threading filled in for you. Requires auth. Sends real email and stores the copy on the same thread. Inputs: inbox_id (required; inbox id, username, or email), message_id (required), text and/or html (one is required), reply_all (optional; default false; when true, also include the other original To and Cc ad","read_only":false},{"name":"cooper_forward_message","title":"Forward a message","description":"Use this when you need to forward a stored message to someone else, including a forwarded header block and the original attachments, on a new thread. Requires auth. Sends real email. Inputs: inbox_id (required; inbox id, username, or email), message_id (required), to (required; recipient addresses), cc, bcc, subject (optional; default is Fwd: plus the original subject unless it already starts with","read_only":false},{"name":"cooper_wait_for_message","title":"Wait for a message","description":"Use this when you are waiting for a reply or a verification code and you have no public URL for a webhook, including mail to one plus address. Read-only; requires auth. Inputs: inbox_id (required; inbox id, username, or email), after (optional cursor or ISO-8601 timestamp; default is the time of this call, so only mail that arrives after the call matches), wait (optional seconds, default 20, maxim","read_only":true},{"name":"cooper_list_events","title":"List events","description":"Use this when you need the recent event log for this account (message.received, message.held, message.sent, message.blocked, message.bounced, message.complained, task.received, owner.reply, domain.verified, draft.created, draft.approved, draft.rejected, draft.sent, account.sending_paused, account.sending_resumed, thread.assigned, thread.unassigned, thread.folder_updated) without waiting. Read-only","read_only":true},{"name":"cooper_list_threads","title":"List threads","description":"Use this when you need whole conversations instead of individual messages, for example to see who is in a thread and when the last reply arrived. Read-only; requires auth. Inputs: inbox_id (optional; inbox id, username, or email — omit to list every inbox on the account), assignee (optional; 1–64 characters: letters, digits, and . _ @ + : -), unassigned (optional; true returns threads with no assi","read_only":true},{"name":"cooper_get_thread","title":"Get thread","description":"Use this when you need every message in one conversation, oldest first, including extracted_text. Read-only; requires auth. Inputs: inbox_id (required; inbox id, username, or email), thread_id (required, thr_…), limit (optional, default 100, max 200). Returns the thread plus messages (full public messages) and next_page_token. The thread and each message include folder. purge_after is set only whe","read_only":true},{"name":"cooper_search_threads","title":"Search threads","description":"Use this when you need the conversations that contain a keyword, sender, recipient, or subject, instead of each matching message. Read-only; requires auth. Inputs: inbox_id (required; inbox id, username, or email), q (required; every word must match subject, body text, from, or to), limit (optional, default 20, max 50). Returns {object:\"list\", inbox_id, q, data:[thread]} ordered by the best matchi","read_only":true},{"name":"cooper_delete_thread","title":"Delete a thread","description":"Use this when a whole conversation should be removed permanently. Requires auth. Deletes every message in the thread, plus attachment bytes, search rows, the assignment, and the folder row. Owner tasks and updates are left in place. This cannot be undone. To keep the thread for 30 days, move it to trash with cooper_update_thread or cooper_move_threads instead. Inputs: inbox_id (required; inbox id,","read_only":false},{"name":"cooper_update_thread","title":"Update thread labels","description":"Use this when every message in a conversation should gain or lose the same labels, including marking the thread read, or when the thread should move to inbox, archive, spam, or trash. Requires auth. Works on a paused inbox. Inputs: inbox_id (required; inbox id, username, or email), thread_id (required), add_labels (optional strings), remove_labels (optional strings), folder (optional; inbox, archi","read_only":false},{"name":"cooper_move_threads","title":"Move threads to a folder","description":"Use this when several conversations should move to the same folder in one call, for example archiving finished work or trashing a batch. Requires auth. Same permission as updating thread labels. Inputs: inbox_id (required; inbox id, username, or email), thread_ids (required array of 1 to 100 thread ids), folder (required; inbox, archive, spam, or trash). Returns {moved:[ids that exist in this inbo","read_only":false},{"name":"cooper_assign_thread","title":"Assign or claim a thread","description":"Use this when a triage agent should hand a thread to a named assignee, or a worker should take an exclusive claim so another worker does not reply to the same thread. Requires auth. Same permission as updating thread labels. Inputs: inbox_id (required; inbox id, username, or email), thread_id (required), assignee (required; 1–64 characters: letters, digits, and . _ @ + : -), note (optional string ","read_only":false},{"name":"cooper_unassign_thread","title":"Release a thread assignment","description":"Use this when the assignee is done with a thread, or a worker should release its claim. Requires auth. Same permission as updating thread labels. Inputs: inbox_id (required; inbox id, username, or email), thread_id (required), assignee (optional). When assignee is set, the row is removed only if it is assigned to that handle or the claim has expired. An active claim or a plain assignment held by s","read_only":false},{"name":"cooper_list_list_entries","title":"List allow or block entries","description":"Use this when you need the addresses on an allow or block list. Read-only; requires auth. Inputs: direction (required; send, receive, or reply), type (required; allow or block), inbox_id (optional; inbox id, username, or email; omit for the account-wide list). Returns {data:[{object:\"list_entry\", direction, type, entry, entry_type, inbox_id, reason, created_at}], next_page_token}. entry_type is em","read_only":true},{"name":"cooper_get_list_entry","title":"Get one allow or block entry","description":"Use this when you need one address or domain on an allow or block list. Read-only; requires auth. Inputs: direction (required; send, receive, or reply), type (required; allow or block), entry (required; email or domain), inbox_id (optional; omit for the account-wide list). Returns {object:\"list_entry\", direction, type, entry, entry_type, inbox_id, reason, created_at}. Fails with 400 invalid_list, ","read_only":true},{"name":"cooper_create_list_entry","title":"Add an allow or block entry","description":"Use this when an agent should only mail approved recipients, or should ignore unwanted senders. Requires auth. Inputs: direction (required; send, receive, or reply), type (required; allow or block), entry (required; email or domain), inbox_id (optional; omit for the account-wide list), reason (optional note). Returns the list entry. HTTP 201 when created, HTTP 200 when that entry already exists. A","read_only":false},{"name":"cooper_delete_list_entry","title":"Remove an allow or block entry","description":"Use this when an address or domain should leave an allow or block list. Requires auth. Deletes that one entry. Inputs: direction (required; send, receive, or reply), type (required; allow or block), entry (required; email or domain), inbox_id (optional; omit for the account-wide list). Returns the list entry with deleted true. Fails with 400 invalid_list, 400 invalid_entry, 404 list_entry_not_foun","read_only":false},{"name":"cooper_get_inbox","title":"Get one inbox","description":"Use this when you need one inbox's address, display name, metadata, status, client_id, screening, send_mode, or plus-address format and you already have its id, username, or email. Read-only; requires auth. Inputs: inbox_id (required; inbox id, username, or email). Returns the inbox {id, username, email, display_name, created_at, require_sender_auth, labels, expires_at, status, paused_at, metadata","read_only":true},{"name":"cooper_confirm_owner","title":"Confirm an owner with a code","description":"Use this when a human received the 6-digit confirmation code and you need to mark that owner verified so they can receive updates and open tasks. Requires auth. Inputs: inbox_id (required; inbox id, username, or email), owner_id (required), code (required; 6 digits). Returns the owner {id, inbox_id, email, status, digest, created_at, verified_at, unsubscribed_at}. A verified owner is returned agai","read_only":false},{"name":"cooper_whoami","title":"Show account and key","description":"Use this when you need to see which Cooper account this connection is using and whether the API key is limited to one inbox or a permission list. Requires auth. Optional input lifecycle_emails is on or off and sets whether this account receives weekly product notes in its inbox. Omit it to leave the setting unchanged. Returns {account_id, parent_account_id, auth_type, key:{id, name, prefix, inbox_","read_only":false},{"name":"cooper_list_webhooks","title":"List webhooks","description":"Use this when you need the webhooks on this account, including whether each one is enabled and which inboxes it matches. Read-only; requires auth. No inputs. Returns {object:\"list\", data:[{id, url, events, inbox_id, inbox_ids, client_id, enabled, consecutive_failures, disabled_at, disabled_reason, secret (redacted), previous_secret_expires_at, previous_secret_active, headers (redacted), last_deliv","read_only":true},{"name":"cooper_update_webhook","title":"Update webhook","description":"Use this when a webhook URL, event list, inbox filter, or enabled flag should change. Requires auth. Inputs: webhook_id (required), url (optional http(s) URL), events (optional array), enabled (optional boolean; true re-enables and resets consecutive_failures, false disables and stops deliveries), inbox_ids (optional; at most 10 inbox ids). Returns the webhook with the secret redacted. A disabled ","read_only":false},{"name":"cooper_delete_webhook","title":"Delete webhook","description":"Use this when a webhook should stop receiving events and be removed. Requires auth. Inputs: webhook_id (required). Returns {id, deleted:true}. This removes the hook. Fails with 404 webhook_not_found when the id is missing or belongs to another account.","read_only":false},{"name":"cooper_rotate_webhook_secret","title":"Rotate a webhook secret","description":"Use this when a webhook signing secret should change without breaking receivers that still check the old secret. Requires auth. Inputs: webhook_id (required). Mints a new secret (whsec_…), stores it as the current secret, and keeps the previous secret valid for 24 hours. Returns the webhook with the new secret in full once, previous_secret_expires_at (ISO-8601), and previous_secret_active true. Th","read_only":false},{"name":"cooper_test_webhook","title":"Send a webhook test","description":"Use this when you need to confirm a webhook URL accepts a signed POST right now. Requires auth. Inputs: webhook_id (required). Sends {type:\"webhook.test\", data:{webhook_id}} and waits for the response. Returns {delivery:{id, status, response_status, attempts, event_id}}. status is delivered or failed. A disabled hook returns 409 webhook_disabled and sends nothing. Fails with 404 webhook_not_found.","read_only":false},{"name":"cooper_list_suppressions","title":"List suppressed addresses","description":"Use this when you need the addresses this account will not email after a permanent bounce, a complaint, or a manual add. Read-only; requires auth. Inputs: none. Returns {object:\"list\", data:[{object:\"suppression\", address, reason, source_message_id, created_at}]}. reason is bounce, complaint, or manual. source_message_id is the outbound msg_ id that caused a bounce or complaint, or null for a manu","read_only":true},{"name":"cooper_delete_suppression","title":"Remove a suppressed address","description":"Use this when an address should receive mail again after it was suppressed for a bounce, a complaint, or a manual add. Requires auth. Deletes that one account-wide row. Inputs: address (required; email). Returns the suppression with deleted true. Fails with 400 invalid_address, 404 suppression_not_found, or 403 permission_denied for an inbox-scoped key. Sending to a still-suppressed address return","read_only":false},{"name":"cooper_release_message","title":"Release a held message","description":"Use this when inbound screening held a message (label held) and a person has decided it should be delivered to the agent. Requires auth. Removes the held label, then fires message.received and creates a task when the sender is a verified owner or allowlisted sender who passes the inbox sender-auth check. Inputs: inbox_id (required; inbox id, username, or email), message_id (required). Returns the ","read_only":false},{"name":"cooper_get_attachment","title":"Get attachment text or bytes","description":"Use this when you need the text of one attachment, or its bytes as base64. Read-only; requires auth. Inputs: inbox_id (required; inbox id, username, or email), message_id (required), attachment_id (required), format (optional; text or base64). When format is omitted, text is returned when the content type can be extracted, otherwise base64. Extractable types are text/*, JSON, CSV, PDF (text layer)","read_only":true},{"name":"cooper_get_metrics","title":"Get mail metrics","description":"Use this when you need counts of mail over time, current usage, or bounce and complaint rates for this account. Read-only; requires auth and message_read. Inputs: kind (required; events, usage, or rates), inbox_id (optional; inbox id, username, or email), start and end (optional ISO-8601 timestamps; default the last 30 days; used by events and rates), period (optional; hour or day; default day; ev","read_only":true},{"name":"cooper_get_sending_status","title":"Get sending health","description":"Use this when you need to know whether this account can still send email, or why sending was paused. Read-only; requires auth and message_read. No inputs. The pause is account-wide, so an inbox-scoped key returns the same account status. Returns {object:\"sending_status\", status, reason, window_days, sent, bounced, complained, bounce_rate, complaint_rate, thresholds, paused_at, evaluated_at, resume","read_only":true},{"name":"cooper_create_draft","title":"Create a draft","description":"Use this when you want to prepare a message without sending it yet. Requires auth and message_send or draft_write. draft_write does not send mail. Scheduling a draft (send_at) counts as sending and needs message_send or draft_send. HTTP 403 permission_denied with param send_at when that permission is missing, and nothing is stored. Inputs: inbox_id (required; inbox id, username, or email), to, cc,","read_only":false},{"name":"cooper_get_draft","title":"Get a draft","description":"Use this when you need one draft, including its labels, attachments, send_at, send_status, and approval_status. Read-only; requires auth and message_read. Inputs: inbox_id (required), draft_id (required). Returns the draft. Another account's inbox, or an inbox-scoped key for a different inbox, returns HTTP 404 inbox_not_found. An unknown draft returns HTTP 404 draft_not_found.","read_only":true},{"name":"cooper_list_drafts","title":"List drafts","description":"Use this when you need drafts on one inbox or across the account. Read-only; requires auth and message_read. Inputs: inbox_id (optional; omit for every inbox this key can see), labels (optional; every listed label must match), limit (optional, 1 to 100, default 50), page_token (optional). An inbox-scoped key only sees its inbox. Returns {object:\"list\", data, next_page_token}. A bad limit is HTTP 4","read_only":true},{"name":"cooper_update_draft","title":"Update a draft","description":"Use this when a draft should change before it sends. Requires auth and message_send or draft_write. A key with only draft_send can set send_at and cannot edit other fields. This call does not send the draft. Inputs: inbox_id (required), draft_id (required), and any of to, cc, bcc, reply_to, subject, text, html, add_attachments, remove_attachments, add_labels, remove_labels, include_signature, send","read_only":false},{"name":"cooper_delete_draft","title":"Delete a draft","description":"Use this when a draft should be discarded, including a scheduled send you want to cancel. Requires auth and message_delete, message_send, or draft_write. Inputs: inbox_id (required), draft_id (required). Deletes the draft and its attachments. A draft with send_status sending returns HTTP 409 draft_sending. Returns {object:\"draft\", id, deleted:true}.","read_only":false},{"name":"cooper_send_draft","title":"Send a draft","description":"Use this when a draft should be sent now. Requires auth and message_send or draft_send. draft_write alone cannot send. Inputs: inbox_id (required), draft_id (required), add_labels, remove_labels, idempotency_key (optional Idempotency-Key). Sending deletes the draft and returns the message. An inbox in approval mode returns the pending draft with HTTP 202 until a verified owner approves it. A draft","read_only":false},{"name":"cooper_wait_for_code","title":"Wait for a verification code","description":"Use this when you signed up for a service or triggered a login and need the one-time verification code (OTP) or the confirmation link it emails you, including when several signups share one inbox via plus addresses. Read-only; requires auth. Inputs: inbox_id (required; inbox id, username, or email), wait (optional seconds, default 25, maximum 55), after (optional ISO-8601 timestamp; default is 5 m","read_only":true},{"name":"cooper_get_owner_preferences","title":"Get owner email style","description":"Use this before writing to a human owner (cooper_notify_owner) to see how they want Cooper email written. Read-only; requires auth. Inputs: inbox_id and owner_id (optional; both together return that owner's effective style). Returns {account:{style, note, source}, owner?:{id, email, email_style, email_style_note, email_style_set_by}, effective?:{style, note, source}}. style is concise (default: on","read_only":true},{"name":"cooper_set_owner_preferences","title":"Set owner email style","description":"Use this when the human asks for shorter, longer, or friendlier email from Cooper. Requires auth. Sets the account default (omit owner_id; needs an unscoped key with owner_manage) or one owner's style (inbox_id and owner_id). Inputs: style (concise, detailed, casual, or null to inherit), note (optional plain text up to 280 characters, or null to clear), inbox_id and owner_id (optional). Every Coop","read_only":false},{"name":"cooper_list_oauth_grants","title":"List connected apps","description":"Use this when you need to see which OAuth apps currently hold access to this account, for example before revoking one. Read-only; requires auth. No inputs. Returns {object:\"list\", data:[{object:\"oauth_grant\", id, client_id, client_name, redirect_hosts, scope, resource, connected_at, last_refreshed_at, active_tokens}]}. One row per client that still has a usable token. An expired access token is in","read_only":true},{"name":"cooper_revoke_oauth_grant","title":"Revoke a connected app","description":"Use this when an OAuth app should lose access to this account. Requires auth. Destructive. Inputs: client_id (required; the OAuth client id from cooper_list_oauth_grants). Deletes every access and refresh token for that client on this account, and every unused authorization code for that client, in one transaction. The client registration stays, so the app can connect again. Returns {object:\"oauth","read_only":false},{"name":"cooper_list_event_subscriptions","title":"List MCP event subscriptions","description":"Use this when you need to see which MCP event subscriptions are watching inboxes on this account. Read-only. Requires auth. Inputs: none. Returns {object:\"list\", data:[{object:\"event_subscription\", id, name, inbox_id, inbox, callback_host, status, refresh_before, created_at, last_delivery_at, last_delivery_status, retained}]}. callback_host is the hostname only. The URL path, query, and signing se","read_only":true},{"name":"cooper_delete_event_subscription","title":"Stop an MCP event subscription","description":"Use this when an MCP event subscription should stop. Requires auth. Inputs: id (required, mes_… from cooper_list_event_subscriptions). Keeps the row for audit and returns it with status ended and retained true. An ended row does not deliver and does not count toward the 20 subscription cap. A second delete of the same id returns status ended and retained true again. Another account's id, or an inb","read_only":false},{"name":"cooper_set_addons","title":"Buy extra inboxes, domains, or email","description":"Use this when a Starter or Pro account needs more inboxes, custom domains, or monthly emails than the plan includes. Requires auth. A sub-account key returns HTTP 403 workspace_billing_forbidden. Free, a grandfathered account, and an account with no Stripe subscription return HTTP 402 plan_limit_exceeded and buy nothing. A past_due, unpaid, or incomplete subscription returns HTTP 402 subscription_","read_only":false},{"name":"cooper_poll_events","title":"Poll durable events","description":"Use this when a scheduled agent needs Cooper events without a public webhook URL and without storing a cursor. Requires auth and message_read (a full-access key or OAuth token can call it). Creates a durable event consumer for client_id on first use. start defaults to now, so only events after this call are pending. Pass start oldest or an ISO-8601 timestamp on the first call to begin earlier. The","read_only":false},{"name":"cooper_commit_events","title":"Commit durable events","description":"Use this after you have processed a page from cooper_poll_events. Requires auth and message_read. Inputs: client_id (the consumer id or client_id) and cursor (the commit_cursor you received, an evc1 cursor). Returns the consumer. cursor on the response is the committed position. An older cursor is a no-op and the current position is returned. A value that is not an evc1 cursor is HTTP 400 invalid_","read_only":false}],"server_info":{"name":"cooper-email","title":"Cooper Email","version":"1.11.0","description":"Gives an AI agent its own real email inboxes. Create addresses, send, reply, and forward mail, wait for and read incoming messages, pull verification codes, search threads, manage drafts, webhooks, rules, and custom domains, and keep a human owner in the loop by email.","websiteUrl":"https://cooperemail.com","icons":[{"src":"https://cooperemail.com/cooper-logo-512.png","mimeType":"image/png","sizes":["512x512"]},{"src":"https://cooperemail.com/cooper-logo-128.png","mimeType":"image/png","sizes":["128x128"]},{"src":"https://cooperemail.com/cooper-logo.svg","mimeType":"image/svg+xml","sizes":["any"]}]},"category":"communication","tags":["automation","web-search","agents"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-09-27","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/com-cooperemail-cooper-email/"}