{
  "info": {
    "name": "Listclean — mcp.ai",
    "description": "REST API for the Listclean MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/listclean",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "listclean_create_bulk_verification_list",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/bulk/verification/list",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "bulk",
            "verification",
            "list"
          ]
        },
        "description": "Tool to create a CSV file with provided email addresses for bulk verification. Use when you need to generate a file for bulk upload through LISTCLEAN_UPLOAD_LIST.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"emails\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listclean_delete_list",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/list",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "list"
          ]
        },
        "description": "Tool to permanently delete a single list from the account. Use when you need to remove a list that is no longer needed.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"list_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listclean_download_csv",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/download/csv",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "download",
            "csv"
          ]
        },
        "description": "Tool to download list results as a CSV file. Use when you need to retrieve verification results filtered by email type (clean, dirty, or unknown).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"type\": \"\",\n  \"list_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listclean_download_json",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/download/json",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "download",
            "json"
          ]
        },
        "description": "Tool to download list results as JSON. Downloads emails filtered by type (clean, dirty, or unknown) in JSON format. Use after list verification is complete to retrieve filtered results.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"type\": \"\",\n  \"list_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listclean_get_account_profile",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/account/profile",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "account",
            "profile"
          ]
        },
        "description": "Tool to retrieve the authenticated account's profile. Use after obtaining a valid auth token to fetch user account data.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listclean_get_credits",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/credits",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "credits"
          ]
        },
        "description": "Tool to retrieve remaining verification credits. Use when you need to check your available account credits before performing more email verifications.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listclean_get_list",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/list",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "list"
          ]
        },
        "description": "Tool to retrieve detailed information for a specific list. Returns analytics with clean/dirty breakdown, cost details, and processing status.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"list_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listclean_get_upload_status",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/upload/status",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "upload",
            "status"
          ]
        },
        "description": "Tool to retrieve the status of a specific upload. Returns upload status (inprocess, success, error), progress percentage, and chunk details. Use after initiating an upload to track its completion.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"upload_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listclean_get_verification_logs",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/verification/logs",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "verification",
            "logs"
          ]
        },
        "description": "Tool to retrieve logs for all single email verifications. Returns history of email verifications with status, remarks, credits deducted, and timestamps.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"start\": 0,\n  \"length\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listclean_list_all",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/all",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "all"
          ]
        },
        "description": "Tool to retrieve all email verification lists. Returns all processed lists with complete analytics including clean/dirty counts, summary statistics, and cost information.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listclean_list_uploads",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/uploads",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "uploads"
          ]
        },
        "description": "Tool to retrieve the list of CSV uploads. Use when you need to check upload IDs, status, and progress for all CSV file uploads in your account.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"start\": 0,\n  \"length\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listclean_start_upload",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/start/upload",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "start",
            "upload"
          ]
        },
        "description": "Tool to start a CSV upload process for bulk email verification. Initializes chunked file upload and returns an upload_id for subsequent chunk uploads. Use when you need to upload large CSV files conta",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"filename\": \"\",\n  \"file_type\": \"\",\n  \"escape_char\": \"\",\n  \"fast_process\": 0,\n  \"enclosure_char\": \"\",\n  \"max_chunk_size\": 0,\n  \"separator_char\": \"\",\n  \"total_chunk_count\": 0,\n  \"email_column_index\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listclean_update_profile",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/profile",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "profile"
          ]
        },
        "description": "Tool to update account profile details. Use when you need to modify user profile information such as name, address, contact details, company information, or billing details.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"city\": \"\",\n  \"name\": \"\",\n  \"address\": \"\",\n  \"country\": \"\",\n  \"website\": \"\",\n  \"linkedin\": \"\",\n  \"skype_id\": \"\",\n  \"billing_name\": \"\",\n  \"company_name\": \"\",\n  \"phone_number\": \"\",\n  \"twitter_handle\": \"\",\n  \"billing_address\": \"\",\n  \"billing_company_name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listclean_upload_chunk",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/upload/chunk",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "upload",
            "chunk"
          ]
        },
        "description": "Tool to upload a chunk of a CSV file. Use when sending base64-encoded content with sequence number as part of chunked upload process, optionally with MD5 checksum for integrity verification.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"content\": \"\",\n  \"upload_id\": 0,\n  \"md5_checksum\": \"\",\n  \"chunk_sequence_number\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listclean_verify_batch",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/verify/batch",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "verify",
            "batch"
          ]
        },
        "description": "Tool to verify a batch of email addresses (max 3000 emails). Use when you need to verify multiple emails at once and get a list_id for tracking the batch verification request.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"emails\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listclean_verify_email",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/verify/email",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "verify",
            "email"
          ]
        },
        "description": "Tool to verify an email's validity. Use when you need to ensure an address is deliverable and non-disposable, after collecting a user's email.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"email\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}