Sello MCP by usefulapi
Read orders, products, messages and sales stats; update orders and product stock in Sello.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
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": {
"sello": {
"url": "https://sello.usefulapi.io/mcp"
}
}
}Remote endpoints
https://sello.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (21)
🟢sello_get_account
Show the Sello account: company, country, currency and invoice status. GET /account.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sello_list_orders(limit, status_id)
List recent orders with a limited set of fields (customer, status, total, paid/delivered flags). Use `sello_get_order` for rows. Optional local filter by `status_id`. GET /orders.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "Return at most this many items (default 50). Sello returns up to 300 orders or 100 products per call.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 300
},
"status_id": {
"description": "Keep only orders with this status id (filtered after the call).",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sello_get_order(order_id)
Get one order with all fields. GET /orders/{id}.
Input Schema
{
"type": "object",
"properties": {
"order_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
],
"description": "Numeric Sello id."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sello_list_order_rows(order_id)
List the rows (products, quantity, price, tax) of one order. GET /orders/{id}/rows.
Input Schema
{
"type": "object",
"properties": {
"order_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
],
"description": "Numeric Sello id."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sello_list_order_deliveries(order_id)
List the deliveries (tracking) of one order. GET /orders/{id}/deliveries.
Input Schema
{
"type": "object",
"properties": {
"order_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
],
"description": "Numeric Sello id."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sello_get_order_history(order_id, next)
Show the change history of one order, 10 items per call. GET /orders/{id}/history.
Input Schema
{
"type": "object",
"properties": {
"order_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
],
"description": "Numeric Sello id."
},
"next": {
"description": "Token from a previous call's `next` to fetch older history items.",
"type": "string"
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sello_list_products(limit)
List products with a limited set of fields (name, SKU, stock, prices per integration). Use `sello_get_product` for all fields. GET /products.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "Return at most this many items (default 50). Sello returns up to 300 orders or 100 products per call.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 300
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sello_get_product(product_id, sku)
Get one product with all fields, by Sello id or by your SKU (private reference). Give exactly one. GET /products/{id} or /products/sku/{sku}.
Input Schema
{
"type": "object",
"properties": {
"product_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
],
"description": "Numeric Sello id."
},
"sku": {
"description": "Your private SKU.",
"type": "string",
"minLength": 1
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sello_get_product_history(product_id, next)
Show the change history of one product, 20 items per call. GET /products/{id}/history.
Input Schema
{
"type": "object",
"properties": {
"product_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
],
"description": "Numeric Sello id."
},
"next": {
"description": "Token from a previous call's `next` to fetch older history items.",
"type": "string"
}
},
"required": [
"product_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sello_list_statuses
List your order statuses (title, paid/delivered flags). Use the ids with `sello_update_order`. GET /status.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sello_list_suppliers
List your suppliers. GET /suppliers.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sello_list_integrations
List the marketplace and webshop integrations connected to the account (status, market, last order check). Tokens are removed. GET /integrations.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sello_list_messages
List the last 100 marketplace sync messages (errors, warnings). Sello deletes them after 14 days. GET /messages.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sello_count_unread_messages
Count unread sync messages. GET /messages/count.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sello_get_stats_summary
Show the sales summary of the account. GET /account/stats.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sello_get_daily_turnover
Show turnover per day for the past 30 days, per integration id. GET /account/stats/turnover/daily.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sello_get_monthly_turnover
Show turnover per month, per integration id. GET /account/stats/turnover/monthly.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sello_get_stock_worth
Show the worth of the stock. GET /account/stats/stockworth.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢sello_get_top_sellers
Show the best selling products. GET /account/stats/topsellers.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴sello_update_order(order_id, status_id, notes, is_new)
WRITE: change an order's status, notes or new-flag. Send only the fields to change. Get status ids from `sello_list_statuses`. A status change can trigger Sello automations (mail, stock). PUT /orders/{id}.
Input Schema
{
"type": "object",
"properties": {
"order_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
],
"description": "Numeric Sello id."
},
"status_id": {
"description": "New status id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"notes": {
"description": "New order notes (replaces the old notes).",
"type": "string",
"maxLength": 5000
},
"is_new": {
"description": "Set or clear the new-order flag.",
"type": "boolean"
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴sello_update_product_quantity(product_id, sku, quantity)
WRITE: set the stock quantity of one product by Sello id or by your SKU (give exactly one). Sello then syncs the new quantity to all active marketplaces. PUT /products/{id} or /products/sku/{sku}.
Input Schema
{
"type": "object",
"properties": {
"product_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
],
"description": "Numeric Sello id."
},
"sku": {
"description": "Your private SKU.",
"type": "string",
"minLength": 1
},
"quantity": {
"type": "integer",
"minimum": 0,
"maximum": 1000000,
"description": "New stock quantity (absolute, not a change)."
}
},
"required": [
"quantity"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence