MCP server
PlentyONE MCP by usefulapi
Review PlentyONE orders, items, stock and contacts; add comments and update order status.
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://plentymarkets.usefulapi.io/mcpInstall 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