{ "openapi": "3.0.4", "info": { "title": "Elastic Email MCP Server", "description": "OpenAPI style documentation describing Elastic Email MCP tools", "version": "v1" }, "paths": { "CreateCampaign": { "post": { "tags": [ "Campaign management" ], "description": "Creates and sends a new campaign. By default, the campaign status is set to active, and the campaign is sent immediately upon creation.To delay sending, set the status to paused.You can also create draft campaign and finish creation proccess later.", "operationId": "create_campaign", "requestBody": { "content": { "application/json": { "schema": { "required": [ "campaignData" ], "type": "object", "properties": { "campaignData": { "type": "object" } } } } } }, "responses": { } } }, "ListCampaigns": { "post": { "tags": [ "Campaign management" ], "description": "List existing campaigns", "operationId": "list_campaigns", "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { } } }, "GetCampaign": { "post": { "tags": [ "Campaign management" ], "description": "Get existing campaign", "operationId": "get_campaign", "requestBody": { "content": { "application/json": { "schema": { "required": [ "name" ], "type": "object", "properties": { "name": { "type": "string" } } } } } }, "responses": { } } }, "PauseCampaign": { "post": { "tags": [ "Campaign management" ], "description": "Pause selected capaign", "operationId": "pause_campaign", "requestBody": { "content": { "application/json": { "schema": { "required": [ "name" ], "type": "object", "properties": { "name": { "type": "string" } } } } } }, "responses": { } } }, "UpdateCampaign": { "post": { "tags": [ "Campaign management" ], "description": "Update selected capaign", "operationId": "update_campaign", "requestBody": { "content": { "application/json": { "schema": { "required": [ "campaignData" ], "type": "object", "properties": { "campaignData": { "type": "object" } } } } } }, "responses": { } } }, "GetCampaignStatistics": { "post": { "tags": [ "Statistics" ], "description": "Get campaign selected by name statistics", "operationId": "get_campaign_statistics", "requestBody": { "content": { "application/json": { "schema": { "required": [ "name" ], "type": "object", "properties": { "name": { "type": "string" } } } } } }, "responses": { } } }, "GetAllCampaignStatistics": { "post": { "tags": [ "Statistics" ], "description": "Get all campaigns statistics", "operationId": "get_all_campaign_statistics", "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { } } }, "FetchContacts": { "post": { "tags": [ "Contacts management" ], "description": "Fetch existing contacts. By default get 20 contacts but number may be changed.", "operationId": "fetch_contacts", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer", "format": "int32" } } } } } }, "responses": { } } }, "FetchContactHistory": { "post": { "tags": [ "Statistics" ], "description": "Get contact history by email address", "operationId": "fetch_contact_history", "requestBody": { "content": { "application/json": { "schema": { "required": [ "email" ], "type": "object", "properties": { "email": { "type": "string", "description": "Email address to search by" } } } } } }, "responses": { } } }, "FetchLists": { "post": { "tags": [ "Contacts management" ], "description": "Fetch existing lists", "operationId": "fetch_lists", "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { } } }, "FetchList": { "post": { "tags": [ "Contacts management" ], "description": "Get list by name", "operationId": "fetch_list", "requestBody": { "content": { "application/json": { "schema": { "required": [ "listName" ], "type": "object", "properties": { "listName": { "type": "string" } } } } } }, "responses": { } } }, "FetchListContacts": { "post": { "tags": [ "Contacts management" ], "description": "Get contacts from list by list name", "operationId": "fetch_list_contacts", "requestBody": { "content": { "application/json": { "schema": { "required": [ "listName" ], "type": "object", "properties": { "listName": { "type": "string" } } } } } }, "responses": { } } }, "AddContactsToList": { "post": { "tags": [ "Contacts management" ], "description": "Add contacts to existing list", "operationId": "add_contacts_to_list", "requestBody": { "content": { "application/json": { "schema": { "required": [ "listName", "emails" ], "type": "object", "properties": { "listName": { "type": "string" }, "emails": { "type": "object" } } } } } }, "responses": { } } }, "RemoveContactsFromList": { "post": { "tags": [ "Contacts management" ], "description": "Remove contacts from existing list. Provide rule or list of emails, never both in the same time.", "operationId": "remove_contacts_from_list", "requestBody": { "content": { "application/json": { "schema": { "required": [ "listName", "contacts", "rule" ], "type": "object", "properties": { "listName": { "type": "string" }, "contacts": { "type": "object" }, "rule": { "type": "string" } } } } } }, "responses": { } } }, "CreateList": { "post": { "tags": [ "Contacts management" ], "description": "Create new list with provided contacts", "operationId": "create_list", "requestBody": { "content": { "application/json": { "schema": { "required": [ "listName", "emails" ], "type": "object", "properties": { "listName": { "type": "string" }, "emails": { "type": "object" } } } } } }, "responses": { } } }, "AddContact": { "post": { "tags": [ "Contacts management" ], "description": "Add new simple contact", "operationId": "add_contact", "requestBody": { "content": { "application/json": { "schema": { "required": [ "email" ], "type": "object", "properties": { "email": { "type": "string" }, "firstName": { "type": "string" }, "lastName": { "type": "string" } } } } } }, "responses": { } } }, "DeleteContacts": { "post": { "tags": [ "Contacts management" ], "description": "Delete contact. Provide rule or list of emails, never both in the same time.", "operationId": "delete_contacts", "requestBody": { "content": { "application/json": { "schema": { "required": [ "contacts", "rule" ], "type": "object", "properties": { "contacts": { "type": "object" }, "rule": { "type": "string" } } } } } }, "responses": { } } }, "UploadContacts": { "post": { "tags": [ "Contacts management" ], "description": "Uploads/import contacts from file", "operationId": "upload_contacts", "requestBody": { "content": { "application/json": { "schema": { "required": [ "fileName", "base64Content", "listName" ], "type": "object", "properties": { "fileName": { "type": "string" }, "base64Content": { "type": "string" }, "listName": { "type": "string" } } } } } }, "responses": { } } }, "GetDomains": { "post": { "tags": [ "Domain management" ], "description": "List of all domains configured for this Account.", "operationId": "get_domains", "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { } } }, "GetDomain": { "post": { "tags": [ "Domain management" ], "description": "Retrieve a domain configured for this Account by name.", "operationId": "get_domain", "requestBody": { "content": { "application/json": { "schema": { "required": [ "domain" ], "type": "object", "properties": { "domain": { "type": "string" } } } } } }, "responses": { } } }, "AddDomain": { "post": { "tags": [ "Domain management" ], "description": "Add new domain to Account.", "operationId": "add_domain", "requestBody": { "content": { "application/json": { "schema": { "required": [ "payload" ], "type": "object", "properties": { "payload": { "type": "object" } } } } } }, "responses": { } } }, "SetDomainAsDefault": { "post": { "tags": [ "Domain management" ], "description": "Set domain as default.", "operationId": "set_domain_as_default", "requestBody": { "content": { "application/json": { "schema": { "required": [ "email" ], "type": "object", "properties": { "email": { "type": "string" } } } } } }, "responses": { } } }, "DeleteDomain": { "post": { "tags": [ "Domain management" ], "description": "Deletes configured domain from Account.", "operationId": "delete_domain", "requestBody": { "content": { "application/json": { "schema": { "required": [ "domain" ], "type": "object", "properties": { "domain": { "type": "string" } } } } } }, "responses": { } } }, "VerifyDomain": { "post": { "tags": [ "Domain management" ], "description": "Verifies that required DNS records exist for specified domain.", "operationId": "verify_domain", "requestBody": { "content": { "application/json": { "schema": { "required": [ "domain" ], "type": "object", "properties": { "domain": { "type": "string" } } } } } }, "responses": { } } }, "SendBulkEmails": { "post": { "tags": [ "Emails sending" ], "description": "Send bulk emails", "operationId": "send_bulk_emails", "requestBody": { "content": { "application/json": { "schema": { "required": [ "emailData" ], "type": "object", "properties": { "emailData": { "type": "object", "description": "Input email data: content, recipients list, subject. Use CC list only if user requires it." } } } } } }, "responses": { } } }, "SendTransactionalEmail": { "post": { "tags": [ "Emails sending" ], "description": "Send transactional email.\n Avoid putting all contacts in To field, rather send them separately.\n Use template if you want to send email with dynamic content.", "operationId": "send_transactional_email", "requestBody": { "content": { "application/json": { "schema": { "required": [ "data" ], "type": "object", "properties": { "data": { "type": "object", "description": "Input email data: content, recipients list, subject.\n Use CC field only if user requires it. Avoid putting all contacts in To or CC fields.\n Use template if you want to send email with dynamic content." } } } } } }, "responses": { } } }, "IsReady": { "post": { "tags": [ "MCP Tools" ], "description": "Check readiness and connectivity with MCP server and API", "operationId": "is_ready", "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { } } }, "CreateSegment": { "post": { "tags": [ "Contacts management" ], "description": "Create new segment", "operationId": "create_segment", "requestBody": { "content": { "application/json": { "schema": { "required": [ "segmentData" ], "type": "object", "properties": { "segmentData": { "type": "object" } } } } } }, "responses": { } } }, "GetSegments": { "post": { "tags": [ "Contacts management" ], "description": "Get existing segments", "operationId": "get_segments", "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { } } }, "GetSegment": { "post": { "tags": [ "Contacts management" ], "description": "Get existing segment by name", "operationId": "get_segment", "requestBody": { "content": { "application/json": { "schema": { "required": [ "name" ], "type": "object", "properties": { "name": { "type": "string" } } } } } }, "responses": { } } }, "FetchTemplate": { "post": { "tags": [ "Emails sending" ], "description": "Get template by name", "operationId": "fetch_template", "requestBody": { "content": { "application/json": { "schema": { "required": [ "name" ], "type": "object", "properties": { "name": { "type": "string" } } } } } }, "responses": { } } }, "FetchTemplates": { "post": { "tags": [ "Emails sending" ], "description": "Get email templates list", "operationId": "fetch_templates", "requestBody": { "content": { "application/json": { "schema": { "required": [ "scopes" ], "type": "object", "properties": { "scopes": { "type": "object" }, "templateTypes": { "type": "object" } } } } } }, "responses": { } } } }, "components": { } }