get_bulk_list_status
Get Bulk List Status
Check the processing status of a previously uploaded bulk email list. Returns the current status, total email count, and breakdown of clean/dirty/unknown results once processing is complete.
Ask your agent in plain language. Each of these maps to a real tool on the server.
get_bulk_list_status
Check the processing status of a previously uploaded bulk email list. Returns the current status, total email count, and breakdown of clean/dirty/unknown results once processing is complete.
download_bulk_results
Download the verification results for a completed bulk email list. Results can be filtered to return all emails, only clean (valid) emails, or only dirty (invalid) emails. The list must have a COMPLETED status before results can be downloaded.
verify_email
Verify a single email address in real time. Returns a provider status of clean, dirty, unknown, or error, together with the provider's explanation. Verification may consume account credits.
list_bulk_lists
Retrieve all bulk email verification lists associated with your account. Returns each list's ID, file name, status, and email counts.
get_account
Retrieve your Listclean account profile and remaining credit balance. Credits operate on a pay-as-you-go model and never expire.
upload_bulk_list
Upload a CSV or TXT file containing email addresses for bulk verification. The file must have an 'EMAIL' column header. After uploading, the list is processed asynchronously โ use the **Get Bulk List Status** tool to check progress.
get_verification_list
Retrieve a verification list by its ID from list_verification_lists or verify_email_batch. Poll until the provider status is COMPLETED before using download_list_results. The provider returns an array of matching records.
download_list_results
Download a CSV file of clean, dirty, or unknown addresses from a completed verification list. Get the list ID from list_verification_lists or verify_email_batch. Download each type separately to retrieve all results.
list_verification_lists
Retrieve verification lists with their provider list IDs, source filenames, and processing states. Use the list_id from a result with get_verification_list or download_list_results.
verify_email_batch
Submit up to 3,000 email addresses for asynchronous verification. Returns a list ID; use get_verification_list to check progress, then download_list_results when the list is COMPLETED.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Verify individual email addresses, submit email batches, inspect verification lists, download CSV results, and retrieve account profile and verification credit balance.
Common questions about connecting Listclean to AI agents with Metorial.