ForthClear Liquidation Marketplace
Search surplus and overstock inventory, request bulk quotes, and check out.
| Endpoint | https://app.forthclear.io/mcp (streamable-http) |
|---|---|
| Registry version | 1.5.0 |
| Now | 30 tools · grade C (67) · pin ts_6c2e480268ad5be7a7d953ad821fe1c2 · protocol 2025-06-18 |
| First / last listed | 2026-11-12 01:21 UTC / 2026-11-12 01:21 UTC |
| Grade over time | 2026-11-12: C (67), 30 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: search_inventory get_product_details request_quote get_quote_status create_listing get_pricing_recommendation get_quote_requests respond_to_quote bulk_update_listings set_listing_shipping bulk_mark_shipped bulk_export_orders seller_inbox_summarise quick_buy search_inventory_semantic get_order_status open_dispute subscribe_to_query search_suppliers preview_checkout confirm_purchase get_saved_card list_my_orders list_seller_orders cancel_order mark_order_received confirm_order get_dispute_status list_my_quotes accept_quote_and_pay
search_inventory | Keyword search of published, in-stock surplus listings. No sign-in required. `query` matches the name, description, brand, SKU, and category words, in any order. If the whole query is a category (electronics, clothes, home goods), it is treated as that category filter. Pass `category` as a catalogue category, such as electronics or home_goods, when you want to limit results. `max_price` is the max params: query, q, category, condition, max_price, limit |
get_product_details | Read one listing: description, price, quantity, condition, photo, and whether instant checkout is available. No sign-in required. Use this before requesting a quote or buying. Pass the exact id from search, for example product_2731. params: product_id, productId, id, slug |
request_quote | Ask a seller to price a bulk order. No sign-in required if you pass buyer_email, which is where the seller replies. buyer_email is always required, including when you are signed in. Anonymous requests are limited to 5 per hour. Sign in with buyer access to attach the quote to your account. Save status_token and pass it to get_quote_status. This does not charge a card. Sensitive: requires user appr params: product_id*, productId, id, slug, quantity*, buyer_email*, buyer_name, buyer_company, target_price, message, idempotency_key* |
get_quote_status | Check a quote you requested: pending, responded, accepted, rejected, or completed, plus the seller price and shipping once they reply. No sign-in required when you pass the status_token from request_quote. Signed-in buyers can also read their own quotes without the token. params: quote_id*, status_token |
create_listing | Publish a surplus lot for sale. Requires sign-in with seller access. Provide a title, category, condition, quantity, and price per unit. OAuth discovery: /.well-known/oauth-authorization-server (scope seller:write). Sensitive: requires user approval each time. params: name*, description, category*, condition*, quantity*, price_per_unit*, original_retail_price, sku, idempotency_key* |
get_pricing_recommendation | Suggest a liquidation unit price in cents from MSRP, condition, category, and lot size. No sign-in required. original_retail is MSRP per unit in cents. Larger lots suggest a lower per-unit price. The result is bounded below retail. This does not change any listing's price. params: category*, condition*, original_retail*, quantity |
get_quote_requests | List quote requests buyers sent you. Requires sign-in with seller access. Filter to pending, responded, or all. OAuth discovery: /.well-known/oauth-authorization-server (scope seller:read). params: status |
respond_to_quote | Answer a quote from a buyer by accepting it, sending a counter-price, or declining. Requires sign-in with seller access. The buyer is notified. OAuth discovery: /.well-known/oauth-authorization-server (scope seller:write). Sensitive: requires user approval each time. params: quote_request_id*, action*, counter_price, message |
bulk_update_listings | Change the price or the minimum order quantity on up to 200 of your listings. Requires sign-in with seller access. price_set takes price_cents (integer cents). value_usd is an explicit dollar amount and is deprecated. The percent modes adjust the current price, and moq_set writes a minimum order quantity. Previous values are replaced. OAuth discovery: /.well-known/oauth-authorization-server (scope params: product_ids*, mode*, price_cents, value_usd, value |
set_listing_shipping | Set how your listings ship: the shipping price per unit, or that shipping is quoted per order, and the lot type (parcel, pallet, truckload or mixed). Optionally set where your stock ships from; that is part of your seller account and shows on all your listings. Requires sign-in with seller access. Up to 200 of your listings per call; every id must be yours or nothing changes. shipping_price_cents params: product_ids*, shipping_price_cents, quote_shipping, lot_type, ship_from_country, ship_from_region |
bulk_mark_shipped | Mark up to 200 of your orders as shipped, with an optional tracking number, tracking link, and carrier applied to the whole batch. Requires sign-in with seller access. Tracking you supply replaces tracking already on those orders, and each buyer is notified. OAuth discovery: /.well-known/oauth-authorization-server (scope seller:write). Sensitive: requires user approval each time. params: order_ids*, tracking_number, tracking_url, carrier_name |
bulk_export_orders | Download your orders as CSV, with order id, product, buyer, quantity, total, status, and date. Requires sign-in with seller access. Only orders you own are included. OAuth discovery: /.well-known/oauth-authorization-server (scope seller:read). params: order_ids* |
seller_inbox_summarise | Summarise your seller inbox: quotes waiting for a reply, orders that may miss their ship-by date, and orders with reported problems. Requires sign-in with seller access. Use it to decide what to answer or ship next. OAuth discovery: /.well-known/oauth-authorization-server (scope seller:read). params: window_hours, limit |
quick_buy | Price an instant checkout for one listing. This does not charge the card. When the signed-in buyer has a saved card and the total is under US$1,000, the result is a summary (items, shipping, total, seller) plus a confirmation_token. Call confirm_purchase with that token and payment.saved_card true to charge the saved card. If there is no saved card, or the card needs authentication (including char params: product_id*, productId, id, slug, quantity*, buyer_email*, buyer_name, buyer_company, idempotency_key* |
search_inventory_semantic | Find listings by describing what you want in everyday language, such as returned kitchen appliances in bulk. No sign-in required. Semantic matches include similarity from 0 to 1 and match_type semantic. When the embedding index is empty or no provider is configured, results use keyword search, similarity is null, and match_type is keyword_fallback. category, when set, is one catalogue category suc params: query*, q, category, condition, max_price, limit |
get_order_status | Check status, tracking, and the inspection deadline for an order you placed. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:read). params: order_id* |
open_dispute | Report a problem with an order. not_received is allowed while the order is marked shipped. Other reasons require a delivered order waiting for confirmation. This records the issue, pauses the seller payout, and notifies ForthClear. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:write). Sensitive: requires user approval each time. params: order_id*, reason*, description*, requested_action, photo_urls, idempotency_key* |
subscribe_to_query | Save a catalogue search and receive new matching listings by email, webhook, or a pollable feed. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:write). params: query*, channels* |
search_suppliers | Search the supplier directory. No sign-in required. Returns published company profiles only, including profiles a company has claimed. These are not lots for sale. A profile is compiled from public sources and is not an endorsement. Use search_inventory to find lots you can buy. Filter with query, country, type (3pl, returns_processor, brand_retailer, liquidator, other), or category. params: query, q, country, type, category, limit |
preview_checkout | Read the seller of record, unit price, shipping, tax, and total for an instant-checkout listing. Does not charge a card. Requires buyer read access. Pass the returned checkout_id to confirm_purchase. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:read). params: product_id*, productId, id, slug, quantity*, shipping_address_id, idempotency_key* |
confirm_purchase | Charge the previewed checkout with the signed-in buyer's own saved card, off session, or with a Stripe shared payment token when the SDK supports it. Pass confirmation_token from quick_buy or preview_checkout. A token or total that does not match the summary is rejected and nothing is charged. The same idempotency key does not create a second charge. Charges of US$1,000 or more, and cards that nee params: checkout_id*, confirmation_token, payment*, idempotency_key* |
get_saved_card | Read whether the signed-in buyer has a card saved for in-chat checkout, and return the page where they can add one. Does not charge the card. Card numbers are not returned. Requires buyer read access. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:read). params: none |
list_my_orders | List orders the signed-in buyer placed. Requires buyer read access. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:read). params: limit |
list_seller_orders | List orders for the signed-in seller. Requires seller read access. Returns order id, status, quantity, and total. Buyer contact details stay on the order page. Requires sign-in with seller access. OAuth discovery: /.well-known/oauth-authorization-server (scope seller:read). params: limit |
cancel_order | Cancel an unshipped order whose ship-by date has passed, for a full refund. Seller Agreement §5.4. Requires buyer purchase access. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:purchase). Sensitive: requires user approval each time. params: order_id*, idempotency_key* |
mark_order_received | Mark a shipped order received. This starts the 3-day inspection window and does not pay the seller. Requires buyer write access. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:write). params: order_id*, idempotency_key* |
confirm_order | End the inspection window after it has elapsed. A live order then starts the seller payout. A sandbox order is marked delivered and is not paid out. Requires buyer write access. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:write). params: order_id*, idempotency_key* |
get_dispute_status | Read the claim on an order you placed. Requires buyer read access. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:read). params: order_id* |
list_my_quotes | List quote requests for the signed-in buyer. Requires buyer read access. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:read). params: limit |
accept_quote_and_pay | Accept a seller's quoted price and charge it with the same payment options as confirm_purchase. Requires buyer purchase access. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:purchase). Sensitive: requires user approval each time. params: quote_id*, payment*, idempotency_key* |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.