ForthClear

View saved version →

---
name: forthclear-buy
description: Find wholesale surplus inventory on ForthClear, compare lots, request and track bulk quotes, or manage the connected buyer's orders and saved searches.
---

Use the ForthClear MCP connection for current inventory and account information.
Search and product lookup work anonymously. Account tools prompt for linking;
never ask the user to paste a password, API key, or delegated token into chat.

Search with `search_inventory`; use `search_inventory_semantic` for descriptive
queries. Prices in tool inputs and most outputs are integer minor units (cents).
Respect each returned currency. Use actual product IDs returned by search, then
`get_product_details` for condition, available quantity, minimum order quantity,
bulk tiers, shipping, and purchase guidance. Do not invent stock or present
pricing guidance as a binding seller offer. Explain empty results and offer
relevant broader filters without claiming unavailable stock exists.

For a bulk quote, collect the chosen product, quantity, buyer email, and any
requested target price or message. `request_quote` contacts a real seller;
submit when the user authorizes sending those details. It works anonymously
with a buyer email, subject to five requests per hour per IP. An existing
account may require linking to prove ownership. Keep the returned quote ID and
`status_token` private; use them with `get_quote_status` to read seller replies.
A quote request is not a completed order or guaranteed reservation.

`quick_buy` is available only where product details explicitly allow instant
checkout. Confirm the chosen product, quantity, current total and currency,
and available shipping information before starting a purchase. Use a returned
checkout link for payment; never collect card details or imply payment or funds
release succeeded without a successful server response. Bulk thresholds may
require a seller quote. A connection with buyer read/write permissions does
not include purchase permission; follow the account-linking prompt if needed.

Use `get_order_status` only for the connected buyer's order. `open_dispute`
changes a real order and notifies administrators; obtain the user's reason and
authorization to submit it. `subscribe_to_query` persists a saved search and
can dispatch notifications. Honor the user's chosen filters and delivery
method; do not invent a webhook or use a third party's address.

On an authentication error, let the host open account linking and retry the
same requested operation after connection. On a scope error, request only the
permission needed by that operation. Manage or revoke connections at
https://app.forthclear.io/oauth/connections. On a timeout after a write, check
its status or use the tool's supported idempotency key before retrying; do not
submit a duplicate quote, dispute, or purchase blindly.

View saved version →

---
name: forthclear-sell
description: Manage the connected ForthClear seller's listings, quote inbox, order exports, and shipping using its MCP tools.
---

Use the ForthClear MCP connection. Seller account tools require linking a
seller account; do not ask for secrets in chat. Public pricing recommendations
can run without connecting, but they are guidance rather than guaranteed sales.

Start inbox reviews with `seller_inbox_summarise` or `get_quote_requests`.
Describe the actual pending quotes, ship-by risks, and issues returned by the
server. Do not infer that an empty inbox means there are no active orders.
`bulk_export_orders` exports only the connected seller's orders; treat the
result as private account data.

For `create_listing`, collect required product facts from the seller: name,
category, condition, quantity, unit price, currency, minimum order quantity,
and any other required fields in the tool schema. Inputs use minor units where
specified. Do not invent provenance, condition, warranties, stock, or shipping
terms. Review the concrete listing details with the seller before publishing.
Use `get_pricing_recommendation` when requested and distinguish a recommendation
from the price the seller authorizes.

`respond_to_quote` accepts, counters, or declines a real quote. Identify the
quote and action; confirm price, quantity, shipping, and any applicable terms
before submitting a counteroffer or acceptance. Respect authorization already
provided by the user; do not add repeated confirmation for the same action.

`bulk_update_listings` overwrites price or minimum order quantity. Show the
specific listing IDs and proposed values before an authorized update; do not
interpret a general optimization request as permission to change all prices.
Batch limits come from the current tool schema (currently up to 200 items).
`bulk_mark_shipped` requires actual carrier/tracking details for the intended
orders. Do not mark goods shipped merely because a label was created.

Use supported idempotency keys for bulk operations. If a response is partial,
report successful and failed items and retry only failed items after resolving
their errors. If a write times out, verify its outcome before replaying it.
Never claim a listing, shipment, or quote changed without server confirmation.

Read permissions do not grant seller write permission. Follow host account
linking on authentication or scope errors. Connections can be revoked at
https://app.forthclear.io/oauth/connections.