Benchmark Email MCP by usefulapi is an MCP server published by io.usefulapi, hosted at benchmark-email.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 25 tools, including benchmark_get_account, benchmark_get_plan, benchmark_get_settings, benchmark_list_lists, benchmark_get_list.
Manage Benchmark Email lists and contacts, and read campaign reports: opens, clicks, bounces.
4,299 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
The Benchmark Email account this token belongs to: client id, name, company, email, status, plan products, contact count and emails sent. GET /Client/ProfileDetails.
No parameters.
{
"name": "benchmark_get_account",
"title": "Get account",
"description": "The Benchmark Email account this token belongs to: client id, name, company, email, status, plan products, contact count and emails sent. GET /Client/ProfileDetails.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get account",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
The account's email plan, add-ons and contact usage (active, account and total contacts, percent used). GET /Client/Plan.
No parameters.
{
"name": "benchmark_get_plan",
"title": "Get plan and usage",
"description": "The account's email plan, add-ons and contact usage (active, account and total contacts, percent used). GET /Client/Plan.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get plan and usage",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
No parameters.
{
"name": "benchmark_get_settings",
"title": "Get account settings",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get account settings",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List contact lists with id, name, description, contact count and dates. Use the ids with the contact tools. GET /Contact/.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| search | string | Only lists whose name matches this text. |
| order_by | string | Sort column as the vendor documents it: date, count, email or schedule. |
| page_size | integer | Results per page, 1-100 (default 25). |
| sort_order | string | Sort order. |
{
"name": "benchmark_list_lists",
"title": "List contact lists",
"description": "List contact lists with id, name, description, contact count and dates. Use the ids with the contact tools. GET /Contact/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"search": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only lists whose name matches this text."
},
"order_by": {
"type": "string",
"maxLength": 50,
"minLength": 1,
"description": "Sort column as the vendor documents it: date, count, email or schedule."
},
"page_size": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"sort_order": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort order."
}
}
},
"annotations": {
"title": "List contact lists",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One contact list: name, description, active contact count and its custom field names (Field1Name ...). GET /Contact/{list_id}.
| Parameter | Type | Description |
|---|---|---|
| list_id * | string | Contact list id (digits only, as returned by the list tools). |
{
"name": "benchmark_get_list",
"title": "Get contact list",
"description": "One contact list: name, description, active contact count and its custom field names (Field1Name ...). GET /Contact/{list_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"list_id": {
"type": "string",
"pattern": "^\\d{1,19}$",
"description": "Contact list id (digits only, as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get contact list",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The column names of a contact list (email, firstname, lastname and the custom fields). GET /Contact/{list_id}/Fields.
| Parameter | Type | Description |
|---|---|---|
| list_id * | string | Contact list id (digits only, as returned by the list tools). |
{
"name": "benchmark_get_list_fields",
"title": "Get contact list fields",
"description": "The column names of a contact list (email, firstname, lastname and the custom fields). GET /Contact/{list_id}/Fields.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"list_id": {
"type": "string",
"pattern": "^\\d{1,19}$",
"description": "Contact list id (digits only, as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get contact list fields",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE: create an empty contact list. POST /Contact/.
| Parameter | Type | Description |
|---|---|---|
| name * | string | List name. |
| description | string | List description. |
{
"name": "benchmark_create_list",
"title": "Create contact list",
"description": "WRITE: create an empty contact list. POST /Contact/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "List name."
},
"description": {
"type": "string",
"maxLength": 500,
"description": "List description."
}
}
},
"annotations": {
"title": "Create contact list",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}List the saved segments (filtered subsets of lists) with id and name. GET /Contact/Segments.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| page_size | integer | Results per page, 1-100 (default 25). |
{
"name": "benchmark_list_segments",
"title": "List segments",
"description": "List the saved segments (filtered subsets of lists) with id and name. GET /Contact/Segments.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"page_size": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List segments",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| search | string | Search text. |
| status | string | Only contacts with this status (subscribed = all except unsubscribed and hard bounced). |
| list_id * | string | Contact list id (digits only, as returned by the list tools). |
| order_by | string | Sort column. |
| page_size | integer | Results per page, 1-100 (default 25). |
| sort_order | string | Sort order. |
| search_type | string | How `search` matches (default: the vendor's default). |
| search_field | string | Column to search, e.g. email, firstname, lastname. |
{
"name": "benchmark_list_contacts",
"title": "List contacts in a list",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"search": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Search text."
},
"status": {
"enum": [
"subscribed",
"unsubscribed",
"hard_bounced"
],
"type": "string",
"description": "Only contacts with this status (subscribed = all except unsubscribed and hard bounced)."
},
"list_id": {
"type": "string",
"pattern": "^\\d{1,19}$",
"description": "Contact list id (digits only, as returned by the list tools)."
},
"order_by": {
"enum": [
"email",
"firstname",
"lastname",
"date"
],
"type": "string",
"description": "Sort column."
},
"page_size": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"sort_order": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort order."
},
"search_type": {
"enum": [
"starts_with",
"exact",
"contains",
"ends_with"
],
"type": "string",
"description": "How `search` matches (default: the vendor's default)."
},
"search_field": {
"type": "string",
"maxLength": 50,
"minLength": 1,
"description": "Column to search, e.g. email, firstname, lastname."
}
}
},
"annotations": {
"title": "List contacts in a list",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One contact of a list with all its fields (Field1 ... Field24 hold the custom columns). GET /Contact/{list_id}/ContactDetails/{contact_id}.
| Parameter | Type | Description |
|---|---|---|
| list_id * | string | Contact list id (digits only, as returned by the list tools). |
| contact_id * | string | Contact id (the ID of a list or search row) (digits only, as returned by the list tools). |
{
"name": "benchmark_get_contact",
"title": "Get contact",
"description": "One contact of a list with all its fields (Field1 ... Field24 hold the custom columns). GET /Contact/{list_id}/ContactDetails/{contact_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id",
"contact_id"
],
"properties": {
"list_id": {
"type": "string",
"pattern": "^\\d{1,19}$",
"description": "Contact list id (digits only, as returned by the list tools)."
},
"contact_id": {
"type": "string",
"pattern": "^\\d{1,19}$",
"description": "Contact id (the ID of a list or search row) (digits only, as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get contact",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| email * | string | Email address to search for. |
{
"name": "benchmark_search_contacts",
"title": "Search contacts by email",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"maxLength": 320,
"minLength": 1,
"description": "Email address to search for."
}
}
},
"annotations": {
"title": "Search contacts by email",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| email * | string | Email address. |
| list_id * | string | Contact list id (digits only, as returned by the list tools). |
| last_name | string | Last name. |
| first_name | string | First name. |
| permission | boolean | Set true only if the person has given email permission (EmailPerm 1). |
| middle_name | string | Middle name. |
| custom_fields | object | Custom list columns by slot, e.g. {"Field1": "12 High St"}. Slot names come from benchmark_get_list (Field1Name ...). |
{
"name": "benchmark_add_contact",
"title": "Add contact to a list",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id",
"email"
],
"properties": {
"email": {
"type": "string",
"pattern": "^[^\\s@]+@[^\\s@]+$",
"maxLength": 320,
"minLength": 3,
"description": "Email address."
},
"list_id": {
"type": "string",
"pattern": "^\\d{1,19}$",
"description": "Contact list id (digits only, as returned by the list tools)."
},
"last_name": {
"type": "string",
"maxLength": 200,
"description": "Last name."
},
"first_name": {
"type": "string",
"maxLength": 200,
"description": "First name."
},
"permission": {
"type": "boolean",
"description": "Set true only if the person has given email permission (EmailPerm 1)."
},
"middle_name": {
"type": "string",
"maxLength": 200,
"description": "Middle name."
},
"custom_fields": {
"type": "object",
"description": "Custom list columns by slot, e.g. {\"Field1\": \"12 High St\"}. Slot names come from benchmark_get_list (Field1Name ...).",
"propertyNames": {
"type": "string",
"pattern": "^Field([1-9]|1\\d|2[0-4])$"
},
"additionalProperties": {
"type": "string",
"maxLength": 2000
}
}
}
},
"annotations": {
"title": "Add contact to a list",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE: change fields of one contact in one list. Only the fields you pass are sent. PATCH /Contact/{list_id}/ContactDetails/{contact_id}.
| Parameter | Type | Description |
|---|---|---|
| string | Email address. | |
| list_id * | string | Contact list id (digits only, as returned by the list tools). |
| last_name | string | Last name. |
| contact_id * | string | Contact id (digits only, as returned by the list tools). |
| first_name | string | First name. |
| middle_name | string | Middle name. |
| custom_fields | object | Custom list columns by slot, e.g. {"Field1": "12 High St"}. Slot names come from benchmark_get_list (Field1Name ...). |
{
"name": "benchmark_update_contact",
"title": "Update contact",
"description": "WRITE: change fields of one contact in one list. Only the fields you pass are sent. PATCH /Contact/{list_id}/ContactDetails/{contact_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id",
"contact_id"
],
"properties": {
"email": {
"type": "string",
"pattern": "^[^\\s@]+@[^\\s@]+$",
"maxLength": 320,
"minLength": 3,
"description": "Email address."
},
"list_id": {
"type": "string",
"pattern": "^\\d{1,19}$",
"description": "Contact list id (digits only, as returned by the list tools)."
},
"last_name": {
"type": "string",
"maxLength": 200,
"description": "Last name."
},
"contact_id": {
"type": "string",
"pattern": "^\\d{1,19}$",
"description": "Contact id (digits only, as returned by the list tools)."
},
"first_name": {
"type": "string",
"maxLength": 200,
"description": "First name."
},
"middle_name": {
"type": "string",
"maxLength": 200,
"description": "Middle name."
},
"custom_fields": {
"type": "object",
"description": "Custom list columns by slot, e.g. {\"Field1\": \"12 High St\"}. Slot names come from benchmark_get_list (Field1Name ...).",
"propertyNames": {
"type": "string",
"pattern": "^Field([1-9]|1\\d|2[0-4])$"
},
"additionalProperties": {
"type": "string",
"maxLength": 2000
}
}
}
},
"annotations": {
"title": "Update contact",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| list_id * | string | Contact list id (digits only, as returned by the list tools). |
| contact_id * | string | Contact id (digits only, as returned by the list tools). |
{
"name": "benchmark_unsubscribe_contact",
"title": "Unsubscribe contact",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"list_id",
"contact_id"
],
"properties": {
"list_id": {
"type": "string",
"pattern": "^\\d{1,19}$",
"description": "Contact list id (digits only, as returned by the list tools)."
},
"contact_id": {
"type": "string",
"pattern": "^\\d{1,19}$",
"description": "Contact id (digits only, as returned by the list tools)."
}
}
},
"annotations": {
"title": "Unsubscribe contact",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}List email campaigns with id, name, subject, type, status, dates and target lists. GET /Emails/.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| search | string | Only emails whose name matches this text. |
| status | string | Status filter as the vendor spells it (e.g. Draft, Scheduled, Sent). |
| order_by | string | Sort column, e.g. date, name. |
| page_size | integer | Results per page, 1-100 (default 25). |
| sort_order | string | Sort order. |
{
"name": "benchmark_list_emails",
"title": "List emails (campaigns)",
"description": "List email campaigns with id, name, subject, type, status, dates and target lists. GET /Emails/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"search": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only emails whose name matches this text."
},
"status": {
"type": "string",
"maxLength": 50,
"minLength": 1,
"description": "Status filter as the vendor spells it (e.g. Draft, Scheduled, Sent)."
},
"order_by": {
"type": "string",
"maxLength": 50,
"minLength": 1,
"description": "Sort column, e.g. date, name."
},
"page_size": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"sort_order": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort order."
}
}
},
"annotations": {
"title": "List emails",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One email campaign: subject, sender, target and excluded lists, dates and settings. GET /Emails/{email_id}.
| Parameter | Type | Description |
|---|---|---|
| email_id * | string | Email id (digits only, as returned by the list tools). |
{
"name": "benchmark_get_email",
"title": "Get email (campaign)",
"description": "One email campaign: subject, sender, target and excluded lists, dates and settings. GET /Emails/{email_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"email_id"
],
"properties": {
"email_id": {
"type": "string",
"pattern": "^\\d{1,19}$",
"description": "Email id (digits only, as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get email",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Report summaries of sent emails: sends, opens, clicks, bounces, unsubscribes and complaints per campaign. GET /Emails/Report.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| search | string | Only emails whose name matches this text. |
| page_size | integer | Results per page, 1-100 (default 25). |
| sort_order | string | Sort order. |
{
"name": "benchmark_list_email_reports",
"title": "List email report summaries",
"description": "Report summaries of sent emails: sends, opens, clicks, bounces, unsubscribes and complaints per campaign. GET /Emails/Report.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"search": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only emails whose name matches this text."
},
"page_size": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"sort_order": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort order."
}
}
},
"annotations": {
"title": "List email report summaries",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The report summary of one email: recipients, opens, clicks, bounces, unsubscribes, forwards, complaints and rates. GET /Emails/{email_id}/Report.
| Parameter | Type | Description |
|---|---|---|
| email_id * | string | Email id (digits only, as returned by the list tools). |
{
"name": "benchmark_get_email_report",
"title": "Get email report",
"description": "The report summary of one email: recipients, opens, clicks, bounces, unsubscribes, forwards, complaints and rates. GET /Emails/{email_id}/Report.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"email_id"
],
"properties": {
"email_id": {
"type": "string",
"pattern": "^\\d{1,19}$",
"description": "Email id (digits only, as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get email report",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Who opened an email: contact, email address, time and device. GET /Emails/{email_id}/Report/Opens.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| email_id * | string | Email id (digits only, as returned by the list tools). |
| page_size | integer | Results per page, 1-100 (default 25). |
{
"name": "benchmark_get_email_opens",
"title": "Get email opens",
"description": "Who opened an email: contact, email address, time and device. GET /Emails/{email_id}/Report/Opens.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"email_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"email_id": {
"type": "string",
"pattern": "^\\d{1,19}$",
"description": "Email id (digits only, as returned by the list tools)."
},
"page_size": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get email opens",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Who clicked a link in an email: contact, email address and time. GET /Emails/{email_id}/Report/Clicks.
| Parameter | Type | Description |
|---|---|---|
| email_id * | string | Email id (digits only, as returned by the list tools). |
{
"name": "benchmark_get_email_clicks",
"title": "Get email clicks",
"description": "Who clicked a link in an email: contact, email address and time. GET /Emails/{email_id}/Report/Clicks.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"email_id"
],
"properties": {
"email_id": {
"type": "string",
"pattern": "^\\d{1,19}$",
"description": "Email id (digits only, as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get email clicks",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Which addresses bounced for an email: contact, email address, time and bounce type. GET /Emails/{email_id}/Report/Bounces.
| Parameter | Type | Description |
|---|---|---|
| email_id * | string | Email id (digits only, as returned by the list tools). |
{
"name": "benchmark_get_email_bounces",
"title": "Get email bounces",
"description": "Which addresses bounced for an email: contact, email address, time and bounce type. GET /Emails/{email_id}/Report/Bounces.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"email_id"
],
"properties": {
"email_id": {
"type": "string",
"pattern": "^\\d{1,19}$",
"description": "Email id (digits only, as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get email bounces",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Who unsubscribed after an email: contact, email address, time and reason, with a count per reason. GET /Emails/{email_id}/Report/Unsubscribes.
| Parameter | Type | Description |
|---|---|---|
| email_id * | string | Email id (digits only, as returned by the list tools). |
{
"name": "benchmark_get_email_unsubscribes",
"title": "Get email unsubscribes",
"description": "Who unsubscribed after an email: contact, email address, time and reason, with a count per reason. GET /Emails/{email_id}/Report/Unsubscribes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"email_id"
],
"properties": {
"email_id": {
"type": "string",
"pattern": "^\\d{1,19}$",
"description": "Email id (digits only, as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get email unsubscribes",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List signup forms with id, name, date and the lists they feed. GET /SignupForm/.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| search | string | Only forms whose name matches this text. |
| order_by | string | Sort column. |
| page_size | integer | Results per page, 1-100 (default 25). |
| sort_order | string | Sort order. |
{
"name": "benchmark_list_signup_forms",
"title": "List signup forms",
"description": "List signup forms with id, name, date and the lists they feed. GET /SignupForm/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"search": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only forms whose name matches this text."
},
"order_by": {
"enum": [
"name",
"date",
"size"
],
"type": "string",
"description": "Sort column."
},
"page_size": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"sort_order": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort order."
}
}
},
"annotations": {
"title": "List signup forms",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One signup form with its settings and target lists. GET /SignupForm/{form_id}.
| Parameter | Type | Description |
|---|---|---|
| form_id * | string | Signup form id (digits only, as returned by the list tools). |
{
"name": "benchmark_get_signup_form",
"title": "Get signup form",
"description": "One signup form with its settings and target lists. GET /SignupForm/{form_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form_id"
],
"properties": {
"form_id": {
"type": "string",
"pattern": "^\\d{1,19}$",
"description": "Signup form id (digits only, as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get signup form",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The public link of a signup form. GET /SignupForm/{form_id}/Link.
| Parameter | Type | Description |
|---|---|---|
| form_id * | string | Signup form id (digits only, as returned by the list tools). |
{
"name": "benchmark_get_signup_form_link",
"title": "Get signup form link",
"description": "The public link of a signup form. GET /SignupForm/{form_id}/Link.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form_id"
],
"properties": {
"form_id": {
"type": "string",
"pattern": "^\\d{1,19}$",
"description": "Signup form id (digits only, as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get signup form link",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Tools for Benchmark Email, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "How many contacts do I have on each email list?"; "How did my last email campaign do for opens and clicks?"; "Which email addresses bounced on my latest campaign?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Benchmark Email data. Free plan: 50 tool calls per month. Run benchmark_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run benchmark_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run benchmark_upgrade without a plan: it returns both plans, each with a payment link for the user to open. benchmark_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.