# ZeroBounce MCP server > Remote MCP server for ZeroBounce: email validation, email finding and bulk list cleaning for a ZeroBounce account. Connect any MCP client to https://mcp.zerobounce.net/mcp (Streamable HTTP). It signs in with OAuth 2.1, and the account owner picks the tools it may use on the ZeroBounce consent page. - No API key is configured in the client. On the first request the server answers 401 with a `resource_metadata` link; the client discovers OAuth from it, registers itself (any https callback, or http on loopback for local apps) and opens the browser to sign in. - Tools whose description says `CREDITS` spend the account's credits: call them only for addresses, names or domains the user gave. Call `get_credits` first when a request may need many. - For more than 100 addresses use `send_file`, then poll `file_status` and fetch results with `get_file`. - Limits per connection: 300 requests and 60 credit-spending tool calls per minute. A tool the connection was not granted returns an error asking the user to reconnect and allow it. ## Connect - [MCP endpoint](https://mcp.zerobounce.net/mcp): Streamable HTTP, OAuth bearer token - Claude Code: `claude mcp add --transport http zerobounce https://mcp.zerobounce.net/mcp` - Cursor, VS Code and other `mcp.json` clients: `{"mcpServers": {"zerobounce": {"url": "https://mcp.zerobounce.net/mcp"}}}` ## Discovery - [Server card](https://mcp.zerobounce.net/.well-known/mcp/server-card.json): name, version, endpoint and tools - [OAuth authorization server metadata](https://mcp.zerobounce.net/.well-known/oauth-authorization-server) - [OAuth protected resource metadata](https://mcp.zerobounce.net/.well-known/oauth-protected-resource/mcp) - [OpenAPI document](https://mcp.zerobounce.net/openapi.json): the HTTP routes (OAuth, MCP, consent API) ## Tools ### `mcp:read`: See credit balance, API usage, the status and results of bulk files, filters, and inbox placement tests - `get_credits`: Check remaining validation credits - `get_account_credits`: Same balance query as get_credits - `get_api_usage`: API usage totals between two dates - `file_status`: Bulk validation job status - `scoring_file_status`: Bulk scoring job status - `get_file`: Download bulk validation results - `scoring_get_file`: Download bulk scoring results - `email_finder_file_status`: Bulk email finder job status - `email_finder_get_file`: Download bulk email finder results - `domain_search_file_status`: Bulk domain search job status - `domain_search_get_file`: Download bulk domain search results - `get_list_evaluator_result`: List Evaluator progress and quality estimate - `list_filters`: See allow and block filters - `list_s3files`: List files in the connected Amazon S3 bucket - `get_inbox_placement_providers`: Inbox placement seed providers - `get_inbox_placement_test_types`: Inbox placement test types - `get_inbox_placement_test`: One inbox placement test's results - `list_inbox_placement_tests`: List inbox placement tests - `get_inbox_placement_webhook`: See the inbox placement webhook ### `mcp:credits`: Spend credits: validate and score emails, look up activity data, find emails and domains, and run inbox placement tests - `get_activity`: Activity signals for one email - `validate`: Validate a single email address - `validate_email`: Alias for single-email validation - `find_email_format`: Guess a work email from name and domain or company - `find_domain`: Discover a company domain - `score_email`: AI engagement score for one email ### `mcp:write`: Change account data: upload and delete bulk files, start S3/SFTP jobs, manage filters and inbox placement tests, and run batch email validation - `send_file`: Upload a CSV for bulk validation - `delete_file`: Delete a bulk validation file (deletes or changes data) - `scoring_send_file`: Upload a CSV for bulk scoring - `scoring_delete_file`: Delete a bulk scoring file (deletes or changes data) - `validate_batch`: Validate up to 100 emails in one call - `send_email_finder_file`: Upload a CSV to find emails in bulk - `email_finder_delete_file`: Delete a bulk email finder file (deletes or changes data) - `send_domain_search_file`: Upload a CSV to search domains in bulk - `domain_search_delete_file`: Delete a bulk domain search file (deletes or changes data) - `send_list_evaluator_file`: Upload a list to the List Evaluator (uses no credits) - `send_evaluated_file`: Validate a list the List Evaluator finished - `add_filter`: Add an allow or block filter - `delete_filter`: Delete an allow or block filter (deletes or changes data) - `validate_s3file`: Validate a file in Amazon S3 - `score_s3file`: Score a file in Amazon S3 - `email_finder_s3file`: Find emails for a file in Amazon S3 - `domain_search_s3file`: Search domains in a file in Amazon S3 - `validate_sftpfile`: Validate a file on SFTP/FTP - `score_sftpfile`: Score a file on SFTP/FTP - `email_finder_sftpfile`: Find emails for a file on SFTP/FTP - `domain_search_sftpfile`: Search domains in a file on SFTP/FTP - `export_s3file`: Export results to Amazon S3 - `export_sftpfile`: Export results to SFTP/FTP - `create_inbox_placement_test`: Create an inbox placement test - `delete_inbox_placement_test`: Delete an inbox placement test (deletes or changes data) ### `mcp:warmup`: Use the Warmup API with your team's Warmup API key: see sending accounts, seeds and statistics; with change permission, also add, update and delete warmup accounts and rules - `warmup_list_sending_accounts`: List warmup sending accounts - `warmup_get_sending_account`: One warmup sending account - `warmup_list_from_addresses`: Search warmup from-addresses - `warmup_get_engagement_rules`: Warmup engagement rule catalogue - `warmup_get_custom_engagement`: An address's custom engagement rule - `warmup_get_seeds`: Warmup seed mailboxes - `warmup_download_seeds`: Download the warmup seed list - `warmup_get_seed_count`: Number of warmup seeds - `warmup_get_progress_today`: Today's warmup progress - `warmup_get_sent_today`: Warmup emails sent today - `warmup_get_emails_per_day`: Daily warmup volume - `warmup_get_statistics`: Warmup statistics for an address - `warmup_get_statistics_per_day`: Daily warmup statistics for an address - `warmup_get_statistics_detailed`: Detailed warmup statistics - `warmup_download_statistics`: Download warmup statistics - `warmup_get_from_address_statistics`: Statistics for a warmup from-address - `warmup_check_domain_dmarc`: Check SPF, DKIM and DMARC for a domain - `warmup_add_sending_account`: Add a sending account to warmup - `warmup_update_sending_account`: Pause, resume or retune an address (deletes or changes data) - `warmup_change_from_address`: Move warmup to a new from-address (deletes or changes data) - `warmup_set_engagement_rule`: Set an address's engagement rule (deletes or changes data) - `warmup_create_custom_engagement`: Create a custom engagement rule - `warmup_update_custom_engagement`: Update a custom engagement rule (deletes or changes data) - `warmup_delete_sending_account`: Remove an address from warmup (deletes or changes data) - `warmup_delete_custom_engagement`: Delete a custom engagement rule (deletes or changes data) ## Optional - [ZeroBounce](https://www.zerobounce.net)