Benchmark Email MCP by usefulapi
Server Details
Manage Benchmark Email lists and contacts, and read campaign reports: opens, clicks, bounces.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-06-18
- URL
- Repository
- m190/usefulapi-mcp
- GitHub Stars
- 0
TDQS
Score is being calculated.
Available Tools
25 toolsbenchmark_add_contactAdd contact to a listDestructiveInspect
WRITE: add one contact to a list (or update it if the email is already there, as the vendor decides). It does not send any email. Only add people who agreed to get email. POST /Contact/{list_id}/ContactDetails.
| Name | Required | Description | Default |
|---|---|---|---|
| Yes | Email address. | ||
| list_id | Yes | Contact list id (digits only, as returned by the list tools). | |
| last_name | No | Last name. | |
| first_name | No | First name. | |
| permission | No | Set true only if the person has given email permission (EmailPerm 1). | |
| middle_name | No | Middle name. | |
| custom_fields | No | Custom list columns by slot, e.g. {"Field1": "12 High St"}. Slot names come from benchmark_get_list (Field1Name ...). |
benchmark_create_listCreate contact listDestructiveInspect
WRITE: create an empty contact list. POST /Contact/.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | List name. | |
| description | No | List description. |
benchmark_get_accountGet accountRead-onlyInspect
The Benchmark Email account this token belongs to: client id, name, company, email, status, plan products, contact count and emails sent. GET /Client/ProfileDetails.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
benchmark_get_contactGet contactRead-onlyInspect
One contact of a list with all its fields (Field1 ... Field24 hold the custom columns). GET /Contact/{list_id}/ContactDetails/{contact_id}.
| Name | Required | Description | Default |
|---|---|---|---|
| list_id | Yes | Contact list id (digits only, as returned by the list tools). | |
| contact_id | Yes | Contact id (the ID of a list or search row) (digits only, as returned by the list tools). |
benchmark_get_emailGet email (campaign)Read-onlyInspect
One email campaign: subject, sender, target and excluded lists, dates and settings. GET /Emails/{email_id}.
| Name | Required | Description | Default |
|---|---|---|---|
| email_id | Yes | Email id (digits only, as returned by the list tools). |
benchmark_get_email_bouncesGet email bouncesRead-onlyInspect
Which addresses bounced for an email: contact, email address, time and bounce type. GET /Emails/{email_id}/Report/Bounces.
| Name | Required | Description | Default |
|---|---|---|---|
| email_id | Yes | Email id (digits only, as returned by the list tools). |
benchmark_get_email_clicksGet email clicksRead-onlyInspect
Who clicked a link in an email: contact, email address and time. GET /Emails/{email_id}/Report/Clicks.
| Name | Required | Description | Default |
|---|---|---|---|
| email_id | Yes | Email id (digits only, as returned by the list tools). |
benchmark_get_email_opensGet email opensRead-onlyInspect
Who opened an email: contact, email address, time and device. GET /Emails/{email_id}/Report/Opens.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, from 1 (default 1). Pass the previous reply's next_page. | |
| email_id | Yes | Email id (digits only, as returned by the list tools). | |
| page_size | No | Results per page, 1-100 (default 25). |
benchmark_get_email_reportGet email reportRead-onlyInspect
The report summary of one email: recipients, opens, clicks, bounces, unsubscribes, forwards, complaints and rates. GET /Emails/{email_id}/Report.
| Name | Required | Description | Default |
|---|---|---|---|
| email_id | Yes | Email id (digits only, as returned by the list tools). |
benchmark_get_email_unsubscribesGet email unsubscribesRead-onlyInspect
Who unsubscribed after an email: contact, email address, time and reason, with a count per reason. GET /Emails/{email_id}/Report/Unsubscribes.
| Name | Required | Description | Default |
|---|---|---|---|
| email_id | Yes | Email id (digits only, as returned by the list tools). |
benchmark_get_listGet contact listRead-onlyInspect
One contact list: name, description, active contact count and its custom field names (Field1Name ...). GET /Contact/{list_id}.
| Name | Required | Description | Default |
|---|---|---|---|
| list_id | Yes | Contact list id (digits only, as returned by the list tools). |
benchmark_get_list_fieldsGet contact list fieldsRead-onlyInspect
The column names of a contact list (email, firstname, lastname and the custom fields). GET /Contact/{list_id}/Fields.
| Name | Required | Description | Default |
|---|---|---|---|
| list_id | Yes | Contact list id (digits only, as returned by the list tools). |
benchmark_get_planGet plan and usageRead-onlyInspect
The account's email plan, add-ons and contact usage (active, account and total contacts, percent used). GET /Client/Plan.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
benchmark_get_settingsGet account settingsRead-onlyInspect
Default sender settings: from name and email, signature, footer, time zone, language and company address. The API token in the reply is removed. GET /Client/Setting.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
benchmark_get_signup_formGet signup formRead-onlyInspect
One signup form with its settings and target lists. GET /SignupForm/{form_id}.
| Name | Required | Description | Default |
|---|---|---|---|
| form_id | Yes | Signup form id (digits only, as returned by the list tools). |
benchmark_get_signup_form_linkGet signup form linkRead-onlyInspect
The public link of a signup form. GET /SignupForm/{form_id}/Link.
| Name | Required | Description | Default |
|---|---|---|---|
| form_id | Yes | Signup form id (digits only, as returned by the list tools). |
benchmark_list_contactsList contacts in a listRead-onlyInspect
List the contacts of one list with email, name, dates and id. Filter by status (subscribed, unsubscribed, hard_bounced) or search a column. GET /Contact/{list_id}/ContactDetails.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, from 1 (default 1). Pass the previous reply's next_page. | |
| search | No | Search text. | |
| status | No | Only contacts with this status (subscribed = all except unsubscribed and hard bounced). | |
| list_id | Yes | Contact list id (digits only, as returned by the list tools). | |
| order_by | No | Sort column. | |
| page_size | No | Results per page, 1-100 (default 25). | |
| sort_order | No | Sort order. | |
| search_type | No | How `search` matches (default: the vendor's default). | |
| search_field | No | Column to search, e.g. email, firstname, lastname. |
benchmark_list_email_reportsList email report summariesRead-onlyInspect
Report summaries of sent emails: sends, opens, clicks, bounces, unsubscribes and complaints per campaign. GET /Emails/Report.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, from 1 (default 1). Pass the previous reply's next_page. | |
| search | No | Only emails whose name matches this text. | |
| page_size | No | Results per page, 1-100 (default 25). | |
| sort_order | No | Sort order. |
benchmark_list_emailsList emails (campaigns)Read-onlyInspect
List email campaigns with id, name, subject, type, status, dates and target lists. GET /Emails/.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, from 1 (default 1). Pass the previous reply's next_page. | |
| search | No | Only emails whose name matches this text. | |
| status | No | Status filter as the vendor spells it (e.g. Draft, Scheduled, Sent). | |
| order_by | No | Sort column, e.g. date, name. | |
| page_size | No | Results per page, 1-100 (default 25). | |
| sort_order | No | Sort order. |
benchmark_list_listsList contact listsRead-onlyInspect
List contact lists with id, name, description, contact count and dates. Use the ids with the contact tools. GET /Contact/.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, from 1 (default 1). Pass the previous reply's next_page. | |
| search | No | Only lists whose name matches this text. | |
| order_by | No | Sort column as the vendor documents it: date, count, email or schedule. | |
| page_size | No | Results per page, 1-100 (default 25). | |
| sort_order | No | Sort order. |
benchmark_list_segmentsList segmentsRead-onlyInspect
List the saved segments (filtered subsets of lists) with id and name. GET /Contact/Segments.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, from 1 (default 1). Pass the previous reply's next_page. | |
| page_size | No | Results per page, 1-100 (default 25). |
benchmark_list_signup_formsList signup formsRead-onlyInspect
List signup forms with id, name, date and the lists they feed. GET /SignupForm/.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, from 1 (default 1). Pass the previous reply's next_page. | |
| search | No | Only forms whose name matches this text. | |
| order_by | No | Sort column. | |
| page_size | No | Results per page, 1-100 (default 25). | |
| sort_order | No | Sort order. |
benchmark_search_contactsSearch contacts by emailRead-onlyInspect
Find an email address across all lists: one row per list it is on, with the list name, contact id and master-unsubscribe flag. GET /Contact/ContactDetails.
| Name | Required | Description | Default |
|---|---|---|---|
| Yes | Email address to search for. |
benchmark_unsubscribe_contactUnsubscribe contactDestructiveIdempotentInspect
WRITE: move a contact to the Do Not Contact (master unsubscribe) list, so no campaign reaches it again. The API has no undo for this. DELETE /Contact/{list_id}/MoveToDNC/{contact_id}.
| Name | Required | Description | Default |
|---|---|---|---|
| list_id | Yes | Contact list id (digits only, as returned by the list tools). | |
| contact_id | Yes | Contact id (digits only, as returned by the list tools). |
benchmark_update_contactUpdate contactDestructiveIdempotentInspect
WRITE: change fields of one contact in one list. Only the fields you pass are sent. PATCH /Contact/{list_id}/ContactDetails/{contact_id}.
| Name | Required | Description | Default |
|---|---|---|---|
| No | Email address. | ||
| list_id | Yes | Contact list id (digits only, as returned by the list tools). | |
| last_name | No | Last name. | |
| contact_id | Yes | Contact id (digits only, as returned by the list tools). | |
| first_name | No | First name. | |
| middle_name | No | Middle name. | |
| custom_fields | No | Custom list columns by slot, e.g. {"Field1": "12 High St"}. Slot names come from benchmark_get_list (Field1Name ...). |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
25 tool updates
- First observed
benchmark_add_contact - First observed
benchmark_create_list - First observed
benchmark_get_account - First observed
benchmark_get_contact - First observed
benchmark_get_email - First observed
benchmark_get_email_bounces - First observed
benchmark_get_email_clicks - First observed
benchmark_get_email_opens - First observed
benchmark_get_email_report - First observed
benchmark_get_email_unsubscribes - First observed
benchmark_get_list - First observed
benchmark_get_list_fields - First observed
benchmark_get_plan - First observed
benchmark_get_settings - First observed
benchmark_get_signup_form - First observed
benchmark_get_signup_form_link - First observed
benchmark_list_contacts - First observed
benchmark_list_email_reports - First observed
benchmark_list_emails - First observed
benchmark_list_lists - First observed
benchmark_list_segments - First observed
benchmark_list_signup_forms - First observed
benchmark_search_contacts - First observed
benchmark_unsubscribe_contact - First observed
benchmark_update_contact
Related MCP Connectors
Manage lists, contacts and campaigns, and read campaign performance reports on EmailOctopus.
Read audiences, members, campaigns and reports; add, update, tag and archive subscribers.
Send email and read templates, marketing contacts, lists, stats, bounces and unsubscribes.
Manage Sendlane lists, contacts, tags and custom fields; read campaign and SMS reports.
1
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to manage mailing lists and contacts, read campaign reports with per-link clicks, and trigger automations. Supports lookups and updates by email address, tag and status management, and destructive operations with client confirmation.MIT
- AlicenseBqualityFmaintenanceProvides an interface to manage email marketing, contact lists, dynamic templates, and email analytics via SendGrid's API.21898 npm32ISC
- AlicenseNot gradedqualityBmaintenanceManage Mailchimp audiences, campaigns, and members via the Mailchimp Marketing API through natural language queries.72 npmMIT
- AlicenseAqualityCmaintenanceProvides read-only access to the Mailchimp Marketing API v3 via 18 tools covering 103 endpoints for audiences, members, campaigns, reports, automations, templates, landing pages, e-commerce, and account administration.18195 npmMIT
Glama MCP Gateway
Add one secure layer between your agents and this server.