メルカリ

Delete one or more saved listing drafts. Each draft is discarded and cannot be recovered by the seller. Up to 30 draft IDs in one call, which is the most drafts a seller can hold. This only removes drafts, which were never visible to buyers. It has no effect on a listing that is already live. The seller's remaining drafts come back with the result, so the outcome can be read off the response instead of being assumed. The marketplace does not distinguish a draft it deleted from one that was never there, so absence from that list is the only evidence a draft is gone. Confirm with the seller before calling this. Each draft's title, description, photos and price go with it.

Retrieve details for a previously saved draft listing by its ID.

Fetch detailed information about one or more Mercari products by their IDs. BATCH FETCHING: Provide multiple product IDs to fetch details for several products in a single request. Each product in the results array includes its own error field for partial failures. OPTIONAL DATA: By default, returns core product information (title, price, description, photos, condition, categories). Use optional parameters to include: * include_seller: Seller profile, ratings, sales history, quick shipper status * include_shipping: Shipping method, cost, origin area, delivery timeframe * include_comments: Public user comments and questions under the product listing RESPONSE: Returns a results array where each element corresponds to a requested product_id. EXAMPLES: * Single product: {"product_ids": ["m12345678901"]} * Batch with seller info: {"product_ids": ["m11111111111", "m22222222222"], "include_seller": true} * Full details: {"product_ids": ["m99999999999"], "include_seller": true, "include_shipping": true, "include_comments": true}

Returns the Mercari profile for the current connection.

Get data from MCP resources. Call with no arguments first to list the available resources.

List the seller's saved listing drafts. Each draft comes back as a slim summary: its ID, title, price, category and when it was last saved. A draft can be saved with almost nothing filled in, so any of those but the ID may be absent. This is the tool for finding a draft. To read one in full, including its description, photos and shipping terms, call get_listing_draft with the draft_id from a summary here.

Publish a saved draft as a live listing. The listing goes on sale immediately and is visible to buyers. The draft must already carry everything a listing needs: title, price, at least one photo, category, condition, shipping method and payer, shipping origin and shipping time. An incomplete draft is reported as an error and stays a draft, so nothing is lost. On success the draft is discarded. On failure the error says whether a listing may already exist. Do not publish again to find out, and do not build a new draft for the same item: either can put it on sale twice. Ask the seller to check their listings in the Mercari app, and discard the draft with delete_drafts once they confirm it is live. Confirm the title, price and shipping with the seller before calling this. The listing is visible to buyers from the moment it goes live.

Search Mercari JP marketplace for products using natural language queries with advanced parsing. Supports price filtering via operators, keyword exclusions, and color filters. Returns product array with id, title, price, condition, status, images, and metadata summary. KEYWORD USAGE: All keywords must match. Fewer words = broader results, more words = narrower results. * Broader: 'iPhone 13 Pro Max' -> 'iPhone 13' * Narrower: 'camera' -> 'vintage film camera' PRICE OPERATORS (in keyword): * '>=5000' = minimum price 5000 yen * '<=10000' = maximum price 10000 yen * '>=5000 <=10000' = price range EXCLUSIONS (in keyword): * '-broken -damaged' = exclude these terms from results COLORS: Standardized Mercari basic colors: black, white, red, blue, green, yellow, pink, purple, brown, gray, beige, navy, khaki, orange, gold, silver. Map similar colors to standards (burgundy->['red'], olive->['green', 'yellow'], ocean->['blue'], etc). Colors work as inclusion filter - results will include any of the colors from the array if filter is provided. PRODUCT URLS: If needed, construct URLs to product pages on Mercari website using product_id from results: * Normal items (product_id starts with 'm'): https://jp.mercari.com/item/{product_id} * Shops items (product_id doesn't start with 'm'): https://jp.mercari.com/shops/product/{product_id} EXAMPLES: * keyword='iPhone 13 >=30000 <=50000 -cracked -broken' * keyword='vintage camera', colors=['black','brown'], only_unused=true * keyword='Nintendo Switch', category_id=859, limit=20

Get a pre-signed upload URL for a listing image. Requirements: - Only JPEG format (.jpg, .jpeg extensions) allowed - Maximum 20 photos per listing - Maximum file size: 10MB (10485760 bytes) After calling this tool, you must: 1. Make an HTTP PUT request to upload_url with the image file binary data 2. Include ALL headers from the "headers" array (each has exact "key" and "value") The response includes a "headers" array with exact HTTP header names and values: - Each header has a "key" (exact HTTP header name, case-sensitive) and "value" - You must include ALL headers exactly as provided - Example headers: Content-Type, Content-Length, x-amz-acl, Cache-Control For AI agents with file access: Use your platform's HTTP client to make a PUT request. Iterate through the headers array and set each header[i].key = header[i].value in your HTTP request. Example pseudo-code: curl -v -X PUT -H "x-amz-acl: public-read" -H "Content-Length: $fileSizeInBytes" -H "Cache-Control: max-age=315360000" --upload-file $File_PATH $upload_url Note: This tool only provides the upload URL and headers. You must separately obtain the image file and upload it.

Create or update a listing draft. MODES: * CREATE: Omit draft_id to create new draft (title required, defaults applied) * UPDATE: Provide draft_id to update existing draft (partial updates supported) CONDITION IDS: * 1: New, unused * 2: Like new * 3: Good, no major damage * 4: Fair, some wear * 5: Poor, visible damage * 6: Bad overall condition SHIPPING PAYER IDS: * 1: Buyer pays * 2: Seller pays (default) SHIPPING DURATION IDS: * 1: 1-2 days * 2: 2-3 days (default) * 3: 3-4 days DEFAULTS (CREATE MODE ONLY): * shipping_method: Always set to 14 (Rakuraku Mercari), not configurable * shipping_payer: 2 (Seller pays) * shipping_duration: 2 (2-3 days) PARTIAL UPDATES (UPDATE MODE): * Only provided fields are updated * Omitted fields remain unchanged PHOTO HANDLING: * photo_paths: Array of photo paths from upload_next_listing_image responses * CREATE: Sets initial photos * UPDATE: Replaces ALL existing photos - provide all photos you want to keep * Maximum 20 photos per listing FINDING IDS: If listing attributes are unknown (category_id, condition_id, brand_id, etc.), consider using search_products to find similar items and reuse IDs from the results. EXAMPLES: * Create minimal: {"title": "iPhone 15 Pro 256GB"} * Create with fields: {"title": "Vintage Camera", "price": 50000, "category_id": 859, "condition_id": 1} * Update single field: {"draft_id": 12345, "title": "Updated Product Name"} * Update multiple: {"draft_id": 12345, "price": 30000, "description": "Updated description"}