Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| OPENAI_API_KEY | No | OpenAI API key for enhanced NLP | |
| ZAPMAIL_API_KEY | Yes | Your Zapmail API key | |
| ZAPMAIL_LOG_LEVEL | No | Logging level (DEBUG/INFO/WARN/ERROR) | INFO |
| ZAPMAIL_TIMEOUT_MS | No | Request timeout in milliseconds | 30000 |
| ZAPMAIL_MAX_RETRIES | No | Maximum retry attempts | 3 |
| ZAPMAIL_ENABLE_CACHE | No | Enable response caching | true |
| ZAPMAIL_WORKSPACE_KEY | No | Default workspace ID | |
| ZAPMAIL_ENABLE_METRICS | No | Enable performance metrics | true |
| ZAPMAIL_RATE_LIMIT_DELAY | No | Rate limiting delay in ms | 1000 |
| ZAPMAIL_SERVICE_PROVIDER | No | Email provider (GOOGLE/MICROSOFT) |
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| set_context | Set default x-workspace-key and x-service-provider headers for subsequent API calls. |
| wallet_balance | Return the current wallet balance for the active workspace. |
| list_workspaces | Retrieve all workspaces associated with the account. |
| list_domains | List domains in the active workspace. Use set_context to choose the workspace. |
| check_domain_availability | Check if a domain is available for registration and return pricing. |
| purchase_domains | Purchase one or more domains. Prefers wallet funds if sufficient; otherwise returns a payment link. |
| create_mailboxes_for_zero_domains | Create N mailboxes on every domain in the active workspace with zero mailboxes. |
| add_third_party_account | Add credentials for a third-party export integration. |
| call_endpoint | Invoke any Zapmail API endpoint by its documentation slug or an explicit path. |
| generate_usernames | Create professional mailbox usernames from a full name or single word using built-in patterns. |
| generate_name_pairs | Generate culturally appropriate firstname/lastname pairs for a given ethnicity and gender. |
| generate_domains | Generate professional domain name suggestions (local rules). |
| check_domain_availability_batch | Check availability and pricing for multiple domains at once. |
| plan_and_execute | Give a natural language instruction (e.g., 'buy 5 domains and connect Instantly') and the server will plan steps and optionally execute them. |
| get_metrics | Retrieve system metrics including API call statistics, cache performance, and error rates. |
| clear_cache | Clear all cached data to free memory and ensure fresh data retrieval. |
| health_check | Perform a comprehensive health check of the MCP server including API connectivity, cache status, and configuration validation. |
| bulk_update_mailboxes | Update multiple mailboxes with new names, usernames, or other properties in a single operation. |
| search_mailboxes | Search for mailboxes using various criteria like name, username, domain, or status. |
| get_server_info | Retrieve detailed information about the MCP server configuration, features, and capabilities. |
| get_export_info | Get comprehensive information about supported export platforms, flows, and scenarios. |
| get_export_scenario | Get step-by-step instructions for specific export scenarios. |
| validate_export_request | Validate export request parameters before execution to prevent errors. |
| export_guidance | Get AI-powered guidance for export operations including best practices and recommendations. |
| get_api_info | Get detailed information about API endpoints, parameters, responses, and usage examples. |
| search_api_endpoints | Search for API endpoints using keywords to find relevant functionality. |
| get_api_scenarios | Get step-by-step scenarios for common API operations and workflows. |
| get_api_best_practices | Get comprehensive best practices for using the Zapmail API effectively. |
| generate_api_examples | Generate practical examples for API endpoint usage with custom parameters. |
| zapmail_docs_825990m0 | API Docs Invoke this endpoint. |
| retrieve_user_details_13489341e0 | Use this endpoint to fetch details of the authenticated user, including their active plan, mailbox usage, and wallet balance. Invoke this endpoint. |
| retrieve_all_workspaces_13489896e0 | Use this endpoint to retrieve a list of all workspaces associated with the authenticated user. You can filter the results using pagination parameters and an optional search keyword. Invoke this endpoint. |
| create_new_workspace_13489947e0 | Use this endpoint to create a new workspace for your Zapmail account. Each workspace can hold domains, mailboxes, and user-specific settings. Workspace names must be unique per account. Invoke this endpoint. |
| update_workspace_13489975e0 | Use this endpoint to update an existing workspace’s name. Make sure the workspace ID is correct and that the new name does not conflict with another workspace in your account. Invoke this endpoint. |
| add_billing_details_13490005e0 | Use this endpoint to add billing information for a workspace. Billing details include the user’s name, company, address, and contact information. Invoke this endpoint. |
| _update_billing_details_13517578e0 | Use this endpoint to update billing information for a workspace. You can update the user’s name, company, address, and contact details. Invoke this endpoint. |
| retrieve_all_mailboxes_13490172e0 | This endpoint lets you fetch a list of all mailboxes. Invoke this endpoint. |
| get_mailbox_details_by_id_13490215e0 | Use this endpoint to retrieve the details of a specific mailbox by its ID. Invoke this endpoint. |
| assign_new_mailboxes_to_domains_13490321e0 | This endpoint allows you to assign new mailboxes to specific domains. Invoke this endpoint. |
| update_mailbox_13490429e0 | This endpoint allows updating mailbox details, including: Invoke this endpoint. |
| remove_mailboxes_on_next_renewal_13490521e0 | This endpoint allows you to schedule the removal of mailboxes on the next renewal. You can also cancel a previously scheduled removal. Invoke this endpoint. |
| get_authenticator_code_13648760e0 | This endpoint allows you to retrieve an authenticator code for a specific mailbox. The code can be used for authentication purposes and has a limited validity period. Invoke this endpoint. |
| remove_mailboxes_instantly_19455787e0 | This endpoint is used to instantly remove one or more mailboxes from the system. It supports bulk removal. Invoke this endpoint. |
| custom_oauth_23834066e0 |
|
| get_wallet_balance_13490707e0 | This endpoint retrieves the current wallet balance. Invoke this endpoint. |
| enable_auto_recharge_13490713e0 | This endpoint allows users to enable or disable auto-recharge for their wallet. Invoke this endpoint. |
| export_mailboxes_13490737e0 | This endpoint allows you to export mailboxes to a third-party application or as a CSV file. Invoke this endpoint. |
| add_third_party_account_details_13490752e0 | This endpoint allows you to add a third-party account where you want to export your mailboxes. Supported apps: Invoke this endpoint. |
| update_third_party_account_details_13490787e0 | This endpoint allows you to update an existing third-party account used for exporting mailboxes. Invoke this endpoint. |
| get_all_subscriptions_13489431e0 | Fetch all subscriptions associated with the authenticated user, including active, cancelled, and expired subscriptions, along with plan and billing details. Invoke this endpoint. |
| cancel_subscription_13489478e0 | Cancel a user subscription by providing its subscription ID. Invoke this endpoint. |
| upgrade_existing_subscription_13489501e0 | Upgrade an existing subscription by providing a new plan key and the subscription ID. Invoke this endpoint. |
| purchase_subscription_25771049e0 | This endpoint allows you to purchase a Zapmail subscription plan using your wallet balance. Payment is processed exclusively through your wallet, with automatic recharge if enabled. Invoke this endpoint. |
| retrieve_all_domains_13520015e0 | Retrieves a complete list of domains available in the system. Invoke this endpoint. |
| list_assignable_domains_13520727e0 | This endpoint provides a list of domains to which you can assign mailboxes. Invoke this endpoint. |
| add_dmarc_record_13520817e0 | This endpoint lets you add a DMARC record to one or more domains. Use contains, status and tagIds attribute to filter domains. Invoke this endpoint. |
| add_domain_forwarding_13520843e0 | Enables redirection from one or more registered domains to a specified destination domain. Invoke this endpoint. |
| get_name_servers_to_connect_domain_13520972e0 | Get nameservers Invoke this endpoint. |
| verify_name_server_propagation_13520984e0 | Verify Name Servers for Domain Connection with Zapmail Invoke this endpoint. |
| connect_domain_with_zapmail_13521006e0 | Connect Domain with Zapmail Invoke this endpoint. |
| enable_email_forwarding_13521023e0 | This api enables email forwarding for one or more registered domains. Email forwarding redirects all incoming emails sent to the target domain's mailboxes to a designated recipient address. Invoke this endpoint. |
| remove_email_forwarding_13521037e0 | Deactivate email forwarding for your domain, stopping the forwarding of emails from your domain to the specified email address. Invoke this endpoint. |
| enable_catch_all_emails_13521061e0 | Add catch-all email functionality for your domains, ensuring that any email sent to an undefined address under the domain is automatically forwarded to a specified recipient. Invoke this endpoint. |
| remove_catch_all_emails_13521079e0 | Remove catch-all email functionality for your domain, stopping the forwarding of all emails sent to any address at the domain. Invoke this endpoint. |
| check_dns_records_13521093e0 | Check DNS Records for Domain Invoke this endpoint. |
| remove_unused_domains_13521144e0 | This endpoint allows you to remove unused domains. Invoke this endpoint. |
| get_available_domains_for_registration_13521189e0 | This endpoint returns a list of domains that are available for registration, along with the exact match and a list of similar domains for a given set of TLDs and years of registration. Invoke this endpoint. |
| get_domains_purchase_payment_link_13521209e0 | Get the payment link for a list of domains or purchase domains via wallet. Invoke this endpoint. |
| get_domain_connection_requests_18247843e0 | This endpoint allows you to retrieve a list of domains that are still in progress and pending connection with Zapmail. Invoke this endpoint. |
| remove_domain_connection_requests_18247913e0 | Remove a domain connection request which is pending. Invoke this endpoint. |
| connect_domain_with_zapmail_new_18248433e0 | Use this endpoint to connect domain to Zapmail. Invoke this endpoint. |
| add_google_client_id_to_domain_19401086e0 | Associates a Google OAuth Client ID with one or more domain IDs for a specified application. Invoke this endpoint. |
| get_availability_of_multiple_domain_names_22701420e0 | This endpoint allows you to check the availability of up to 20 domain names in a single request. This is ideal for bulk domain searches, letting you quickly determine which domains are available for registration and their corresponding prices for the specified number of years. Invoke this endpoint. |
| retrieve_domain_health_score_25772162e0 | This endpoint provides a reputation score for your domain based on its nameserver reputation. This helps you monitor whether your domain's DNS infrastructure is on any abuse lists and assess the overall health of your domain. Invoke this endpoint. |
| retrieve_all_domains_with_filters_26049361e0 | Retrieves a complete list of domains available, with filters. Invoke this endpoint. |
| get_dns_records_13627177e0 | Fetch all DNS records for a domain associated with a user by providing the domain ID. Invoke this endpoint. |
| add_dns_records_13629231e0 | Add DNS Records for a given domain. Invoke this endpoint. |
| update_dns_records_13629370e0 | This endpoints lets you update dns records for a domain. Invoke this endpoint. |
| delete_dns_records_14109023e0 | Delete DNS Record API Invoke this endpoint. |
| get_available_domains_25772286e0 | Retrieve a list of available aged/high-reputation domains from the marketplace. These are premium pre-existing domains with established history, age, and quality metrics. Invoke this endpoint. |
| purchase_aged_domains_25772684e0 | Purchase one or more aged/high-reputation domains from the marketplace. Payment is automatically deducted from your wallet balance. Invoke this endpoint. |
| get_prewarmed_domains_25774188e0 | This endpoint retrieves available pre-warmed domains with their associated mailboxes. Pre-warmed domains are aged domains with warmed-up mailboxes that are ready for immediate use. Invoke this endpoint. |
| purchase_prewarmed_subscription_25774263e0 | This endpoint allows you to purchase a pre-warmed subscription plan using your wallet balance. Pre-warmed plans include aged domains with warmed-up mailboxes ready for immediate use, ensuring better email deliverability. Invoke this endpoint. |
| assign_prewarmed_mailboxes_25774338e0 | This endpoint assigns pre-warmed domains to fill available slots in your pre-warmed subscription. When you assign domains, their mailboxes are automatically transferred to your account. Invoke this endpoint. |
| get_subscriptions_25778521e0 | Retrieve all placement test subscriptions for the authenticated user. Returns both active and cancelled subscriptions, including Monthly recurring subscriptions and LTD (Lifetime Deal) plans. Invoke this endpoint. |
| get_overall_report_25778661e0 | Retrieve an overall summary of all placement test results. This endpoint aggregates data across all your placement tests, providing insights into email deliverability performance across different providers and mailboxes. Invoke this endpoint. |
| get_placement_test_orders_25779469e0 |
|
| get_eligible_mailboxes_for_placement_tests_25779778e0 | Retrieve a list of mailboxes eligible for placement testing. Allows filtering by status, tags, and search terms to find specific mailboxes. Invoke this endpoint. |
| get_available_placement_test_credits_25779804e0 | Retrieve information about available placement test credits (slots) across all active subscriptions. Returns total available credits, used credits, and breakdown by subscription. Invoke this endpoint. |
| purchase_placement_test_25780176e0 | Run placement tests on selected mailboxes. Supports two payment modes: Invoke this endpoint. |
| purchase_plan_25780426e0 | Purchase a placement test subscription plan (Monthly or LTD). Payment is automatically deducted from your wallet balance. Invoke this endpoint. |
| get_eligible_domains_25781361e0 | Retrieve a paginated list of domains that are eligible for DNS Shield protection. This endpoint helps you identify which of your domains can be protected with DNS Shield before making a purchase. Invoke this endpoint. |
| get_available_slots_25781438e0 | Check how many available DNS Shield slots you have across all your LTD (Lifetime Deal) subscriptions. This endpoint calculates the total available capacity by subtracting used slots from your total slots across all active LTD plans. Invoke this endpoint. |
| get_subscriptions_25781447e0 | Retrieve all DNS Shield subscriptions (both Monthly and LTD) for the authenticated user. This endpoint returns comprehensive details about each subscription including status, pricing, billing cycle, slot capacity, and usage. Invoke this endpoint. |
| get_allocated_domains_for_subscription_25781672e0 | Retrieve all domains that are currently allocated to a specific DNS Shield subscription. This endpoint provides detailed information about each domain including its status, mailboxes, and registration details. Invoke this endpoint. |
| allocate_domains_to_dns_shield_25781833e0 | Allocate domains to your DNS Shield LTD subscription slots and enable DNS Shield protection. This endpoint assigns specific domains to your available LTD plan capacity and automatically configures DNS Shield protection. Invoke this endpoint. |
| purchase_dns_shield_25782088e0 | Purchase a Lifetime Deal (LTD) DNS Shield plan with a one-time payment. LTD plans provide DNS Shield protection for a fixed number of domains without recurring monthly charges. Invoke this endpoint. |
| upgrade_dns_shield_ltd_plan_25782123e0 | Purchase a Lifetime Deal (LTD) DNS Shield plan with a one-time payment. LTD plans provide DNS Shield protection for a fixed number of domains without recurring monthly charges. Invoke this endpoint. |
| cancel_subscription_25783127e0 | Cancel a DNS Shield subscription immediately. This endpoint works for both Monthly recurring subscriptions and LTD (Lifetime Deal) plans. Invoke this endpoint. |
| domain_with_filter_10125073d0 | Invoke this endpoint. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| zapmail/llms | |
| zapmail/prompts/name_generation | |
| zapmail/prompts/pair_generation | |
| zapmail/prompts/gender_ethnicity_detection | |
| zapmail/prompts/domain_generation | |
| zapmail/examples/nl |