SalesDrive MCP by usefulapi
Read and update orders, add order notes, and find managers by phone in SalesDrive.
Should I use this
Quality & Safety
Findings (3)
- LOWin salesdrive_list_payment_methods
- LOWin salesdrive_list_delivery_methods
- LOWin salesdrive_find_contact_by_phone
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": {
"salesdrive": {
"url": "https://salesdrive.usefulapi.io/mcp"
}
}
}Remote endpoints
https://salesdrive.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (8)
π’salesdrive_list_orders(page, limit, status_ids, order_id_from, order_id_to, ...)
List orders (Π·Π°ΡΠ²ΠΊΠΈ) with their status, contact, products, delivery and payment fields. Filter by status, order number range, change date, order date or organization. At most 100 per page. SalesDrive API: GET /api/order/list/.
Input Schema
{
"type": "object",
"properties": {
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Orders per page, 1-100 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"status_ids": {
"description": "Status ids, or __NOTDELETED__ (default: all except deleted) or __ALL__.",
"maxItems": 20,
"type": "array",
"items": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"const": "__NOTDELETED__"
},
{
"type": "string",
"const": "__ALL__"
}
]
}
},
"order_id_from": {
"description": "Lowest order number.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"order_id_to": {
"description": "Highest order number.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"updated_from": {
"description": "Order changed on or after this time.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$"
},
"updated_to": {
"description": "Order changed on or before this time.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$"
},
"order_time_from": {
"description": "Order placed on or after this time.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$"
},
"order_time_to": {
"description": "Order placed on or before this time.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$"
},
"organization_id": {
"description": "Organization id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’salesdrive_get_order(order_id)
Get one order by its order number. Returns the order object, or a message when no order has that number. SalesDrive API: GET /api/order/list/ with filter[id].
Input Schema
{
"type": "object",
"properties": {
"order_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "SalesDrive order number (Π·Π°ΡΠ²ΠΊΠΈ id)."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’salesdrive_list_statuses
List the order statuses of the account with their ids and type (1 in progress, 2 sale, 3 unsuccessful, 4 deleted). Use the ids in salesdrive_update_order. SalesDrive API: GET /api/statuses/.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’salesdrive_list_payment_methods
List the payment methods of the account with their ids. SalesDrive API: GET /api/payment-methods/.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’salesdrive_list_delivery_methods
List the delivery methods of the account with their ids. SalesDrive API: GET /api/delivery-methods/.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π’salesdrive_find_contact_by_phone(phone)
Find the client and the responsible manager for a phone number. Returns the manager (name, internal number) and the client record, if one matches. SalesDrive API: GET /api/get_manager_by_phone_number/.
Input Schema
{
"type": "object",
"properties": {
"phone": {
"type": "string",
"pattern": "^\\+?[0-9 ()-]{5,20}$",
"description": "Phone number, for example +380501112233."
}
},
"required": [
"phone"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π‘salesdrive_update_order(order_id, external_id, data)
Update an order's fields, for example statusId (order status), salesdrive_manager (responsible manager), comment, or paymentDate. Give order_id or external_id. Sends only the fields you pass. The API cannot change the city, branch or address of a Nova Poshta or Ukrposhta delivery. SalesDrive API: POST /api/order/update/.
Input Schema
{
"type": "object",
"properties": {
"order_id": {
"description": "SalesDrive order number. Use this or external_id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"external_id": {
"description": "Your own order number. Ignored when order_id is given.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Fields to set, for example { statusId: 1065 }. Use salesdrive_list_statuses for status ids."
}
},
"required": [
"data"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}π΄salesdrive_add_order_note(order_id, text)
Add a note to an order's client communications block. The note gets the current time. Each call adds a new note. SalesDrive API: POST /api/order/note/.
Input Schema
{
"type": "object",
"properties": {
"order_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "SalesDrive order number (Π·Π°ΡΠ²ΠΊΠΈ id)."
},
"text": {
"type": "string",
"minLength": 1,
"maxLength": 5000,
"description": "Note text."
}
},
"required": [
"order_id",
"text"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence