MCP server

Sortly MCP by usefulapi

io.usefulapi/sortly

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Search inventory items and folders, low-stock alerts, jobs and purchase orders, and update stock.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

20

Token cost

About 7,504 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http sortly https://sortly.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.sortly]
url = "https://sortly.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"sortly":{"httpUrl":"https://sortly.usefulapi.io/mcp"}}}

Cursor

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

VS Code

{"servers":{"sortly":{"type":"http","url":"https://sortly.usefulapi.io/mcp"}}}

Antigravity

agy mcp add sortly https://sortly.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"sortly","server_url":"https://sortly.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"sortly","server_url":"https://sortly.usefulapi.io/mcp"}

Tools

• sortly_create_alert ~477 tokens
  Create a stock alert on an item (type Quantity, e.g. threshold_method quantity_less_than with threshold_value 5, or less_than_or_equal_to_min_quantity), or a DateReminder on a datetime custom field (custom_attribute_id + before/after/same_day + threshold_interval). WRITE. Sortly: POST /api/v1/alerts
• sortly_create_item ~952 tokens
  Create a trackable item (type item) or a folder (type folder), optionally inside a folder via parent_id, with quantity, price, tags, custom fields, barcodes and a measured quantity. WRITE. Sortly: POST /api/v1/items.
• sortly_create_job ~395 tokens
  Create a job (and its job folder) in not_started status. Name must be unique in the company. Then use sortly_pull_items_into_job to record the stock it uses. WRITE. Sortly: POST /api/v1/jobs.
• sortly_create_purchase_order Moves money · ~973 tokens
  Create a purchase order in draft status (no stock or ordering happens until it is moved on in Sortly). Sortly computes amounts, sub_total and total from the lines; omit purchase_order_number to have one generated. Needs Purchase Orders on the plan (else 402). WRITE. Sortly: POST /api/v1/purchase_ord
• sortly_get_item ~186 tokens
  Fetch a single item or folder by numeric id: quantity, min_quantity, price, tags, sid, barcodes, and optionally custom field values and photos. Sortly: GET /api/v1/items/{item_id}.
• sortly_get_job ~128 tokens
  Fetch a single job: status, folder_id (where its pulled items sit), dates, notes, custom field values and the version needed for updates. Sortly: GET /api/v1/jobs/{job_id}.
• sortly_get_purchase_order ~145 tokens
  Fetch a single purchase order with its line_items (quantity vs received_quantity), vendor, addresses, charges, totals and version. Sortly: GET /api/v1/purchase_orders/{purchase_order_id}.
• sortly_get_purchase_order_receive_status ~171 tokens
  Report the most recent receive against a purchase order: pending / completed / failed, with the line ids received, pending and failed (and why). Returns 404 until something has been received. Sortly: GET /api/v1/purchase_orders/{purchase_order_id}/receive/status.
• sortly_list_alerts ~155 tokens
  List stock (Quantity) and date (DateReminder) alerts, with is_fired showing which have already triggered — the quick way to find low-stock items. Sortly: GET /api/v1/alerts.
• sortly_list_custom_fields ~160 tokens
  List the account's custom fields (id, name, type, applies_to). Call this before writing custom_attribute_values to get the right custom_attribute_id. Sortly: GET /api/v1/custom_fields.
• sortly_list_items ~305 tokens
  List items and folders, newest first. By default the root level; pass folder_id for a folder's direct contents, plus include_subfolders for everything nested under it. Paginated via meta.next_page_url / total_pages. Sortly: GET /api/v1/items.
• sortly_list_jobs ~294 tokens
  List jobs (work orders that pull stock out), most recently updated first, filterable by name prefix and status. Paginated via meta.pagination.has_next. Sortly: GET /api/v1/jobs.
• sortly_list_purchase_orders ~358 tokens
  List purchase orders, most recently updated first, filterable by PO number and status. The list leaves out notes, terms, sub_total and line_items — use sortly_get_purchase_order for those. Needs Purchase Orders on the plan (else 402). Sortly: GET /api/v1/purchase_orders.
• sortly_list_recently_updated_items ~339 tokens
  List items and folders changed since a Unix timestamp — the incremental-sync read ('what moved since yesterday?'). Without updated_since it behaves like sortly_list_items. Sortly: GET /api/v1/items/recent.
• sortly_list_units ~92 tokens
  List the units of measure available to the account (unit_name, unit_type, scale) — the values measured_quantity and purchase-order lines expect. Sortly: GET /api/v1/units.
• sortly_move_item ~294 tokens
  Move some or all of an item's quantity to another folder (items only — relocate a folder with sortly_update_item parent_id). A partial move splits off a new item with the same sid; a full move relocates the item; a matching item at the destination is merged, and the returned id is the destination's.
• sortly_pull_items_into_job ~391 tokens
  Move quantities of existing items (from any folders) into a job's folder — how usage on a job is recorded. Up to 100 items per call; items are processed independently, so ALWAYS check data.errors (a partial failure still returns 200). Undo with sortly_return_items_from_job. Returns 403 on a complete
• sortly_return_items_from_job ~400 tokens
  Move items off a job's folder back into inventory (destination_folder_id, or All Items if omitted). Up to 100 per call; check data.errors — items are processed one by one. WRITE. Sortly: POST /api/v1/jobs/{job_id}/items/return.
• sortly_search_items ~387 tokens
  Search items and folders by name, optionally limited to items or folders and scoped to specific folders. Read-only despite being a POST. Paginated: send the same arguments with the next page number. Sortly: POST /api/v1/items/search.
• sortly_update_item ~902 tokens
  Change fields on an existing item or folder — e.g. set a new quantity after a stock count, rename it, or relocate a folder via parent_id. Only the fields you pass change; pass null to clear a nullable field. Sending tags or custom_attribute_values replaces them. WRITE. Sortly: PUT /api/v1/items/{ite

Related MCP servers

• Farmbrite MCP by usefulapi
  Read Farmbrite livestock, crops, tasks, inventory and orders; log records and tasks.
• Sapo MCP by usefulapi
  Read Sapo store products, orders, customers and stock levels; edit order notes and stock.
• Order Desk MCP by usefulapi
  Search Order Desk orders and inventory; read order items and shipments; create or update orders.
• Linnworks MCP by usefulapi
  Read Linnworks inventory, stock and orders; set stock levels and add order notes.
• Hiboutik MCP by usefulapi
  Read Hiboutik products, stock, customers, sales and turnover; edit customers and sale comments.
• Loyverse MCP by usefulapi
  Query Loyverse POS receipts, shifts, items, inventory and customers, and update stock and customers.
• PHP Point of Sale MCP by usefulapi
  Read PHP Point of Sale items, sales, customers and 138 reports; manage customers, items, expenses.
• Megaventory MCP by usefulapi
  Read Megaventory products, stock, orders and partners; create clients, sales and purchase orders.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/sortly.svg)](https://aptlynx.net/servers/io.usefulapi/sortly)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents