# ASIN Data API — how to use (mcp.ai)

Connect your ASIN Data API account and use 6 tools for ecommerce straight from your AI agent. Connect with your own API key. ASIN Data API provides detailed product data from Amazon, including price, rank, reviews, and more, enabling real-time insights for e-commerce professionals, marketers, and data analysts.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_asin_data_api?ms=1787295720000`
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. `asin_data_api_clear_collection_requests`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/asin_data_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/asin_data_api/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/asin_data_api/clear/collection/requests` — Delete multiple requests from a collection by their IDs using the bulk delete endpoint. Use this tool when you need to remove a selected set of request entries from an existing collection. Note: Reque
  - body: { request_ids: string[], collection_id: string }
- `POST https://api.mcp.ai/api/asin_data_api/delete/destination` — Delete a destination from your account. Use this when you need to remove a destination that is no longer needed.
  - body: { destination_id: string }
- `POST https://api.mcp.ai/api/asin_data_api/get/collection` — Get details of a specific collection including status and request counts. Use when you need to check collection configuration, operational status, or aggregate statistics.
  - body: { collection_id: string }
- `POST https://api.mcp.ai/api/asin_data_api/list/collection/requests` — List all requests in a Collection (paginated). Use to retrieve and paginate through all requests added to a specific collection. Returns up to 1000 requests per page with pagination info.
  - body: { page?: integer, collection_id: string }
- `POST https://api.mcp.ai/api/asin_data_api/list/destinations` — List all destinations configured on your account. Use to retrieve and filter destination configurations for data export. Maximum 50 destinations allowed per account. Returns 10 destinations per page w
  - body: { page?: integer, sort_by?: string, search_term?: string, sort_direction?: string }
- `POST https://api.mcp.ai/api/asin_data_api/update/destination` — Update an existing destination's configuration. Use to modify cloud storage settings, change the destination name, or enable/disable a destination. Only include fields you want to update.
  - body: { name?: string, enabled?: boolean, 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 ASIN Data API?"
- "Show me a summary of my ASIN Data API account"

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