# PlentyONE MCP by usefulapi (remote · plentymarkets.usefulapi.io)

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

- Trust score: 18/100 (low)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- remote · `plentymarkets.usefulapi.io`: 18/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-plentymarkets/plentymarkets.md), [page](https://verifymcp.io/servers/io-usefulapi-plentymarkets/plentymarkets)

## Channel facts

- Endpoint: `https://plentymarkets.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.6.3`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Endpoint Security**: 46/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not yet verified: we couldn't confirm whether this endpoint requires it.
  - HTTPS enforcement could not be verified: the plaintext port redirected somewhere other than https, so enforcement is unproven.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 0/100
  - Transport check failed: declared streamable-http, but the endpoint redirected instead of responding directly.
- **Schema Quality & AI Usability**: 0/100
  - Schema not yet verified: we couldn't read the endpoint's schema, or could read only part of its tool list.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 0/100
  - Tool coverage not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.
- **Tool Safety**: 0/100
  - Tool safety not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.
- **Capabilities**: 0/100
  - Capabilities not yet verified: we couldn't read the endpoint's capabilities.

**Unverified: 5 categories.** Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.

## Install

### How do I install the PlentyONE MCP by usefulapi server?

PlentyONE MCP by usefulapi is a hosted endpoint at https://plentymarkets.usefulapi.io/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

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

### Cursor

```json
{
  "mcpServers": {
    "io-usefulapi-plentymarkets": {
      "url": "https://plentymarkets.usefulapi.io/mcp"
    }
  }
}
```

### VS Code

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

### Codex

```toml
[mcp_servers.io-usefulapi-plentymarkets]
url = "https://plentymarkets.usefulapi.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-plentymarkets": {
      "type": "remote",
      "url": "https://plentymarkets.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-plentymarkets --url 'https://plentymarkets.usefulapi.io/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-plentymarkets:
    url: "https://plentymarkets.usefulapi.io/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "io-usefulapi-plentymarkets": {
      "Transport": "http",
      "Url": "https://plentymarkets.usefulapi.io/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add io-usefulapi-plentymarkets -t streamable-http -u 'https://plentymarkets.usefulapi.io/mcp'
```

### Other

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

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-01 (score 18, −45)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Tool safety: pass → unverified
- [security regression] Authorization: pass → unverified
- [security regression] Stability: 0.03 → unverified
- [functional regression] Schema quality: 100 → unverified
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified

### 2026-10-31 (score 63, +3)

- [security improvement] Authorization: partial → pass
- [functional improvement] Stability: unverified → 0.03
- [functional improvement] MCP protocol: fail → pass
- [functional] New prompt “add_an_internal_order_note”
- [functional] New prompt “change_an_order_s_status”
- [functional] New prompt “find_stock_that_needs_attention”
- [functional] New prompt “review_a_customer_s_orders”
- [functional] New prompt “review_unpaid_orders”
- [functional] MCP protocol version: 2025-06-18 → 2025-11-25
- [functional] Server version: 1.2.0 → 1.4.0
- [functional] Server version: 1.1.0 → 1.2.0
- [functional] Server version: 1.0.2 → 1.1.0

### 2026-10-30 (score 60)

First indexed and scored.

## MCP tools (18)

### `plentymarkets_list_orders` (~709 tokens)

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.

Input parameters:

- `add_order_items` (boolean): Include the order items (default true). false makes the page much smaller.
- `contact_id` (integer): Only orders of this contact (customer).
- `created_from` (string): A date (yyyy-mm-dd) or a date-time (2026-10-24T13:33:23+02:00). A bare date means the whole day.
- `created_to` (string): A date (yyyy-mm-dd) or a date-time (2026-10-24T13:33:23+02:00). A bare date means the whole day.
- `external_order_id` (string): The order id the marketplace or shop gave the order.
- `included_variation` (integer): Only orders that contain this variation id.
- `items_per_page` (integer): Entries per page, 1 to 100 (default 25). When is_last_page is false, ask for the next page.
- `order_ids` (string): Specific order ids, comma separated.
- `order_type` (string): Order type id(s), comma separated: 1 sales order, 2 delivery order, 3 returns, 4 credit note, 5 warranty, 6 repair, 7 offer, 8 advance order, 9 multi order, 10 multi credit note, 11 multi delivery, 1…
- `page` (integer): Page number, from 1 (default 1).
- `paid_from` (string): A date (yyyy-mm-dd) or a date-time (2026-10-24T13:33:23+02:00). A bare date means the whole day.
- `paid_to` (string): A date (yyyy-mm-dd) or a date-time (2026-10-24T13:33:23+02:00). A bare date means the whole day.
- `payment_status` (string)
- `referrer_id` (number): Only orders from this order referrer / marketplace (see plentymarkets_list_order_referrers).
- `sort_by` (string)
- `sort_order` (string)
- `status_from` (number): Only orders in this status or a higher one (status ids are numbers like 3, 5.1, 7).
- `status_to` (number): Only orders up to this status (combine with status_from for a range).
- `updated_from` (string): A date (yyyy-mm-dd) or a date-time (2026-10-24T13:33:23+02:00). A bare date means the whole day.
- `updated_to` (string): A date (yyyy-mm-dd) or a date-time (2026-10-24T13:33:23+02:00). A bare date means the whole day.
- `with` (array): Related data to load, for example addresses, comments, payments, documents.

### `plentymarkets_get_order` (~94 tokens)

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

Input parameters:

- `add_order_items` (boolean): Include the order items (default true).
- `order_id` (integer, required): The order id.
- `with` (array)

### `plentymarkets_get_order_status_history` (~50 tokens)

The status changes of an order: which status, when, and by which user. GET /rest/orders/{orderId}/status-history.

Input parameters:

- `order_id` (integer, required)

### `plentymarkets_list_order_statuses` (~136 tokens)

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.

Input parameters:

- `items_per_page` (integer): Entries per page, 1 to 100 (default 50). When is_last_page is false, ask for the next page.
- `language` (string): Two-letter language code, for example en or de.
- `page` (integer): Page number, from 1 (default 1).
- `status_id_from` (number)
- `status_id_to` (number)

### `plentymarkets_list_order_referrers` (~58 tokens)

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` (~71 tokens)

The comments (internal notes) on an order, an order item, a contact or a category. GET /rest/comments/{referenceType}/{referenceValue}.

Input parameters:

- `reference_id` (integer, required): The id of the order, order item, contact or category.
- `reference_type` (string, required)

### `plentymarkets_list_items` (~240 tokens)

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.

Input parameters:

- `id` (string): Item id(s), comma separated.
- `items_per_page` (integer): Entries per page, 1 to 100 (default 25). When is_last_page is false, ask for the next page.
- `lang` (string): Language of the texts, a two-letter code (default: the system's).
- `manufacturer_id` (integer)
- `name` (string): Item name (matches the name of the item).
- `page` (integer): Page number, from 1 (default 1).
- `updated_from` (string): Only items updated from this day on (yyyy-mm-dd).
- `updated_to` (string): Only items updated up to this day (yyyy-mm-dd).
- `with` (array): Related data: itemProperties, itemCrossSelling, variations, itemImages, itemShippingProfiles.

### `plentymarkets_get_item` (~66 tokens)

Get one item by id: flags, manufacturer, texts, condition, age rating and the item-level settings. GET /rest/items/{itemId}.

Input parameters:

- `item_id` (integer, required)
- `lang` (string): Language of the texts, a two-letter code.

### `plentymarkets_list_variations` (~321 tokens)

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.

Input parameters:

- `barcode` (string)
- `category_id` (integer)
- `id` (integer): One variation id.
- `is_active` (boolean)
- `is_main` (boolean): Only main variations.
- `item_id` (integer): Only variations of this item.
- `item_name` (string)
- `items_per_page` (integer): Entries per page, 1 to 100 (default 25). When is_last_page is false, ask for the next page.
- `lang` (string)
- `manufacturer_id` (integer)
- `number_exact` (string): The exact variation number.
- `number_fuzzy` (string): Variation numbers that contain this text.
- `page` (integer): Page number, from 1 (default 1).
- `sku` (string)
- `stock_warehouse_id` (integer): Only variations with physical stock in this warehouse.
- `supplier_id` (integer)
- `updated_from` (string): Only variations updated from this day on (yyyy-mm-dd).
- `updated_to` (string): Only variations updated up to this day (yyyy-mm-dd).
- `with` (array)

### `plentymarkets_list_categories` (~152 tokens)

List item categories (the category tree: id, parent, level, type, names with `with` details). GET /rest/categories.

Input parameters:

- `items_per_page` (integer): Entries per page, 1 to 100 (default 50). When is_last_page is false, ask for the next page.
- `lang` (string)
- `level` (integer)
- `name` (string)
- `page` (integer): Page number, from 1 (default 1).
- `parent_id` (integer)
- `type` (string)
- `with` (array): details = names and texts, clients = the stores the category is active in, tags.

### `plentymarkets_list_manufacturers` (~98 tokens)

List the manufacturers (brands) of the items: id, name, address data. GET /rest/items/manufacturers.

Input parameters:

- `items_per_page` (integer): Entries per page, 1 to 100 (default 50). When is_last_page is false, ask for the next page.
- `name` (string)
- `page` (integer): Page number, from 1 (default 1).

### `plentymarkets_list_sales_prices` (~122 tokens)

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.

Input parameters:

- `items_per_page` (integer): Entries per page, 1 to 100 (default 50). When is_last_page is false, ask for the next page.
- `page` (integer): Page number, from 1 (default 1).

### `plentymarkets_list_stock` (~199 tokens)

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.

Input parameters:

- `items_per_page` (integer): Entries per page, 1 to 200 (default 50). When is_last_page is false, ask for the next page.
- `page` (integer): Page number, from 1 (default 1).
- `sort_by` (string)
- `sort_order` (string)
- `updated_from` (string): Only stock changed from this date on.
- `updated_to` (string): A date (yyyy-mm-dd) or a date-time (2026-10-24T13:33:23+02:00). A bare date means the whole day.
- `variation_id` (integer)

### `plentymarkets_list_warehouses` (~39 tokens)

List the warehouses (id, name, type, priority, address settings). GET /rest/stockmanagement/warehouses.

### `plentymarkets_list_contacts` (~311 tokens)

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.

Input parameters:

- `created_after` (string): A date, yyyy-mm-dd.
- `created_before` (string): A date, yyyy-mm-dd.
- `email` (string): An email address.
- `full_text` (string): Full text search over the contact data.
- `items_per_page` (integer): Entries per page, 1 to 100 (default 25). When is_last_page is false, ask for the next page.
- `last_order_after` (string): A date, yyyy-mm-dd.
- `last_order_before` (string): A date, yyyy-mm-dd.
- `name` (string)
- `number` (string): The contact number.
- `page` (integer): Page number, from 1 (default 1).
- `postal_code` (string)
- `town` (string)
- `type_id` (integer): Contact type: 1 customer, 2 interested party, 3 sales representative, 4 supplier, 5 manufacturer, 6 partner.
- `updated_after` (string): A date, yyyy-mm-dd.
- `updated_before` (string): A date, yyyy-mm-dd.
- `with` (array)

### `plentymarkets_get_contact` (~65 tokens)

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

Input parameters:

- `contact_id` (integer, required)
- `with` (array)

### `plentymarkets_add_comment` (~126 tokens)

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.

Input parameters:

- `reference_id` (integer, required): The id of the order, order item, contact, category or variation.
- `reference_type` (string, required)
- `text` (string, required): The comment text.
- `visible_for_contact` (boolean): Show the comment to the customer (default false: internal only).

### `plentymarkets_update_order_status` (~110 tokens)

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

Input parameters:

- `order_id` (integer, required)
- `status_id` (number, required): The target status id, for example 5 or 7.2.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-plentymarkets/plentymarkets#diagnostics

## Score history

- 2026-11-05: 18
- 2026-11-04: 18
- 2026-11-03: 18
- 2026-11-02: 18
- 2026-11-01: 18
- 2026-10-31: 63
- 2026-10-30: 60

## Common questions

### What is the PlentyONE MCP by usefulapi server?

PlentyONE MCP by usefulapi is listed in the public MCP registry as io.usefulapi/plentymarkets. Review PlentyONE orders, items, stock and contacts; add comments and update order status. This page covers its hosted endpoint (https://plentymarkets.usefulapi.io/mcp).

### Is the PlentyONE MCP by usefulapi server safe to use?

PlentyONE MCP by usefulapi scores 18 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the PlentyONE MCP by usefulapi server expose?

PlentyONE MCP by usefulapi exposes 18 tools: plentymarkets_list_orders, plentymarkets_get_order, plentymarkets_get_order_status_history, plentymarkets_list_order_statuses, plentymarkets_list_order_referrers, and 13 more. Their descriptions and schemas cost roughly 2,967 tokens of context every time the server is loaded.

### Does the PlentyONE MCP by usefulapi server require authentication?

Its publisher declares no required credentials for PlentyONE MCP by usefulapi. We have not been able to confirm that against the live endpoint, and a server can require authorisation without declaring it here.

### Is the PlentyONE MCP by usefulapi server still maintained?

PlentyONE MCP by usefulapi is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the PlentyONE MCP by usefulapi server?

VerifyMCP ran 4 checks on PlentyONE MCP by usefulapi, covering TLS certificate, HSTS header, DNSSEC and Transport. 7 items could not be completed, a gap on our side rather than a finding about PlentyONE MCP by usefulapi: Authorization, HTTPS, Schema quality, Stability and 3 more. 5 categories score 0 for that reason, because we only credit what we can confirm. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- Remote endpoint: https://plentymarkets.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Website: https://usefulapi.io/plentymarkets/
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-plentymarkets/plentymarkets.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-plentymarkets/plentymarkets/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/io-usefulapi-plentymarkets/plentymarkets.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-plentymarkets/plentymarkets