MarketTime MCP by usefulapi

WRITE: create a new customer (retailer) account record. It is not idempotent: calling it twice may create two customers, so search with markettime_list_customers by name first. Does not send an invitation by itself. POST /customers.

WRITE: add a shipment with tracking to an order (manufacturer accounts only). This creates a new shipment record each time it is called (it is not idempotent) and MarketTime may notify the customer of the tracking details; calling it twice makes a duplicate. Check markettime_list_order_shipments first. POST /orders/{orderId}/trackingdetails.

One customer's full record by id (like B123): addresses, contacts, ship-to locations, terms, pricing method. Their API key is never returned. GET /customers/{id}.

One catalog item by its numeric record id (the recordID/itemID in item lists). GET /items/{itemID}.

One manufacturer's details by its id (like M123). GET /manufacturers/{id}.

The audit trail of one order: who changed what and when (Rep Group accounts). POST /orders/{orderId}/orderChangesHistory/get (a read-only search).

Order payment and commission records (what was paid on which order, commission percent), Rep Group accounts only. Filters: order_id, modified_since, or custom filters (allowed fields: orderID, checkLogID, invoiceNumber, type, commissionPayDate, salespersonPaidID, dateAdded, dateModified). Card tokens and card data are never returned. Paged by page number. POST /commissions/orderpayments/get.

The contact people of one customer (name, email, phone, title). GET /customers/{id}/contacts.

The ship-to locations of one customer (name, address, account number). GET /customers/{id}/shiptolocations.

List customers (retailers/buyers) with name, email, address, status (ACTIVE, INACTIVE, LEAD), customer number and salesperson. Filters: name (contains), state, status, modified_since. The customers' own API keys are never returned. POST /customers/get.

Stock levels per item: quantity available, quantity on the water, next available date, availability flag. Sort fields: itemNumber, nextAvailableDate, qtyAvailable, isAvailable. GET /items/inventory.

Pricing detail per item (unit price, retail price, price codes, discounts). GET /items/pricing.

Search the product catalog: item number, name, prices, case quantity, stock, UPC, categories, images. Filters: name (contains), item_number, manufacturer_id, modified_since. POST /items/get.

List the manufacturers (brands) connected to this account: id, name, email, city, category, connection date. Sort fields: name (default), manufacturerID, connectionDate, dateAdded, dateModified, city. GET /manufacturers.

List order lines (item, quantity, unit price) across orders or for one order (order_id). Filters: order dates, statuses, manufacturer, PO number, unit price range. GET /orders/orderdetails.

Shipment and tracking records of one order (tracking number, link, carrier, ship date, invoice). GET /orders/{orderId}/trackingdetails/get.

Search wholesale orders (for the newest first use sort_field orderDate with sort_direction desc). Convenience filters: status (the manufacturer's order status, e.g. NEW, SENT, SHIPPED), rep_group_status (Rep Group accounts only), po_number, customer_name (contains), manufacturer_id, customer_id, ordered_from/ordered_to (order date), modified_since. Order lines are left out unless include_details is true (they make replies large; use markettime_list_order_details for the lines of one order). Card tokens are never returned. POST /orders/get.

List the Rep Group's salespeople (name, abbreviation, status, ids). Rep Group accounts only. POST /salespersons/get.