# Countdown API — MCP server on mcp.ai
> Connect your Countdown API account and use 25 tools for ecommerce straight from your AI agent. Connect with your own API key. Countdown API provides real-time eBay product data, including product details, customer reviews, seller feedback, and search results, enabling businesses and developers to access comprehensive eBay marketplace information.

By: mcp.ai · official
Page: https://mcp.ai/countdown_api

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_countdown_api?ms=1787293740000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/countdown_api/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/countdown_api/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/countdown_api/skill.md
Postman collection (v2.1): https://mcp.ai/countdown_api/postman.json

## Tools
- countdown_api_clear_all_requests(collection_id: string) — Clears (removes) all pending requests from a collection. Use this to reset a collection before adding new requests, or to cancel all queued requests. The collection must be in 'idle' status. Returns t
- countdown_api_collections_create_collection(name: string, enabled?: boolean, priority?: string, requests_type?: string, schedule_type?: string, schedule_hours?: integer[], destination_ids?: string[], schedule_minutes?: string, notification_email?: string, notification_as_csv?: boolean, notification_as_json?: boolean, notification_webhook?: string, schedule_days_of_week?: integer[], schedule_days_of_month?: integer[], notification_csv_fields?: string, notification_as_jsonlines?: boolean) — Tool to create a new collection. Use when you need to batch and orchestrate multiple requests on a schedule.
- countdown_api_collections_get_collection(collection_id: string) — Tool to retrieve details for a single collection by ID. Use when you need collection metadata and counts for a given collection ID.
- countdown_api_collections_list_collections(page?: integer, status?: string, sort_by?: string, page_size?: integer, search_term?: string, search_type?: string, created_after?: string, created_before?: string, destination_id?: string, last_run_after?: string, sort_direction?: string, last_run_before?: string, only_with_results?: boolean, only_without_results?: boolean) — Tool to list all collections for the authenticated account. Use when you need to retrieve paginated collections with filtering, sorting, and timing constraints.
- countdown_api_collections_start_collection(collection_id: string) — Start processing a collection's queued requests on the Countdown API. Use this tool to manually trigger a collection to begin executing its requests. The collection must have at least one request adde
- countdown_api_collections_update_collection(name?: string, enabled?: boolean, priority?: string, collection_id: string, requests_type?: string, schedule_type?: string, schedule_hours?: integer[], destination_ids?: string[], schedule_minutes?: string, notification_email?: string, notification_as_csv?: boolean, notification_as_json?: boolean, notification_webhook?: string, schedule_days_of_week?: integer[], schedule_days_of_month?: integer[], notification_csv_fields?: string, notification_as_jsonlines?: boolean) — Update an existing collection's settings. Use this to modify collection properties like name, schedule, priority, notification settings, or enabled status. The collection_id must be obtained from list
- countdown_api_core_api_send_request(type?: string, ebay_domain?: string, search_term: string) — Tool to fetch eBay autocomplete suggestions. Use when needing search-term-based suggestions from Countdown API.
- countdown_api_create_collection_request(requests: object[], collection_id: string) — Tool to create new requests within a collection for bulk eBay data retrieval. Use when you need to add search, product, reviews, or other eBay data queries to a collection that will be executed on sch
- countdown_api_create_destination(name: string, type: string, enabled: boolean, s3_region?: string, s3_endpoint?: string, oss_region_id?: string, gcs_access_key?: string, gcs_secret_key?: string, oss_access_key?: string, oss_secret_key?: string, s3_bucket_name?: string, s3_path_prefix?: string, gcs_bucket_name?: string, gcs_path_prefix?: string, oss_bucket_name?: string, oss_path_prefix?: string, s3_access_key_id?: string, azure_account_key?: string, azure_path_prefix?: string, azure_account_name?: string, azure_container_name?: string, s3_secret_access_key?: string) — Creates a cloud storage destination where batch result sets will be automatically uploaded. Supports Amazon S3, S3-compatible services (MinIO, DigitalOcean Spaces), Google Cloud Storage, Microsoft Azu
- countdown_api_delete_collection(collection_id: string) — Tool to delete a collection and its configuration by ID. Use when you need to remove an existing, non-running collection.
- countdown_api_delete_destination(destination_id: string) — Tool to delete a destination by ID. Use when you need to remove an existing destination.
- countdown_api_delete_single_request(request_id: string, collection_id: string) — Delete a specific request from a Countdown API collection by its ID. Use this to remove individual requests that are no longer needed. The collection must not be running when deleting requests.
- countdown_api_destinations_list_destinations(page?: integer, sort_by?: string, search_term?: string, sort_direction?: string) — Tool to list all destinations configured for the account. Use when you need to inspect or paginate through configured destinations.
- countdown_api_find_collection_requests(q?: string, page?: integer, custom_id?: string, collection_id: string) — Tool to find requests in a collection by custom_id or search query. Use when you need to search for specific requests within a collection using either an exact custom_id match or a text search query.
- countdown_api_get_account() — Tool to retrieve account usage and current platform status. Use when needing to check plan, usage, and quota details for the authenticated user.
- countdown_api_list_error_logs(page?: integer, page_size?: integer) — Tool to list error logs from collection executions. Returns recent errors encountered during request processing with details about failed requests and their causes.
- countdown_api_requests_export_csv(collection_id: string) — Export all requests from a collection as downloadable CSV files. Returns URLs to CSV files containing the request data. Use this tool when you need to bulk export or download collection request data i
- countdown_api_requests_export_json(collection_id: string) — Tool to download all requests in a collection as JSON. Use when you need to export the entire request history for a collection.
- countdown_api_requests_update_single_request(body: object, request_id: string, collection_id: string) — Tool to modify parameters of an existing request in a collection. Use when the collection is not running and you need to update eBay Product Data API parameters.
- countdown_api_results_get_result_set(collection_id: string, result_set_id: integer) — Tool to retrieve a collection run's result set payload. Use after a collection run completes to fetch metadata and download links.
- countdown_api_results_list_result_sets(collection_id: string) — Tool to list result sets produced by a collection. Use when you need to retrieve all summary status of result sets generated by a collection within the 14-day retention window.
- countdown_api_results_resend_result_set_webhook(collection_id: string, result_set_id: integer) — Resend the webhook notification for a collection's result set. Use this tool to retry webhook delivery when the original webhook POST failed or timed out. The collection must have a notification_webho
- countdown_api_stop_all_collections() — Tool to stop all collections. Use when you need to halt any running or queued collections after reviewing operations.
- countdown_api_stop_collection(collection_id: string) — Tool to stop (pause) a single collection’s processing by ID. Use when you need to halt a running or queued collection after confirming the target collection ID.
- countdown_api_update_destination(name?: string, type?: string, enabled?: boolean, s3_region?: string, s3_endpoint?: string, oss_region_id?: string, destination_id: string, gcs_access_key?: string, gcs_secret_key?: string, oss_access_key?: string, oss_secret_key?: string, s3_bucket_name?: string, s3_path_prefix?: string, gcs_bucket_name?: string, gcs_path_prefix?: string, oss_bucket_name?: string, oss_path_prefix?: string, s3_access_key_id?: string, azure_account_key?: string, azure_path_prefix?: string, azure_account_name?: string, azure_container_name?: string, s3_secret_access_key?: string) — Tool to update a destination's configuration by ID. Use after creating or retrieving a destination to modify its settings.

## Example prompts
- "What can I do in Countdown API?"
- "Show me a summary of my Countdown API account"

## Links
Docs: https://mcp.ai/docs/mcps/countdown_api
Website: https://mcp.ai/mcps/countdown_api