Servers Playground How we check Add a server Log in

Veeqo MCP by usefulapi

Working · 896 ms

io.usefulapi/veeqov1.8.0 Domain verified

Read Veeqo orders, products, stock, warehouses, customers and POs; add notes, tag, set stock.

Commerce

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://veeqo.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

veeqo_add_order_note Destructive

WRITE: add an internal (employee) note to an order, e.g. 'Customer asked for gift wrap'. It is visible to your Veeqo team on the order; it is not emailed to the customer. Notes cannot be deleted through the API. POST /orders/{order_id}/notes.

textstring, required

The note text.

order_idinteger, required

Veeqo order id.

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Veeqo MCP by usefulapi MCP server | mcptry

Tools (22)

veeqo_add_order_note

destructive

Argument	Type	Description
text*	string	The note text.
order_id*	integer	Veeqo order id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "order_id",
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "description": "The note text."
    },
    "order_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Veeqo order id.",
      "exclusiveMinimum": 0
    }
  }
}

veeqo_get_company

The Veeqo company this API key belongs to: id, name, product (e.g. veeqo-shipping), paying/trial state, address and company settings (currency, weight/dimension units, timezone). The employee list and billing internals are not returned. GET /current_company.

read-only

No arguments.

Input schema (JSON)

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

veeqo_get_customer

One customer by id with billing and shipping addresses and notes. GET /customers/{id}.

read-only

Argument	Type	Description
customer_id*	integer	Veeqo customer id.

Input schema (JSON)

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

veeqo_get_order

One order by id: status, totals, line items (sellable ids, SKUs, quantities), customer and delivery address, store, notes, tags, allocations and shipments with tracking numbers. GET /orders/{id}.

read-only

Argument	Type	Description
order_id*	integer	Veeqo order id (not the store's order number — find it with veeqo_list_orders query).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "order_id"
  ],
  "properties": {
    "order_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Veeqo order id (not the store's order number — find it with veeqo_list_orders query).",
      "exclusiveMinimum": 0
    }
  }
}

veeqo_get_order_returns

Returns (RMAs) recorded on an order for one of its sellables: return number, status, reason, returned line items and received quantities. Veeqo's reference requires the sellable id (an order line item's sellable.id). GET /orders/{id}/returns?sellable_id=.

read-only

Argument	Type	Description
order_id*	integer	Veeqo order id.
sellable_id*	integer	Sellable (variant) id of the returned item — veeqo_get_order → line_items[].sellable.id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "order_id",
    "sellable_id"
  ],
  "properties": {
    "order_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Veeqo order id.",
      "exclusiveMinimum": 0
    },
    "sellable_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Sellable (variant) id of the returned item — veeqo_get_order → line_items[].sellable.id.",
      "exclusiveMinimum": 0
    }
  }
}

veeqo_get_product

One product by id with all sellables (variants), prices, weights, customs data and stock entries per warehouse. GET /products/{id}.

read-only

Argument	Type	Description
product_id*	integer	Veeqo product id.

Input schema (JSON)

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

veeqo_get_purchase_order

One purchase order by id with supplier, destination warehouse and every line item. Paid Veeqo plans only. GET /purchase_orders/{id}.

read-only

Argument	Type	Description
purchase_order_id*	integer	Veeqo purchase order id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "purchase_order_id"
  ],
  "properties": {
    "purchase_order_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Veeqo purchase order id.",
      "exclusiveMinimum": 0
    }
  }
}

veeqo_get_shipment_tracking

Tracking events (timestamp, status, description, location) for a shipment. Available when the label was bought in Veeqo. The shipment id is in an order's allocations[].shipment. GET /shipping/tracking_events/{shipment_id}.

read-only

Argument	Type	Description
shipment_id*	integer	Veeqo shipment id (from veeqo_get_order → allocations[].shipment.id).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "shipment_id"
  ],
  "properties": {
    "shipment_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Veeqo shipment id (from veeqo_get_order → allocations[].shipment.id).",
      "exclusiveMinimum": 0
    }
  }
}

veeqo_get_stock_entry

Stock of one sellable (variant) in one warehouse: physical, allocated, available, incoming (purchase orders) and in-transit levels, bin location and the low-stock flag. GET /sellables/{sellable_id}/warehouses/{warehouse_id}/stock_entry.

read-only

Argument	Type	Description
sellable_id*	integer	Sellable (variant) id — product.sellables[].id, not the product id.
warehouse_id*	integer	Warehouse id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "sellable_id",
    "warehouse_id"
  ],
  "properties": {
    "sellable_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Sellable (variant) id — product.sellables[].id, not the product id.",
      "exclusiveMinimum": 0
    },
    "warehouse_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Warehouse id.",
      "exclusiveMinimum": 0
    }
  }
}

veeqo_get_supplier

One supplier by id (bank details are not returned). Paid Veeqo plans only. GET /suppliers/{id}.

