SalesDrive MCP by usefulapi

Read and update orders, add order notes, and find managers by phone in SalesDrive.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
73%
Naming quality
73%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (3)

  • LOWTool 'salesdrive_list_payment_methods' name length outside 3-30 rangein salesdrive_list_payment_methods
  • LOWTool 'salesdrive_list_delivery_methods' name length outside 3-30 rangein salesdrive_list_delivery_methods
  • LOWTool 'salesdrive_find_contact_by_phone' name length outside 3-30 rangein salesdrive_find_contact_by_phone

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,490Tokens (tool definitions)
~1.2 KBTypical response size
Moderate attention impact (1.16% 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": {
    "salesdrive": {
      "url": "https://salesdrive.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

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

What it can do

Tool inventory

Tools (8)

🟒 Read-only🟑 WriteπŸ”΄ Deleteβšͺ Unknown
🟒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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded8 tools