MCP MeasureMCP Measure

index observed

Sellasist MCP by usefulapi

Read Sellasist orders, products, stock, customers, invoices, returns; add order notes, set status.

Should I use this

Quality & Safety

A
Description quality
97%
Schema completeness
80%
Naming quality
79%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (2)

  • LOWTool 'sellasist_list_shipment_methods' name length outside 3-30 rangein sellasist_list_shipment_methods
  • LOWTool 'sellasist_list_integration_accounts' name length outside 3-30 rangein sellasist_list_integration_accounts

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~5,281Tokens (tool definitions)
~1.4 KBTypical response size
Significant attention impact (4.13% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "sellasist": {
      "url": "https://sellasist.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

https://sellasist.usefulapi.io/mcpstreamable-http

What it can do

Tool inventory

Tools (27)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢sellasist_list_orders(status_id, email, email_contains, first_name, last_name, ...)

List orders, newest first, with status, buyer billing address, payment, total, source (Allegro, eBay, Amazon, shop...) and comment. Filter by status, email, name, external id, payment, source or date. Use sellasist_get_order for line items and shipments. GET /orders.

Input Schema

{
  "type": "object",
  "properties": {
    "status_id": {
      "description": "Order status id - see sellasist_list_order_statuses.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "email": {
      "description": "Exact buyer email.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "email_contains": {
      "description": "Buyer email starting with this text.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "first_name": {
      "description": "Buyer first name (billing address, LIKE match).",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "last_name": {
      "description": "Buyer last name (billing address, LIKE match).",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "external_id": {
      "description": "The order id in the shop or marketplace it was imported from.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "exact_date": {
      "description": "Orders placed on exactly this date (YYYY-MM-DD).",
      "type": "string"
    },
    "date_from": {
      "description": "Orders placed at or after this date.",
      "type": "string"
    },
    "date_to": {
      "description": "Orders placed at or before this date.",
      "type": "string"
    },
    "payment_status": {
      "description": "Payment status.",
      "type": "string",
      "enum": [
        "paid",
        "unpaid",
        "excess",
        "partial",
        "returned"
      ]
    },
    "payment_id": {
      "description": "Payment method id - see sellasist_list_payment_methods.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "shipment_id": {
      "description": "Delivery method id - see sellasist_list_shipment_methods.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "currency": {
      "description": "Currency code, e.g. PLN.",
      "type": "string",
      "pattern": "^[A-Za-z]{3}$"
    },
    "source": {
      "description": "Order source.",
      "type": "string",
      "enum": [
        "allegro",
        "ebay",
        "arena",
        "ceneo",
        "extsources",
        "amazon",
        "empik",
        "shopee",
        "erli",
        "wms",
        "marketplace",
        "baselinker"
      ]
    },
    "from_id": {
      "description": "Only orders with an id greater than this.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "sort": {
      "description": "Sort by id, default desc (newest first).",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    },
    "offset": {
      "description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_get_order(order_id)

One order by id: status, buyer and delivery address, payment, shipment method, line items (product ids, EAN, quantities, prices), notes, waybills with tracking numbers, payments and additional fields. GET /orders/{order_id}.

Input Schema

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Sellasist order id (the id from sellasist_list_orders, not the marketplace's number)."
    }
  },
  "required": [
    "order_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_search_orders(creation_date_from, creation_date_to, status, order_id_from)

Find up to 100 orders created in a date range and/or in one status (id, date, status). Read-only: it uses POST only because the criteria go in the body. POST /orders_search.

Input Schema

{
  "type": "object",
  "properties": {
    "creation_date_from": {
      "description": "Created at or after this date.",
      "type": "string"
    },
    "creation_date_to": {
      "description": "Created at or before this date.",
      "type": "string"
    },
    "status": {
      "description": "Order status id - see sellasist_list_order_statuses.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "order_id_from": {
      "description": "Start from this order id (for the next batch, pass the last id returned).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_list_order_statuses

The order statuses configured in the account. Use the ids to filter orders or to change a status. GET /statuses.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_list_order_notes(order_id)

Notes written on one order (author id, date, text, visibility). GET /notes/{order_id}.

Input Schema

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Sellasist order id."
    }
  },
  "required": [
    "order_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_list_order_logs(orders, operation_tag, date_from, date_to, sort, ...)

The audit log of order actions (create, edit, status change, delete, merge, invoice and receipt actions) with date and user id. Filter by order ids, action type or date. GET /orders_logs.

Input Schema

{
  "type": "object",
  "properties": {
    "orders": {
      "description": "Only these order ids.",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "operation_tag": {
      "description": "Only this kind of action.",
      "type": "string",
      "enum": [
        "order_create",
        "order_edit",
        "order_position_edit",
        "order_status_change",
        "order_delete",
        "order_merge",
        "invoice_create",
        "invoice_edit",
        "invoice_remove",
        "receipt_create",
        "receipt_edit",
        "receipt_remove"
      ]
    },
    "date_from": {
      "description": "Actions at or after this date.",
      "type": "string"
    },
    "date_to": {
      "description": "Actions at or before this date.",
      "type": "string"
    },
    "sort": {
      "description": "Sort order (asc or desc).",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    },
    "offset": {
      "description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_list_waybills(order_id, date_from, date_to, sort, limit, ...)

Waybills (shipping labels) with order id, tracking number, creation and delivery date. Filter by order or date. Label files are not returned inline. GET /ordersshipments.

Input Schema

{
  "type": "object",
  "properties": {
    "order_id": {
      "description": "Only waybills of this order.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "date_from": {
      "description": "Created at or after this date.",
      "type": "string"
    },
    "date_to": {
      "description": "Created at or before this date.",
      "type": "string"
    },
    "sort": {
      "description": "Sort order (asc or desc).",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    },
    "offset": {
      "description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_list_products(status, manufacturer, category_id, ean, symbol, ...)

List products with id, name, EAN, symbol, catalog number, location, price, promo price, stock quantity, reserved quantity and variants. Filter by category, manufacturer, EAN, symbol or catalog number. GET /products.

Input Schema

{
  "type": "object",
  "properties": {
    "status": {
      "description": "Only active products (omit for all).",
      "type": "string",
      "enum": [
        "active"
      ]
    },
    "manufacturer": {
      "description": "Exact manufacturer name.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "category_id": {
      "description": "Category id, or several separated by commas - see sellasist_list_categories.",
      "type": "string",
      "maxLength": 200,
      "pattern": "^\\d+(,\\d+)*$"
    },
    "ean": {
      "description": "Exact EAN.",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "symbol": {
      "description": "Exact product symbol.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "catalog_number": {
      "description": "Exact catalog number.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "auction_id": {
      "description": "Offer id in an external marketplace (Allegro, shop...).",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "from_id": {
      "description": "Only products with an id greater than this.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "sort": {
      "description": "Sort by id (asc or desc).",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    },
    "offset": {
      "description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_get_product(product_id)

One product by id: title, category, prices, VAT, stock, sold counts, EAN, symbol, location, weight, qualities, availability, manufacturer and more. GET /products/{product_id}.

Input Schema

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Sellasist product id."
    }
  },
  "required": [
    "product_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_get_stock(id, ean, symbol, catalog_number, limit, ...)

Stock quantity of one product, found by id, EAN, symbol or catalog number (the first one given in that order counts); with none of them, a page of stock levels for all products. GET /products_stock.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "description": "Product id.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "ean": {
      "description": "Exact EAN.",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "symbol": {
      "description": "Exact product symbol.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "catalog_number": {
      "description": "Exact catalog number.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "limit": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    },
    "offset": {
      "description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_list_bestsellers(page, limit)

Products ranked by units sold in the last month (sold_last_month), with stock and price. GET /products_bestsellers.

Input Schema

{
  "type": "object",
  "properties": {
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "limit": {
      "description": "Products per page, 1-100 (default 18).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_list_categories(limit, offset)

Product categories. GET /categories.

Input Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    },
    "offset": {
      "description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_get_category(category_id)

One category: names per language, parent category and status. GET /categories/{category_id}.

Input Schema

{
  "type": "object",
  "properties": {
    "category_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Category id."
    }
  },
  "required": [
    "category_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_list_warehouses

Warehouses (id, title). Needs the warehouse-management feature, otherwise Sellasist answers HTTP 406. GET /storages.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_list_customers(limit, offset)

Registered customers (the account's buyers). GET /users.

Input Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    },
    "offset": {
      "description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_get_customer(customer_id)

One customer: email, registration date, billing and delivery address. GET /users/{user_id}.

Input Schema

{
  "type": "object",
  "properties": {
    "customer_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Customer id."
    }
  },
  "required": [
    "customer_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_list_invoices(order_id, series_id, date_from, date_to, sort, ...)

Invoices (id, number, date). Filter by order, document series or issue date. GET /invoices.

Input Schema

{
  "type": "object",
  "properties": {
    "order_id": {
      "description": "Only invoices of this order.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "series_id": {
      "description": "Only this document series.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "date_from": {
      "description": "Issued at or after this date.",
      "type": "string"
    },
    "date_to": {
      "description": "Issued at or before this date.",
      "type": "string"
    },
    "sort": {
      "description": "Sort order, default desc.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    },
    "offset": {
      "description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_get_invoice(invoice_id)

One invoice: number, dates, seller, buyer, currency, line items (net, gross, VAT), total and paid amount. GET /invoices/{invoice_id}.

Input Schema

{
  "type": "object",
  "properties": {
    "invoice_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Invoice id."
    }
  },
  "required": [
    "invoice_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_list_returns(date_from, date_to, order_id, status_id, source_id, ...)

Return documents (RMZ): number, status, source, linked order, refund value and tracking number. Filter by date, order, status, source or return number. GET /returns.

Input Schema

{
  "type": "object",
  "properties": {
    "date_from": {
      "description": "Created at or after this date.",
      "type": "string"
    },
    "date_to": {
      "description": "Created at or before this date.",
      "type": "string"
    },
    "order_id": {
      "description": "Only returns of this order.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "status_id": {
      "description": "Return status id.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "source_id": {
      "description": "Return source id.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "return_number": {
      "description": "Exact return number, e.g. RMZ120072026.",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "sort": {
      "description": "Sort by id, default desc.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    },
    "offset": {
      "description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_get_return(return_id)

One return document with status, refund and payment details, tracking, courier and the returned items. GET /returns/{id}.

Input Schema

{
  "type": "object",
  "properties": {
    "return_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Return document id (from sellasist_list_returns)."
    }
  },
  "required": [
    "return_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_list_payment_methods

Payment methods (id, title) for filtering orders. GET /payments.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_list_shipment_methods

Delivery methods (id, title) for filtering orders. GET /shipments.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_list_order_sources

Order sources available in the account (id, name, type: Allegro, shop, marketplace...). GET /sources.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_list_integration_accounts

Accounts connected in external services (id, login, type). Only these three fields are returned. GET /external_accounts.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢sellasist_list_alerts(page)

Active alerts and system messages shown on the Sellasist dashboard (type, severity, title, message). GET /alerts.

Input Schema

{
  "type": "object",
  "properties": {
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡sellasist_add_order_note(order_id, text)

WRITE: add a new note to an order. Notes are visible to the account's staff; each call adds another note (nothing is overwritten). POST /notes.

Input Schema

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Sellasist order id."
    },
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 5000,
      "description": "The note text."
    }
  },
  "required": [
    "order_id",
    "text"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴sellasist_update_order_status(order_id, status_id, send_status_to_external)

WRITE: change the status of one order (PUT /orders/{order_id} with only the status). Sellasist may run the status's automations (emails, stock moves). By default the new status is NOT pushed to the marketplace; set send_status_to_external to true to push it. Find status ids with sellasist_list_order_statuses.

Input Schema

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Sellasist order id."
    },
    "status_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "New status id - see sellasist_list_order_statuses."
    },
    "send_status_to_external": {
      "description": "Also send the new status to the external marketplace or shop the order came from.",
      "type": "boolean"
    }
  },
  "required": [
    "order_id",
    "status_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded27 tools