read-only

Argument	Type	Description
supplier_id*	integer	Veeqo supplier id.

Input schema (JSON)

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

veeqo_get_warehouse

One warehouse by id. GET /warehouses/{id}.

read-only

Argument	Type	Description
warehouse_id*	integer	Veeqo warehouse id.

Input schema (JSON)

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

veeqo_list_customers

List or search customers with email, phone, billing address and shipping addresses. GET /customers.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
query	string	Free-text search, e.g. an email address or name.
page_size	integer	Results per page, 1-100 (default 25).
customer_type	string	Customer type.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Free-text search, e.g. an email address or name."
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page, 1-100 (default 25).",
      "exclusiveMinimum": 0
    },
    "customer_type": {
      "enum": [
        "retail",
        "business"
      ],
      "type": "string",
      "description": "Customer type."
    }
  }
}

veeqo_list_delivery_methods

List the delivery methods orders can use (id, name, cost). GET /delivery_methods.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
page_size	integer	Results per page, 1-100 (default 25).

Input schema (JSON)

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

veeqo_list_orders

List or search orders, newest first, with line items, customer, delivery address, store, allocations and shipments (tracking numbers). Filter by status, store, tag, free text, created/due date or update time. GET /orders.

read-only

Argument	Type	Description
tag	string	Only orders carrying the tag with this exact name.
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
query	string	Free-text search (order number, customer name, email, SKU...).
status	string	Order status.
since_id	integer	Only orders with an id greater than this.
due_after	string	Only orders due on or after this date (yyyy-mm-dd).
page_size	integer	Results per page, 1-100 (default 25).
due_before	string	Only orders due on or before this date, whole day included (yyyy-mm-dd).
channel_ids	array

veeqo_list_products

List or search products with their sellables (variants): SKU, UPC, price, cost, and per-warehouse stock entries (physical, allocated, available). GET /products.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
query	string	Search by product name or SKU.
since_id	integer	Only products with an id greater than this.
page_size	integer	Results per page, 1-100 (default 25).
warehouse_id	integer	Only products with stock in this warehouse.
created_since	string	Only products created at or after this ISO 8601 date-time with timezone.
updated_since	string	Only products updated at or after this ISO 8601 date-time with timezone.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Search by product name or SKU."
    },
    "since_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only products with an id greater than this.",
      "exclusiveMinimum": 0
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page, 1-100 (default 25).",
      "exclusiveMinimum": 0
    },
    "warehouse_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only products with stock in this warehouse.",
      "exclusiveMinimum": 0
    },
    "created_since": {
      "type": "string",
      "description": "Only products created at or after this ISO 8601 date-time with timezone."
    },
    "updated_since": {
      "type": "string",
      "description": "Only products updated at or after this ISO 8601 date-time with timezone."
    }
  }
}

veeqo_list_purchase_orders

List or search purchase orders with supplier, destination warehouse and line items (ordered/received quantities, cost). Search-index backed, so a just-changed PO may be stale here — confirm with veeqo_get_purchase_order. Paid Veeqo plans only. GET /purchase_orders.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
order	string	Sort direction, used with sort_by.
query	string	Search supplier name/post code, PO number, reference, SKU, UPC or item title.
state	string	Lifecycle state (draft/active/completed) or a received-status filter (not_received, partially_received, fully_received, past_due, all). Default: all states including drafts.
sort_by	string	Sort field (default created_at, newest first).
page_size	integer	Results per page, 1-100 (default 25).
sellable_id	integer	Only active POs containing this sellable (variant) id.
supplier_id	integer

veeqo_list_stores

List the sales channels (stores) connected to Veeqo — Amazon, eBay, Shopify, POS, etc. — with id, name, type and state. Use the ids to filter orders by store. Marketplace credentials and integration settings are never returned. GET /channels.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
page_size	integer	Results per page, 1-100 (default 25).

Input schema (JSON)

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

veeqo_list_suppliers

List suppliers with address, sales/accounting contacts, currency, credit limit and open/completed purchase-order counts (bank details are not returned). Paid Veeqo plans only. GET /suppliers.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
page_size	integer	Results per page, 1-100 (default 25).

Input schema (JSON)

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

veeqo_list_tags

All tags in the account (id, name, colour, how many records use it). Use the ids with veeqo_tag_orders. GET /tags.

read-only

No arguments.

Input schema (JSON)

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

veeqo_list_warehouses

List warehouses with address, phone and dispatch cut-off times. Use the ids for stock levels and warehouse filters. GET /warehouses.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
page_size	integer	Results per page, 1-100 (default 25).
external_id	string	Only the warehouse with this external id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page, 1-100 (default 25).",
      "exclusiveMinimum": 0
    },
    "external_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Only the warehouse with this external id."
    }
  }
}

veeqo_set_stock_level

