MarketTime MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.7.4Updated Nov 7, 2026

MCP server for MarketTime — wholesale orders, customers, catalog and shipment tracking.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Connects an assistant to a MarketTime wholesale account to look up orders, customers, catalog items, inventory, pricing and shipments.

What you can do
  • Search and read wholesale orders, order lines, change history and shipment tracking
  • List and inspect customers, their contacts and ship-to locations
  • Search the product catalog and read item details, inventory levels and pricing
  • List manufacturers, salespeople and commission payment records
  • Create a shipment with tracking on an order, or create a new customer record
  • Check monthly tool-call usage, request a feature, upgrade or cancel the plan
When to use it
Useful for sales reps, rep groups and manufacturers on MarketTime who want to ask questions in plain language about incoming orders, unshipped items, customer records, stock levels or pricing, or to add a shipment or customer without opening the MarketTime interface.
Requirements
Remote MCP endpoint added by URL only; sign-in uses OAuth and the login page asks for MarketTime credentials. No API key or Authorization header is configured in the client. A MarketTime account with API access is required; the free plan allows 50 tool calls per month.
Before you install
Two tools write data: creating a shipment can notify the customer and is not idempotent, and creating a customer can produce duplicates if repeated. Paid plans are billed through a Stripe checkout link returned by the upgrade tool, with no refund for the current period on cancellation. Order, customer and commission data is sent to the hosted service.

Installation

In SourceWeft

  1. Open MarketTime MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fmarkettime/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "markettime-by-usefulapi": {
      "type": "http",
      "url": "https://markettime.usefulapi.io/mcp"
    }
  }
}

README

MarketTime MCP by usefulapi

Connect your API-enabled MarketTime account.

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://markettime.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http markettime https://markettime.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "markettime": {      "url": "https://markettime.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your MarketTime credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/markettime/

Tools

ToolTypeWhat it does
markettime_list_manufacturersreadList manufacturers
markettime_get_manufacturerreadGet manufacturer
markettime_list_ordersreadList orders
markettime_list_order_detailsreadList order lines
markettime_get_order_changes_historyreadGet order changes history
markettime_list_order_shipmentsreadList order shipments
markettime_list_customersreadList customers
markettime_get_customerreadGet customer
markettime_list_customer_contactsreadList customer contacts
markettime_list_customer_ship_to_locationsreadList customer ship-to locations
markettime_list_itemsreadList items
markettime_get_itemreadGet item
markettime_list_item_inventoryreadList item inventory
markettime_list_item_pricingreadList item pricing
markettime_list_salespersonsreadList salespersons
markettime_list_commission_order_paymentsreadList commission order payments
markettime_create_order_shipmentwriteCreate order shipment
markettime_create_customerwriteCreate customer
markettime_usage_statusmetaUsage status (free-tier meter)
markettime_request_featuremetaRequest a missing feature
markettime_upgrademetaUpgrade to Pro or Pro+
markettime_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per Rep Group or Manufacturer account)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with markettime_upgrade (it returns a Stripe Checkout link). Cancel any time with markettime_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running markettime_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT

Source: servers/markettime/README.md at commit 4046075

Tools

18

markettime_list_manufacturers

List manufacturers

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.

Parameterssortactiveoffsetpage_sizesort_direction

markettime_get_manufacturer

Get manufacturer

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

Parametersmanufacturer_idrequired

markettime_list_orders

List orders

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.

Parametersoffsetstatusfilterspage_sizepo_numberordered_tosort_fieldcustomer_idordered_fromcustomer_namemodified_sincesort_direction+3 more

markettime_list_order_details

List order lines

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.

Parametersoffsetorder_idpage_sizepo_numberordered_tosort_fieldordered_frommax_unit_pricemin_unit_pricesort_directionmanufacturer_idrep_group_status+1 more

markettime_get_order_changes_history

Get order changes history

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

Parametersoffsetorder_idrequiredpage_size

markettime_list_order_shipments

List order shipments

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

Parametersorder_idrequired

markettime_list_customers

List customers

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.

Parametersnamestateoffsetstatusfilterspage_sizesort_fieldrep_group_idmodified_sincesort_direction

markettime_get_customer

Get customer

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}.

Parameterscustomer_idrequiredrep_group_id

markettime_list_customer_contacts

List customer contacts

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

Parametersoffsetpage_sizecustomer_idrequired

markettime_list_customer_ship_to_locations

List customer ship-to locations

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

Parametersoffsetpage_sizecustomer_idrequired

markettime_list_items

List items

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.

Parametersnameoffsetfilterspage_sizesort_fielditem_numbermodified_sincesort_directionmanufacturer_id

markettime_get_item

Get item

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

Parametersitem_idrequired

markettime_list_item_inventory

List item inventory

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

Parameterssortoffsetpage_sizesort_direction

markettime_list_item_pricing

List item pricing

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

Parametersoffsetpage_size

markettime_list_salespersons

List salespersons

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

Parametersnameoffsetpage_sizesort_fieldsort_direction

markettime_list_commission_order_payments

List commission order payments

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.

Parameterspagefiltersorder_idpage_sizemodified_since

markettime_create_order_shipment

Create order shipment

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.

Parametersnotesorder_idrequiredship_datetracking_linkrequiredinvoice_amountinvoice_numbershipping_methodrequiredtracking_numberrequired

markettime_create_customer

Create customer

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.

Parameterszipcitynamerequiredemailrequirednotesphonerequiredstatestatuscountrywebsiteaddress1address2+1 more

Version history

10
  1. v1.7.4LatestNov 7, 2026
  2. v1.6.3Nov 5, 2026
  3. v1.6.2Nov 5, 2026
  4. v1.6.1Nov 4, 2026
  5. v1.6.0Nov 3, 2026
  6. v1.5.1Nov 3, 2026
  7. v1.4.0Nov 1, 2026
  8. v1.2.0Oct 31, 2026
  9. v1.1.0Oct 31, 2026
  10. v1.0.1Oct 31, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations