# Countdown API — how to use (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.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_countdown_api?ms=1787291460000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `countdown_api_clear_all_requests`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/countdown_api`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/countdown_api/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/countdown_api/clear/all/requests` — 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
  - body: { collection_id: string }
- `POST https://api.mcp.ai/api/countdown_api/collections/create/collection` — Tool to create a new collection. Use when you need to batch and orchestrate multiple requests on a schedule.
  - body: { 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 }
- `POST https://api.mcp.ai/api/countdown_api/collections/get/collection` — Tool to retrieve details for a single collection by ID. Use when you need collection metadata and counts for a given collection ID.
  - body: { collection_id: string }
- `POST https://api.mcp.ai/api/countdown_api/collections/list/collections` — Tool to list all collections for the authenticated account. Use when you need to retrieve paginated collections with filtering, sorting, and timing constraints.
  - body: { 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 }
- `POST https://api.mcp.ai/api/countdown_api/collections/start/collection` — 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
  - body: { collection_id: string }
- `POST https://api.mcp.ai/api/countdown_api/collections/update/collection` — 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
  - body: { 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 }
- `POST https://api.mcp.ai/api/countdown_api/core/api/send/request` — Tool to fetch eBay autocomplete suggestions. Use when needing search-term-based suggestions from Countdown API.
  - body: { type?: string, ebay_domain?: string, search_term: string }
- `POST https://api.mcp.ai/api/countdown_api/create/collection/request` — 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
  - body: { requests: object[], collection_id: string }
- `POST https://api.mcp.ai/api/countdown_api/create/destination` — 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
  - body: { 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 }
- `POST https://api.mcp.ai/api/countdown_api/delete/collection` — Tool to delete a collection and its configuration by ID. Use when you need to remove an existing, non-running collection.
  - body: { collection_id: string }
- `POST https://api.mcp.ai/api/countdown_api/delete/destination` — Tool to delete a destination by ID. Use when you need to remove an existing destination.
  - body: { destination_id: string }
- `POST https://api.mcp.ai/api/countdown_api/delete/single/request` — 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.
  - body: { request_id: string, collection_id: string }
- `POST https://api.mcp.ai/api/countdown_api/destinations/list/destinations` — Tool to list all destinations configured for the account. Use when you need to inspect or paginate through configured destinations.
  - body: { page?: integer, sort_by?: string, search_term?: string, sort_direction?: string }
- `POST https://api.mcp.ai/api/countdown_api/find/collection/requests` — 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.
  - body: { q?: string, page?: integer, custom_id?: string, collection_id: string }
- `POST https://api.mcp.ai/api/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.
- `POST https://api.mcp.ai/api/countdown_api/list/error/logs` — Tool to list error logs from collection executions. Returns recent errors encountered during request processing with details about failed requests and their causes.
  - body: { page?: integer, page_size?: integer }
- `POST https://api.mcp.ai/api/countdown_api/requests/export/csv` — 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
  - body: { collection_id: string }
- `POST https://api.mcp.ai/api/countdown_api/requests/export/json` — Tool to download all requests in a collection as JSON. Use when you need to export the entire request history for a collection.
  - body: { collection_id: string }
- `POST https://api.mcp.ai/api/countdown_api/requests/update/single/request` — 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.
  - body: { body: object, request_id: string, collection_id: string }
- `POST https://api.mcp.ai/api/countdown_api/results/get/result/set` — Tool to retrieve a collection run's result set payload. Use after a collection run completes to fetch metadata and download links.
  - body: { collection_id: string, result_set_id: integer }
- `POST https://api.mcp.ai/api/countdown_api/results/list/result/sets` — 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.
  - body: { collection_id: string }
- `POST https://api.mcp.ai/api/countdown_api/results/resend/result/set/webhook` — 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
  - body: { collection_id: string, result_set_id: integer }
- `POST https://api.mcp.ai/api/countdown_api/stop/all/collections` — Tool to stop all collections. Use when you need to halt any running or queued collections after reviewing operations.
- `POST https://api.mcp.ai/api/countdown_api/stop/collection` — 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.
  - body: { collection_id: string }
- `POST https://api.mcp.ai/api/countdown_api/update/destination` — Tool to update a destination's configuration by ID. Use after creating or retrieving a destination to modify its settings.
  - body: { 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 }

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

## More
- Page: https://mcp.ai/countdown_api
- Agent spec (llms.txt): https://mcp.ai/countdown_api/llms.txt
- Postman collection: https://mcp.ai/countdown_api/postman.json