WRITE: set the physical stock level of ONE sellable in ONE warehouse (a stock count correction), optionally its bin location. This overwrites the current on-hand quantity, and Veeqo may push the new available stock to the connected sales channels. The entry's infinite-stock setting is read first and kept as it is (this tool never changes it). Veeqo marks this endpoint 'Paid plan only'. GET then PUT /sellables/{sellable_id}/warehouses/{warehouse_id}/stock_entry.

destructive

Argument	Type	Description
location	string	Bin/shelf location in the warehouse, e.g. 'Shelf 2B'.
sellable_id*	integer	Sellable (variant) id.
warehouse_id*	integer	Warehouse id.
physical_stock_level*	integer	New physical (on-hand) quantity.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "sellable_id",
    "warehouse_id",
    "physical_stock_level"
  ],
  "properties": {
    "location": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Bin/shelf location in the warehouse, e.g. 'Shelf 2B'."
    },
    "sellable_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Sellable (variant) id.",
      "exclusiveMinimum": 0
    },
    "warehouse_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Warehouse id.",
      "exclusiveMinimum": 0
    },
    "physical_stock_level": {
      "type": "integer",
      "maximum": 10000000,
      "minimum": 0,
      "description": "New physical (on-hand) quantity."
    }
  }
}

veeqo_tag_orders

WRITE: apply existing tags (ids from veeqo_list_tags) to up to 50 orders. Tags can drive Veeqo automation rules and filters. Tagging an order that already has the tag changes nothing. POST /bulk_tagging.

destructive

Argument	Type	Description
tag_ids*	array	Tag ids to apply (1-10).
order_ids*	array	Veeqo order ids to tag (1-50).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "order_ids",
    "tag_ids"
  ],
  "properties": {
    "tag_ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 9007199254740991,
        "exclusiveMinimum": 0
      },
      "maxItems": 10,
      "minItems": 1,
      "description": "Tag ids to apply (1-10)."
    },
    "order_ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 9007199254740991,
        "exclusiveMinimum": 0
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "Veeqo order ids to tag (1-50)."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "tag": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Only orders carrying the tag with this exact name."
    },
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Free-text search (order number, customer name, email, SKU...)."
    },
    "status": {
      "enum": [
        "awaiting_payment",
        "awaiting_stock",
        "awaiting_fulfillment",
        "shipped",
        "on_hold",
        "cancelled",
        "refunded"
      ],
      "type": "string",
      "description": "Order status."
    },
    "since_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only orders with an id greater than this.",
      "exclusiveMinimum": 0
    },
    "due_after": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "Only orders due on or after this date (yyyy-mm-dd)."
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page, 1-100 (default 25).",
      "exclusiveMinimum": 0
    },
    "due_before": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "Only orders due on or before this date, whole day included (yyyy-mm-dd)."
    },
    "channel_ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 9007199254740991,
        "exclusiveMinimum": 0
      },
      "maxItems": 20,
      "minItems": 1,
      "description": "Only orders from these store (channel) ids — see veeqo_list_stores."
    },
    "created_after": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "Only orders created on or after this date (yyyy-mm-dd)."
    },
    "updated_since": {
      "type": "string",
      "description": "Only orders updated at or after this ISO 8601 date-time with timezone (sent in UTC)."
    },
    "created_before": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "Only orders created on or before this date, whole day included (yyyy-mm-dd)."
    },
    "allocated_at_warehouse_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only orders allocated at this warehouse id.",
      "exclusiveMinimum": 0
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "Sort direction, used with sort_by."
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Search supplier name/post code, PO number, reference, SKU, UPC or item title."
    },
    "state": {
      "enum": [
        "draft",
        "active",
        "completed",
        "not_received",
        "partially_received",
        "fully_received",
        "past_due",
        "all"
      ],
      "type": "string",
      "description": "Lifecycle state (draft/active/completed) or a received-status filter (not_received, partially_received, fully_received, past_due, all). Default: all states including drafts."
    },
    "sort_by": {
      "enum": [
        "supplier_name",
        "created_at",
        "expected_date",
        "estimated_delivery_days"
      ],
      "type": "string",
      "description": "Sort field (default created_at, newest first)."
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page, 1-100 (default 25).",
      "exclusiveMinimum": 0
    },
    "sellable_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only active POs containing this sellable (variant) id.",
      "exclusiveMinimum": 0
    },
    "supplier_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only POs for this supplier.",
      "exclusiveMinimum": 0
    },
    "created_after": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "Created on or after this date (yyyy-mm-dd)."
    },
    "updated_since": {
      "type": "string",
      "description": "Updated at or after this ISO 8601 date-time with timezone."
    },
    "created_before": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "Created on or before this date, whole day included (yyyy-mm-dd)."
    },
    "reference_number": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Exact PO reference number."
    },
    "destination_warehouse_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only POs delivering to this warehouse.",
      "exclusiveMinimum": 0
    }
  }
}