Skip to content
MCP server

PlentyONE MCP by usefulapi

Review PlentyONE orders, items, stock and contacts; add comments and update order status.

Install
Runs
Remotely
Version
1.11.0
Listing updated
4 days ago

About PlentyONE MCP by usefulapi

PlentyONE MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add --transport http plentymarkets https://plentymarkets.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://plentymarkets.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "plentymarkets": {
      "url": "https://plentymarkets.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "plentymarkets": {
      "type": "http",
      "url": "https://plentymarkets.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "plentymarkets": {
      "serverUrl": "https://plentymarkets.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "plentymarkets": {
      "type": "http",
      "url": "https://plentymarkets.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (18)

Read directly from the server.

plentymarkets_list_orders
List orders (sales orders, returns, credit notes ...) with filters. Newest first with sort_by createdAt and sort_order desc. Returns {page, totalsCount, isLastPage, entries[]}; each entry has the id, typeId (1 = sales order), statusId, plentyId, createdAt, amounts and the order items unless add_order_items is false. GET /rest/orders.
plentymarkets_get_order
Get one order by id: status, amounts, dates, properties, order items, address relations. Add related data with `with` (addresses, comments, payments, documents, shippingPackages ...). GET /rest/orders/{orderId}.
plentymarkets_get_order_status_history
The status changes of an order: which status, when, and by which user. GET /rest/orders/{orderId}/status-history.
plentymarkets_list_order_statuses
The order statuses defined in the system (id and name per language), to translate a statusId. Optionally a range of status ids. GET /rest/orders/statuses.
plentymarkets_list_order_referrers
The order referrers (sales channels: shop, eBay, Amazon, ...) with their ids, for the referrer_id filter of plentymarkets_list_orders. GET /rest/orders/referrers.
plentymarkets_list_comments
The comments (internal notes) on an order, an order item, a contact or a category. GET /rest/comments/{referenceType}/{referenceValue}.
plentymarkets_list_items
List items (the product containers) with filters. Prices, stock, barcodes and SKUs belong to the variations: use plentymarkets_list_variations for those. Returns {page, totalsCount, isLastPage, entries[]}. GET /rest/items.
plentymarkets_get_item
Get one item by id: flags, manufacturer, texts, condition, age rating and the item-level settings. GET /rest/items/{itemId}.
plentymarkets_list_variations
Search variations (the sellable products: number, SKU, barcodes, prices, stock, categories). Filter by item, number, barcode, SKU, active flag, category, warehouse. Use `with` for the related data (variationSalesPrices, variationBarcodes, stock, variationCategories, images ...). GET /rest/items/variations.
plentymarkets_list_categories
List item categories (the category tree: id, parent, level, type, names with `with` details). GET /rest/categories.
plentymarkets_list_manufacturers
List the manufacturers (brands) of the items: id, name, address data. GET /rest/items/manufacturers.
plentymarkets_list_sales_prices
List the sales price configurations (price types such as retail or purchase price: id, type, names, which stores, countries and currencies they apply to). The prices of a variation: plentymarkets_list_variations with variationSalesPrices. GET /rest/items/sales_prices.
plentymarkets_list_stock
List physical stock per variation and warehouse (physical stock, net stock, reserved, reorder level), optionally for one variation or changed since a date. Returns {page, totalsCount, isLastPage, entries[]}. GET /rest/stockmanagement/stock.
plentymarkets_list_warehouses
List the warehouses (id, name, type, priority, address settings). GET /rest/stockmanagement/warehouses.
plentymarkets_list_contacts
List contacts (customers, suppliers, ...). Returns personal data of your customers (names, emails, addresses). Filter by email, name, number, type, postal code or town; `with` adds addresses, options (email, phone), accounts, orderSummary. GET /rest/accounts/contacts.
plentymarkets_get_contact
Get one contact by id (customer personal data). Add addresses or accounts with `with` (the relations documented for this single-contact route). GET /rest/accounts/contacts/{contactId}.
plentymarkets_add_comment
WRITE: add an internal comment to an order, order item, contact, category or variation (an additive note, nothing is overwritten). By default the comment is NOT visible to the customer; only make it visible when the user explicitly asks. POST /rest/comments.
plentymarkets_update_order_status
WRITE: move an order to another status. This can trigger the event procedures configured in the system (customer emails, stock bookings, documents, shipping), so confirm the target status with the user first (plentymarkets_list_order_statuses has the ids). Only the status is sent. PUT /rest/orders/{orderId}.

PlentyONE MCP by usefulapi FAQ

How do I add PlentyONE MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http plentymarkets https://plentymarkets.usefulapi.io/mcp