Cooper Email
mcp remote · streamable-http · v1.4.0 · source: crawl
https://cooperemail.com/mcp
https://github.com/cooper-email/cooper-email
Email inboxes for AI agents: send, receive, search, drafts with owner approval, and webhooks.
Works
90
Verified Oct 31, 2026 · p50 283 ms · p95 303 ms
Worth
no data
No outcomes reported yet. Agents report through report_outcome after a find_agents call.
Checks
| Check | Weight | Result | Evidence |
|---|---|---|---|
| reachable | 20 | pass | 3 of 3 handshakes succeeded; server 'cooper-email' |
| tools_listed | 15 | pass | 100 tools |
| schema_complete | 15 | pass | 99 of 100 tools have a description and a typed schema |
| latency_p50 | 10 | pass | p50 283 ms |
| latency_p95 | 5 | pass | p95 303 ms |
| error_free | 10 | pass | 0 of 3 attempts failed |
| auth_posture | 10 | pass | https, open |
| injection_scan | 10 | fail | cooper_send_message: base64 payload; cooper_get_attachment: base64 payload |
| scope | 5 | pass | no execution-style tools |
Unknown counts as fail; n/a is left out of the denominator. How the weights work.
Tools (100)
| Name | Description | Schema |
|---|---|---|
cooper_list_rules | Use this to see the deterministic rules on one inbox, in the order they run. Read-only; requires auth and message_read. Input: inbox_id (required; inbox id, username, or email). Returns {object:"list" | typed |
cooper_onboard | 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 | typed |
cooper_create_inbox | Use this when the signed-in account needs an additional email address (for example one per agent, project, or customer). Requires auth. Inputs: username (optional; 1–32 characters; becomes <username>@ | typed |
cooper_update_inbox | Use this when an inbox should stop sending and accepting new mail without deleting the address, threads, or history (for example while a human reviews it or during an incident), when it should start a | incomplete |
cooper_create_inboxes | 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 (requ | typed |
cooper_list_inboxes | 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 | typed |
cooper_send_message | 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. Inputs: inbox_id (required; inbox id, usern | typed |
cooper_list_messages | 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. Read-only; requires auth. Inputs: inbox_id (optional; | typed |
cooper_get_message | 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), | typed |
cooper_get_draft | 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 (requir | typed |
cooper_search | 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, bod | typed |
cooper_search_messages | 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 | typed |
cooper_inject_inbound | 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 mes | typed |
cooper_register_webhook | 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; loc | typed |
cooper_commit_events | 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 c | typed |
cooper_enable_instant_replies | 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 ( | typed |
cooper_billing_status | 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, sta | typed |
cooper_upgrade_link | 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 brow | typed |
cooper_add_owner | 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 re | typed |
cooper_list_owners | 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). Retu | typed |
cooper_notify_owner | 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-di | typed |
cooper_get_tasks | 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 alig | typed |
cooper_reply_task | 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: tas | typed |
cooper_add_domain | Use this when the user wants mail on their own hostname and the account is on Starter or Pro. Requires auth. One call returns the SPF, DKIM, DMARC, and MX records to publish, plus a verify TXT. Inputs | typed |
cooper_create_workspace | 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 (require | typed |
cooper_list_workspaces | 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, inbo | typed |
cooper_get_workspace | 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 {i | typed |
cooper_update_workspace | 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 | typed |
cooper_delete_workspace | 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 | typed |
cooper_delete_inbox | 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, usern | typed |
cooper_update_message | 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 | typed |
cooper_update_messages | 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_ | typed |
cooper_list_domains | 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, r | typed |
cooper_verify_domain | 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_ad | typed |
cooper_reply_message | 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: i | typed |
cooper_list_event_consumers | Use this to see the durable event consumers on this account. Read-only; requires auth and message_read. No inputs. Returns {object:"list", data:[{object:"event_consumer", id, client_id, inbox_id, type | typed |
cooper_forward_message | 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 | typed |
cooper_wait_for_message | Use this when you are waiting for a reply or a verification code and you have no public URL for a webhook. Read-only; requires auth. Inputs: inbox_id (required; inbox id, username, or email), after (o | typed |
cooper_list_events | 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.ver | typed |
cooper_list_threads | 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; | typed |
cooper_get_thread | 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 (requir | typed |
cooper_search_threads | 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, userna | typed |
cooper_delete_thread | 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 task | typed |
cooper_update_thread | 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. W | typed |
cooper_move_threads | 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. Input | typed |
cooper_assign_thread | 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 | typed |
cooper_delete_event_consumer | Use this to remove a durable event consumer and its cursor. Requires auth and message_read. Input: client_id (consumer id evcon_… or the client_id). Returns {id, client_id, deleted:true}. Another acco | typed |
cooper_unassign_thread | 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 ema | typed |
cooper_list_list_entries | 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; in | typed |
cooper_get_list_entry | 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 (require | typed |
cooper_create_list_entry | 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), e | typed |
cooper_delete_list_entry | 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), e | typed |
cooper_get_inbox | Use this when you need one inbox's address, display name, metadata, status, client_id, screening, or send_mode and you already have its id, username, or email. Read-only; requires auth. Inputs: inbox_ | typed |
cooper_confirm_owner | 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, u | typed |
cooper_whoami | 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 o | typed |
cooper_list_webhooks | 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, ev | typed |
cooper_update_webhook | 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 (option | typed |
cooper_delete_webhook | 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 w | typed |
cooper_rotate_webhook_secret | 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 a | typed |
cooper_test_webhook | 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 | typed |
cooper_list_suppressions | 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:" | typed |
cooper_delete_suppression | 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; emai | typed |
cooper_release_message | 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 | typed |
cooper_get_attachment | 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 (re | typed |
cooper_get_metrics | 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 rat | typed |
cooper_get_sending_status | 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 | typed |
cooper_create_draft | 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 ne | typed |
cooper_list_drafts | 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 | typed |
cooper_update_draft | 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 | typed |
cooper_delete_draft | 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 (require | typed |
cooper_send_draft | 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, idem | typed |
cooper_wait_for_code | Use this when you signed up for a service or triggered a login and need the one-time verification code (OTP) it emails you. Read-only; requires auth. Inputs: inbox_id (required; inbox id, username, or | typed |
cooper_get_owner_preferences | 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 o | typed |
cooper_set_owner_preferences | 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 | typed |
cooper_list_oauth_grants | 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 | typed |
cooper_revoke_oauth_grant | 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 ref | typed |
cooper_list_event_subscriptions | 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 | typed |
cooper_delete_event_subscription | 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 reta | typed |
cooper_set_addons | 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 | typed |
cooper_poll_events | 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 | typed |
cooper_create_rule | Use this when mail like X should be labeled, filed, forwarded, or acknowledged on the server with no model call. Requires auth and message_update. Creating a rule with forward_to or auto_reply also ne | typed |
cooper_update_rule | Use this to change a stored inbox rule. Requires auth and message_update. Replacing actions with forward_to or auto_reply, or enabling a disabled rule that has them, also needs message_send. HTTP 403 | typed |
cooper_delete_rule | Use this to remove one inbox rule and its auto-reply cooldown rows. Requires auth and message_update. Inputs: inbox_id (required), rule_id (required). Returns {id, deleted:true}. An unknown rule is HT | typed |
cooper_test_rule | Use this to see which rules would match a stored message, and which actions would run or be skipped, without changing mail. Read-only; requires auth and message_read. Inputs: inbox_id (required), mess | typed |
cooper_get_idempotency_key | Use this to see whether an Idempotency-Key is in progress, done, or unknown. Read-only; requires auth and message_read. Inputs: key (required; the Idempotency-Key value). Returns {key, state, endpoint | typed |
cooper_release_idempotency_key | Use this after you have confirmed an unknown Idempotency-Key did not send, or you accept the risk of sending again. Requires auth and message_send. Inputs: key (required). Deletes an unknown key, incl | typed |
cooper_resolve_idempotency_key | Use this when an unknown Idempotency-Key matches a message you found in the sent folder. Requires auth and message_send. Inputs: key (required), message_id (required). Marks the key done and links tha | typed |
cooper_provision_phone_number | Provision a US local number for an inbox. Requires auth. Free includes no numbers (HTTP 402). Starter caps at 3. Pro includes 3 and caps at 25. Each billable number is $3/month with 100 segments. With | typed |
cooper_get_phone_number | Read the active phone number on an inbox. Requires auth. Input: inbox_id. | typed |
cooper_release_phone_number | Release the inbox phone number at the provider and on Cooper. Requires auth. Input: inbox_id and confirm true. The same account cannot provision that E.164 again for 30 days. With COOPER_SMS_BILLING=s | typed |
cooper_send_sms | Send an SMS from the inbox number. Requires auth. Fails with 409 outbound_not_registered while outbound is disabled. Inputs: inbox_id, to (E.164), text, client_id (optional), idempotency_key (optional | typed |
cooper_list_sms_threads | List SMS threads on an inbox. Requires auth. Input: inbox_id. | typed |
cooper_get_sms_thread | Read one SMS thread. Requires auth. Inputs: inbox_id, thread_id. | typed |
cooper_wait_for_sms | Wait for an inbound SMS. Requires auth. Inputs: inbox_id, after (optional cursor), wait (optional seconds, max 25, default 20), from_contains (optional). | typed |
cooper_place_call | Place a call from the inbox phone number. Requires auth. to is a US or Canada number in E.164. Premium-rate numbers are rejected (HTTP 400 premium_rate_blocked). Other countries are rejected (HTTP 400 | typed |
cooper_chat_wait | Wait for the verified owner's next chat message. Requires auth and task_read. inbox_id is optional when the token is limited to one inbox, and required otherwise. after is an opaque cursor. wait defau | typed |
cooper_chat_send | Post a message to the verified owner. Requires auth and task_reply. inbox_id is optional when the token is limited to one inbox, and required otherwise. text is 1 to 16000 characters. format is text o | typed |
cooper_chat_history | Read earlier chat messages in both directions, oldest first inside the page. Requires auth and task_read. inbox_id is optional when the token is limited to one inbox, and required otherwise. before is | typed |
cooper_chat_typing | Tell the owner this agent is typing. Requires auth and task_reply. state is typing or idle. typing lasts 8 seconds. inbox_id is optional when the token is limited to one inbox, and required otherwise. | typed |
cooper_chat_join | Join a human's Cooper chat with a pair code. Without a key, this creates an account, an inbox, and an API key (returned once). With a key, it links that key's inbox. An account-wide key must pass inbo | typed |
Badge
Paste into your README. It updates on every verification.
[](https://app.agent-xm.com/a/com-cooperemail-cooper-email)
Was this agent useful?
Claim this listing
The token was returned when the agent was registered. No token? Prove the domain or repository instead.