{"id":"io.usefulapi/emailchef","slug":"io-usefulapi-emailchef","title":"Emailchef MCP by usefulapi","description":"Read lists, contacts, campaign stats; add contacts; draft, schedule and send campaigns and SMS.","version":"1.9.4","publisher":{"kind":"domain","id":"usefulapi.io","label":"usefulapi.io","url":"https://usefulapi.io"},"website":"https://usefulapi.io/emailchef/","repository":"https://github.com/m190/usefulapi-mcp","remotes":[{"type":"streamable-http","url":"https://emailchef.usefulapi.io/mcp"}],"packages":[],"published":"2026-11-18","updated":"2026-11-18","status":"online","auth":"","latency_ms":1283,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"emailchef_get_account","title":"Get account","description":"The Emailchef account this API key belongs to: id, email, language, status, subscriber total, bounces and complaints. GET /accounts/current.","read_only":true},{"name":"emailchef_get_subscription","title":"Get subscription","description":"The account's current Emailchef plan: plan name, plan expiry, contact and send limits, credits left, active/expired flags. Check this before a big send. GET /subscriptions/current.","read_only":true},{"name":"emailchef_list_senders","title":"List senders","description":"List the sender identities (name, email, verification status, postal address). Campaigns and emails need a verified sender id. GET /senders.","read_only":true},{"name":"emailchef_list_timezones","title":"List timezones","description":"List Emailchef's timezones (id, name, fixed UTC offset). The id is required to schedule a campaign. GET /meta/timezones.","read_only":true},{"name":"emailchef_list_lists","title":"List contact lists","description":"List the contact lists with id, name, and counts of active, unsubscribed and bounced contacts and segments. Newest first by default. GET /lists.","read_only":true},{"name":"emailchef_get_list","title":"Get list","description":"One contact list: name, description, default sender, creation date. GET /lists/{list_id}.","read_only":true},{"name":"emailchef_get_list_stats","title":"Get list growth stats","description":"Daily growth of a list over a date range: total contacts per day and the daily delta. Omit the dates for the whole history. GET /lists/{list_id}/stats.","read_only":true},{"name":"emailchef_get_list_contact_counts","title":"Get list contact counts","description":"How many contacts a list has by state: active, unsubscribed, bounced, reported. GET /lists/{list_id}/stats/count.","read_only":true},{"name":"emailchef_create_list","title":"Create list","description":"WRITE: create a new, empty contact list. Returns the new list id. POST /lists.","read_only":false},{"name":"emailchef_update_list","title":"Update list","description":"WRITE: rename a contact list and/or change its description. Only the fields you pass change. PUT /lists/{list_id}.","read_only":false},{"name":"emailchef_list_contacts","title":"List contacts","description":"List the contacts of one list (id, email, name, added by, subscription date), optionally by state. GET /contacts?list_id=...","read_only":true},{"name":"emailchef_get_contact","title":"Get contact","description":"One contact in one list: status, email, name, IP, how it was added, when, and its custom field values. GET /contacts/{contact_id}?list_id=...","read_only":true},{"name":"emailchef_create_contact","title":"Add contact to a list","description":"WRITE: add a contact (email, name, custom fields) to a list. Only add people who agreed to receive email: an ACTIVE contact will receive the account's campaigns and automations. Returns the contact id and status. POST /contacts.","read_only":false},{"name":"emailchef_update_contact","title":"Update contact","description":"WRITE: change a contact's name, state or custom fields in one list. Only the fields you pass change. Setting the status to ACTIVE re-subscribes someone: only do so with their consent. PUT /contacts/{contact_id}.","read_only":false},{"name":"emailchef_unsubscribe_contact","title":"Unsubscribe contact","description":"WRITE: unsubscribe one contact from one list (it stops receiving that list's email). POST /lists/{list_id}/unsubscribe?contact_id=...","read_only":false},{"name":"emailchef_import_contacts","title":"Import contacts","description":"WRITE: bulk-add or update up to 500 contacts in a list in one call (an existing email is updated). Each contact is an object keyed by field placeholder, e.g. {\"email\":\"a@b.com\",\"firstname\":\"Ada\"}: get the placeholders from emailchef_list_predefined_fields and emailchef_list_custom_fields. Import only people who agreed to receive email. Runs in the background: poll emailchef_get_import_task with th","read_only":false},{"name":"emailchef_list_import_tasks","title":"List import tasks","description":"List contact import tasks: list, status (DISPATCHED, COMPLETE, FAILED), progress, imported/updated/failed counts. GET /importtasks.","read_only":true},{"name":"emailchef_get_import_task","title":"Get import task","description":"One import task: status, progress, imported/updated/failed counts and any error message. GET /importtasks/{task_id}.","read_only":true},{"name":"emailchef_list_predefined_fields","title":"List predefined fields","description":"The built-in contact fields (email, first name, ...) with their placeholders. GET /predefinedfields.","read_only":true},{"name":"emailchef_list_custom_fields","title":"List custom fields","description":"The custom contact fields of a list: name, data type, placeholder (the key used when writing contacts), options. GET /lists/{list_id}/customfields.","read_only":true},{"name":"emailchef_list_segments","title":"List segments","description":"List the saved segments of a list with how many contacts match each. GET /lists/{list_id}/segments.","read_only":true},{"name":"emailchef_get_segment","title":"Get segment","description":"One segment with its logic and condition groups. GET /lists/{list_id}/segments/{segment_id}.","read_only":true},{"name":"emailchef_list_blocked","title":"List blocked emails","description":"List the account's blocklist (emails that never receive email): address and reason (MANUAL, UNSUBSCRIBED, COMPLAINT). GET /blockings.","read_only":true},{"name":"emailchef_block_emails","title":"Block emails","description":"WRITE: add up to 100 addresses to the account blocklist so they never receive email from any list. Reversible with emailchef_unblock_email. POST /blockings?type=MANUAL.","read_only":false},{"name":"emailchef_unblock_email","title":"Unblock email","description":"WRITE: remove one address from the account blocklist so it can receive email again. Only do this for an address whose owner asked for it. DELETE /blockings/{email}.","read_only":false},{"name":"emailchef_get_campaign_counts","title":"Get campaign counts","description":"How many campaigns the account has by state: drafts, sent, scheduled, archived, failed. GET /campaigns/count.","read_only":true},{"name":"emailchef_list_campaigns","title":"List campaigns","description":"List email campaigns with state, recipients, delivered, unique opens and unique clicks. Without a status filter Emailchef returns only SENT and ARCHIVED campaigns; pass a status to see DRAFT, SCHEDULED, SENDING or FAILED ones. GET /campaigns.","read_only":true},{"name":"emailchef_get_campaign","title":"Get campaign","description":"One campaign: name, subject, HTML and text body, sender, reply-to, state, schedule, recipient lists/segments and cached sent/open/click counts. GET /campaigns/{id}.","read_only":true},{"name":"emailchef_get_campaign_links","title":"Get campaign links","description":"The links contained in a campaign (id, name, URL). GET /newsletters/{id}/links.","read_only":true},{"name":"emailchef_list_campaign_engagement","title":"List campaign engagement","description":"Per-contact engagement for a sent campaign: who opened, clicked, was delivered, did not open, unsubscribed, complained, or was sent to, with counts and first/last event time. Pick exactly one event. GET /newsletters/{id}/contacts.","read_only":true},{"name":"emailchef_create_campaign","title":"Create campaign (draft)","description":"WRITE: create a new campaign as a DRAFT (nothing is sent). Needs a verified sender (emailchef_list_senders) and at least one list. To be sendable the HTML body must contain the CAN-SPAM placeholders [[account:business]], [[account:address_1]], [[account:city]], [[account:postal_code]], [[account:country]] and an unsubscribe link <a href=\"[[unsubscribe_link]]\">, otherwise the send ends FAILED. Sche","read_only":false},{"name":"emailchef_clone_campaign","title":"Clone campaign","description":"WRITE: copy an existing campaign into a new DRAFT (nothing is sent). A SENT campaign cannot be cloned (Emailchef answers HTTP 500). Returns the new campaign id. POST /newsletters?clone=1.","read_only":false},{"name":"emailchef_update_campaign","title":"Update draft campaign","description":"WRITE: change a DRAFT campaign's name, subject, body, sender, reply-to or recipient lists. Only the fields you pass change: the tool reads the campaign first and sends the complete record back, because Emailchef blanks any omitted field. Refuses a campaign that is not a DRAFT. PUT /newsletters/{id}.","read_only":false},{"name":"emailchef_send_test_campaign","title":"Send campaign test email","description":"WRITE: email ONE test copy of a campaign to a single address. The campaign state does not change. The sender must be verified. PUT /campaigns/{id}/sendtest.","read_only":false},{"name":"emailchef_schedule_campaign","title":"Schedule campaign","description":"WRITE, SENDS EMAIL TO CUSTOMERS LATER: schedule a DRAFT campaign to go out to all its recipients at a date and time. Emailchef timezones are fixed offsets without daylight saving: pick the id (emailchef_list_timezones) whose offset matches the send date. Undo before it starts with emailchef_unschedule_campaign. PUT /campaigns/{id}/schedule.","read_only":false},{"name":"emailchef_unschedule_campaign","title":"Unschedule campaign","description":"WRITE: cancel the schedule of a SCHEDULED campaign and bring it back to DRAFT. PUT /campaigns/{id}/unschedule.","read_only":false},{"name":"emailchef_send_campaign","title":"Send campaign now","description":"WRITE, SENDS EMAIL TO CUSTOMERS NOW AND CANNOT BE UNDONE: start sending a DRAFT (or FAILED) campaign immediately to ALL its recipients and use up plan sends. Check the recipients (emailchef_get_campaign), the sender and the subscription first, ideally after emailchef_send_test_campaign, and send only with the user's explicit go-ahead (confirm must be true). Queued asynchronously: poll emailchef_ge","read_only":false},{"name":"emailchef_archive_campaign","title":"Archive campaign","description":"WRITE: archive a campaign (hidden from the default list; statistics are kept). Reversible with emailchef_unarchive_campaign. PUT /campaigns/{id}/archivecampaign.","read_only":false},{"name":"emailchef_unarchive_campaign","title":"Restore archived campaign","description":"WRITE: restore an archived campaign. PUT /campaigns/{id}/unarchivecampaign.","read_only":false},{"name":"emailchef_send_email","title":"Send one email","description":"WRITE, SENDS AN EMAIL NOW AND CANNOT BE UNDONE: send a single email to one recipient from a verified sender and use up plan sends. Pass text_body and/or html_body. The recipient does not need to be a contact. Send only with the user's explicit go-ahead (confirm must be true). POST /sendmail.","read_only":false},{"name":"emailchef_get_sms_balance","title":"Get SMS balance","description":"The account's SMS credit balance and currency. GET /sms/balance.","read_only":true},{"name":"emailchef_get_sms_status","title":"Get SMS status","description":"Delivery status of one sent SMS by message id: recipient, text, sent/done time, parts, price, state and error. GET /sms/status/{messageId}.","read_only":true},{"name":"emailchef_send_sms","title":"Send SMS","description":"WRITE, SENDS TEXT MESSAGES NOW, COSTS SMS CREDIT AND CANNOT BE UNDONE: send an SMS to 1-50 phone numbers in international format (e.g. +393331234567). Check emailchef_get_sms_balance first and send only with the user's explicit go-ahead (confirm must be true). Returns a message id per recipient and the remaining balance. POST /sms/send.","read_only":false}],"server_info":{"name":"emailchef-mcp","version":"1.9.4","title":"Emailchef MCP by usefulapi","websiteUrl":"https://usefulapi.io/emailchef/","icons":[{"src":"https://usefulapi.io/icon.svg","mimeType":"image/svg+xml","sizes":["any"]},{"src":"https://usefulapi.io/icon-256.png","mimeType":"image/png","sizes":["256x256"]}]},"category":"communication","tags":["marketing","productivity"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-31","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/io-usefulapi-emailchef/"}