Channable MCP by usefulapi is an MCP server published by io.usefulapi, hosted at channable.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 13 tools, including channable_list_orders, channable_get_order, channable_ship_order, channable_cancel_order, channable_mark_order_manual.
Read marketplace orders and returns; send shipment, cancellation and stock updates.
4,096 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
List the marketplace orders of a project, newest first. Filters combine with AND; dates are read as UTC. Paged: pass next_offset as offset (total is the size of the page, not of all orders). Reply: orders, error_count (orders with an error), count, next_offset. GET /v2/companies/{company}/projects/{project}/orders.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-100 (default 100). |
| errors | boolean | true = only orders with an error. |
| offset | integer | Skip this many results (default 0). Use next_offset from the previous reply. |
| search | string | Free-text search (order ids, names, products). |
| status |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| array |
| Only orders in one of these statuses: shipped, not_shipped, waiting, cancelled, processing, pending_shipment, pending_cancellation, cancellation_request, awaiting_confirmation, partial, manual. |
| end_date | string | Orders created on or before this date. |
| project_id | integer | Channable project id (Project settings). Default: the project chosen at login. |
| start_date | string | Orders created on or after this date (yyyy-mm-dd or ISO 8601, UTC). |
| retrieved_at_end | string | Orders retrieved from the marketplace on or before this date. |
| retrieved_at_start | string | Orders retrieved from the marketplace on or after this date. |
| last_modified_after | string | Orders modified after this date. |
| last_modified_before | string | Orders modified before this date. |
{
"name": "channable_list_orders",
"title": "List orders",
"description": "List the marketplace orders of a project, newest first. Filters combine with AND; dates are read as UTC. Paged: pass next_offset as offset (total is the size of the page, not of all orders). Reply: orders, error_count (orders with an error), count, next_offset. GET /v2/companies/{company}/projects/{project}/orders.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 100)."
},
"errors": {
"type": "boolean",
"description": "true = only orders with an error."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Skip this many results (default 0). Use next_offset from the previous reply."
},
"search": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Free-text search (order ids, names, products)."
},
"status": {
"type": "array",
"items": {
"enum": [
"shipped",
"not_shipped",
"waiting",
"cancelled",
"processing",
"pending_shipment",
"pending_cancellation",
"cancellation_request",
"awaiting_confirmation",
"partial",
"manual"
],
"type": "string"
},
"maxItems": 11,
"minItems": 1,
"description": "Only orders in one of these statuses: shipped, not_shipped, waiting, cancelled, processing, pending_shipment, pending_cancellation, cancellation_request, awaiting_confirmation, partial, manual."
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "Orders created on or before this date."
},
"project_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Channable project id (Project settings). Default: the project chosen at login.",
"exclusiveMinimum": 0
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "Orders created on or after this date (yyyy-mm-dd or ISO 8601, UTC)."
},
"retrieved_at_end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "Orders retrieved from the marketplace on or before this date."
},
"retrieved_at_start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "Orders retrieved from the marketplace on or after this date."
},
"last_modified_after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "Orders modified after this date."
},
"last_modified_before": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "Orders modified before this date."
}
}
},
"annotations": {
"title": "List orders",
"readOnlyHint": true
}
}One order with its customer, addresses, items, status, fulfillments and event log. order_id is the Channable order id (the id field from channable_list_orders). GET /v2/companies/{company}/projects/{project}/orders/{order_id}.
| Parameter | Type | Description |
|---|---|---|
| order_id * | integer | Channable order id. |
| project_id | integer | Channable project id (Project settings). Default: the project chosen at login. |
{
"name": "channable_get_order",
"title": "Get an order",
"description": "One order with its customer, addresses, items, status, fulfillments and event log. order_id is the Channable order id (the id field from channable_list_orders). GET /v2/companies/{company}/projects/{project}/orders/{order_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Channable order id.",
"exclusiveMinimum": 0
},
"project_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Channable project id (Project settings). Default: the project chosen at login.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get an order",
"readOnlyHint": true
}
}Set an order to shipped, with tracking data. Give transporter as a Channable transporter code (channable_list_transporters lists them) and tracking_code. Pass order_item_ids to ship only some items (the order then becomes partial; repeat with the other items later); omit it to ship the whole order. Spartoo and Veepee do not support partial shipments. POST /v1/companies/{company}/projects/{project}/orders/{order_id}/shipment. Channable passes this change on to the marketplace. It cannot be undone through this API and the call is never retried; if it times out, check the order in Channable before trying again.
| Parameter | Type | Description |
|---|---|---|
| order_id * | integer | Channable order id. |
| project_id | integer | Channable project id (Project settings). Default: the project chosen at login. |
| transporter | string | Channable transporter code, e.g. POSTNL, DHL, DPD. |
| tracking_code | string | Track and trace code of the parcel. |
| order_item_ids | array | Only these order items are shipped (partial shipment). Omit to ship all. |
| delivery_bill_id | string | Delivery bill id, if the marketplace asks for it. |
| return_transporter | string | Transporter code for the return label, if the marketplace asks for it. |
| return_tracking_code | string | Track and trace code of the return label. |
{
"name": "channable_ship_order",
"title": "Mark an order as shipped",
"description": "Set an order to shipped, with tracking data. Give transporter as a Channable transporter code (channable_list_transporters lists them) and tracking_code. Pass order_item_ids to ship only some items (the order then becomes partial; repeat with the other items later); omit it to ship the whole order. Spartoo and Veepee do not support partial shipments. POST /v1/companies/{company}/projects/{project}/orders/{order_id}/shipment. Channable passes this change on to the marketplace. It cannot be undone through this API and the call is never retried; if it times out, check the order in Channable before trying again.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Channable order id.",
"exclusiveMinimum": 0
},
"project_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Channable project id (Project settings). Default: the project chosen at login.",
"exclusiveMinimum": 0
},
"transporter": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Channable transporter code, e.g. POSTNL, DHL, DPD."
},
"tracking_code": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Track and trace code of the parcel."
},
"order_item_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Channable order item id.",
"exclusiveMinimum": 0
},
"maxItems": 500,
"minItems": 1,
"description": "Only these order items are shipped (partial shipment). Omit to ship all."
},
"delivery_bill_id": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Delivery bill id, if the marketplace asks for it."
},
"return_transporter": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Transporter code for the return label, if the marketplace asks for it."
},
"return_tracking_code": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Track and trace code of the return label."
}
}
},
"annotations": {
"title": "Mark an order as shipped",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Seller-side cancellation: set an order to cancelled. Pass order_item_ids to cancel only some items (the order then becomes partial); omit it to cancel the whole order. Amazon, Cdiscount and Spartoo do not support partial cancellations. A buyer-side cancellation must be confirmed in the marketplace seller account instead. POST /v1/companies/{company}/projects/{project}/orders/{order_id}/cancel. Channable passes this change on to the marketplace. It cannot be undone through this API and the call is never retried; if it times out, check the order in Channable before trying again.
| Parameter | Type | Description |
|---|---|---|
| order_id * | integer | Channable order id. |
| project_id | integer | Channable project id (Project settings). Default: the project chosen at login. |
| order_item_ids | array | Only these order items are cancelled (partial cancellation). Omit to cancel all. |
{
"name": "channable_cancel_order",
"title": "Cancel an order",
"description": "Seller-side cancellation: set an order to cancelled. Pass order_item_ids to cancel only some items (the order then becomes partial); omit it to cancel the whole order. Amazon, Cdiscount and Spartoo do not support partial cancellations. A buyer-side cancellation must be confirmed in the marketplace seller account instead. POST /v1/companies/{company}/projects/{project}/orders/{order_id}/cancel. Channable passes this change on to the marketplace. It cannot be undone through this API and the call is never retried; if it times out, check the order in Channable before trying again.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Channable order id.",
"exclusiveMinimum": 0
},
"project_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Channable project id (Project settings). Default: the project chosen at login.",
"exclusiveMinimum": 0
},
"order_item_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Channable order item id.",
"exclusiveMinimum": 0
},
"maxItems": 500,
"minItems": 1,
"description": "Only these order items are cancelled (partial cancellation). Omit to cancel all."
}
}
},
"annotations": {
"title": "Cancel an order",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Tell Channable that you handle this order yourself: Channable takes no further action on it (no status updates to the marketplace). POST /v1/companies/{company}/projects/{project}/orders/{order_id}/manual. Channable passes this change on to the marketplace. It cannot be undone through this API and the call is never retried; if it times out, check the order in Channable before trying again.
| Parameter | Type | Description |
|---|---|---|
| order_id * | integer | Channable order id. |
| project_id | integer | Channable project id (Project settings). Default: the project chosen at login. |
{
"name": "channable_mark_order_manual",
"title": "Mark an order as handled manually",
"description": "Tell Channable that you handle this order yourself: Channable takes no further action on it (no status updates to the marketplace). POST /v1/companies/{company}/projects/{project}/orders/{order_id}/manual. Channable passes this change on to the marketplace. It cannot be undone through this API and the call is never retried; if it times out, check the order in Channable before trying again.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Channable order id.",
"exclusiveMinimum": 0
},
"project_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Channable project id (Project settings). Default: the project chosen at login.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Mark an order as handled manually",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Manually create a return on the marketplace for products of an order. Only Fruugo, Otto, Veepee and Zalando support this. products lists the product ids (the item id of the order), the quantity and optionally accepted or rejected. POST /v1/companies/{company}/projects/{project}/orders/{order_id}/return. Channable passes this change on to the marketplace. It cannot be undone through this API and the call is never retried; if it times out, check the order in Channable before trying again.
| Parameter | Type | Description |
|---|---|---|
| order_id * | integer | Channable order id. |
| products * | array | The products to return. |
| project_id | integer | Channable project id (Project settings). Default: the project chosen at login. |
{
"name": "channable_create_return",
"title": "Create a return for an order",
"description": "Manually create a return on the marketplace for products of an order. Only Fruugo, Otto, Veepee and Zalando support this. products lists the product ids (the item id of the order), the quantity and optionally accepted or rejected. POST /v1/companies/{company}/projects/{project}/orders/{order_id}/return. Channable passes this change on to the marketplace. It cannot be undone through this API and the call is never retried; if it times out, check the order in Channable before trying again.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id",
"products"
],
"properties": {
"order_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Channable order id.",
"exclusiveMinimum": 0
},
"products": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"quantity"
],
"properties": {
"id": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Product id as in the order item."
},
"status": {
"enum": [
"accepted",
"rejected"
],
"type": "string",
"description": "accepted or rejected (omit for the marketplace default)."
},
"quantity": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Quantity to return."
}
}
},
"maxItems": 200,
"minItems": 1,
"description": "The products to return."
},
"project_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Channable project id (Project settings). Default: the project chosen at login.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Create a return for an order",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}List the returns of a project, newest first. Dates are read as UTC. Paged: pass next_offset as offset. Reply: returns, error_count, count, next_offset. GET /v1/companies/{company}/projects/{project}/returns.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-100 (default 100). |
| errors | boolean | true = only returns with an error. |
| offset | integer | Skip this many results (default 0). Use next_offset from the previous reply. |
| search | string | Free-text search. |
| end_date | string | Returns created on or before this date. |
| project_id | integer | Channable project id (Project settings). Default: the project chosen at login. |
| start_date | string | Returns created on or after this date (yyyy-mm-dd or ISO 8601, UTC). |
| retrieved_at_end | string | Returns retrieved on or before this date. |
| retrieved_at_start | string | Returns retrieved on or after this date. |
| last_modified_after | string | Returns modified after this date. |
| last_modified_before | string | Returns modified before this date. |
{
"name": "channable_list_returns",
"title": "List returns",
"description": "List the returns of a project, newest first. Dates are read as UTC. Paged: pass next_offset as offset. Reply: returns, error_count, count, next_offset. GET /v1/companies/{company}/projects/{project}/returns.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 100)."
},
"errors": {
"type": "boolean",
"description": "true = only returns with an error."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Skip this many results (default 0). Use next_offset from the previous reply."
},
"search": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Free-text search."
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "Returns created on or before this date."
},
"project_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Channable project id (Project settings). Default: the project chosen at login.",
"exclusiveMinimum": 0
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "Returns created on or after this date (yyyy-mm-dd or ISO 8601, UTC)."
},
"retrieved_at_end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "Returns retrieved on or before this date."
},
"retrieved_at_start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "Returns retrieved on or after this date."
},
"last_modified_after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "Returns modified after this date."
},
"last_modified_before": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "Returns modified before this date."
}
}
},
"annotations": {
"title": "List returns",
"readOnlyHint": true
}
}One return with its item, reason, customer, status and log. return_id is the id field from channable_list_returns. GET /v1/companies/{company}/projects/{project}/returns/{return_id}.
| Parameter | Type | Description |
|---|---|---|
| return_id * | integer | Channable return id. |
| project_id | integer | Channable project id (Project settings). Default: the project chosen at login. |
{
"name": "channable_get_return",
"title": "Get a return",
"description": "One return with its item, reason, customer, status and log. return_id is the id field from channable_list_returns. GET /v1/companies/{company}/projects/{project}/returns/{return_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"return_id"
],
"properties": {
"return_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Channable return id.",
"exclusiveMinimum": 0
},
"project_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Channable project id (Project settings). Default: the project chosen at login.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a return",
"readOnlyHint": true
}
}Set the status of a return: accepted, rejected, repaired, keeps, exchanged, cancelled. Depending on the status the customer does or does not get their money back (accepted and cancelled differ from rejected). POST /v1/companies/{company}/projects/{project}/returns/{return_id}/status. Channable passes this change on to the marketplace. It cannot be undone through this API and the call is never retried; if it times out, check the order in Channable before trying again.
| Parameter | Type | Description |
|---|---|---|
| status * | string | The new return status. |
| return_id * | integer | Channable return id. |
| project_id | integer | Channable project id (Project settings). Default: the project chosen at login. |
{
"name": "channable_update_return_status",
"title": "Set the status of a return",
"description": "Set the status of a return: accepted, rejected, repaired, keeps, exchanged, cancelled. Depending on the status the customer does or does not get their money back (accepted and cancelled differ from rejected). POST /v1/companies/{company}/projects/{project}/returns/{return_id}/status. Channable passes this change on to the marketplace. It cannot be undone through this API and the call is never retried; if it times out, check the order in Channable before trying again.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"return_id",
"status"
],
"properties": {
"status": {
"enum": [
"accepted",
"rejected",
"repaired",
"keeps",
"exchanged",
"cancelled"
],
"type": "string",
"description": "The new return status."
},
"return_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Channable return id.",
"exclusiveMinimum": 0
},
"project_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Channable project id (Project settings). Default: the project chosen at login.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Set the status of a return",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}List the offers (product stock updates) that were posted to a project, newest first: id, stock, price, title, GTIN. Paged: pass next_offset as offset. Reply: offers, count, next_offset. GET /v1/companies/{company}/projects/{project}/offers.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-100 (default 100). |
| offset | integer | Skip this many results (default 0). Use next_offset from the previous reply. |
| search | string | Free-text search (offer id, title, GTIN). |
| end_date | string | Offers created on or before this date. |
| project_id | integer | Channable project id (Project settings). Default: the project chosen at login. |
| start_date | string | Offers created on or after this date (UTC). |
| last_modified_after | string | Offers modified after this date. |
| last_modified_before | string | Offers modified before this date. |
{
"name": "channable_list_stock_updates",
"title": "List posted stock updates",
"description": "List the offers (product stock updates) that were posted to a project, newest first: id, stock, price, title, GTIN. Paged: pass next_offset as offset. Reply: offers, count, next_offset. GET /v1/companies/{company}/projects/{project}/offers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 100)."
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Skip this many results (default 0). Use next_offset from the previous reply."
},
"search": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Free-text search (offer id, title, GTIN)."
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "Offers created on or before this date."
},
"project_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Channable project id (Project settings). Default: the project chosen at login.",
"exclusiveMinimum": 0
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "Offers created on or after this date (UTC)."
},
"last_modified_after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "Offers modified after this date."
},
"last_modified_before": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "Offers modified before this date."
}
}
},
"annotations": {
"title": "List posted stock updates",
"readOnlyHint": true
}
}Set the stock of up to 50 offers. Each item is the offer id as the marketplaces know it, plus the WHOLE new stock value (not a delta). Channable passes the new stock to every marketplace of the project, which changes what customers can buy. POST /v1/companies/{company}/projects/{project}/stock_updates. Channable passes this change on to the marketplace. It cannot be undone through this API and the call is never retried; if it times out, check the order in Channable before trying again.
| Parameter | Type | Description |
|---|---|---|
| updates * | array | 1-50 stock updates. |
| project_id | integer | Channable project id (Project settings). Default: the project chosen at login. |
{
"name": "channable_update_stock",
"title": "Update product stock on all marketplaces",
"description": "Set the stock of up to 50 offers. Each item is the offer id as the marketplaces know it, plus the WHOLE new stock value (not a delta). Channable passes the new stock to every marketplace of the project, which changes what customers can buy. POST /v1/companies/{company}/projects/{project}/stock_updates. Channable passes this change on to the marketplace. It cannot be undone through this API and the call is never retried; if it times out, check the order in Channable before trying again.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"updates"
],
"properties": {
"updates": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"stock"
],
"properties": {
"id": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Offer id (the id of the product in your feed / on the marketplace)."
},
"gtin": {
"type": "string",
"maxLength": 32,
"minLength": 1,
"description": "GTIN, shown in Channable only."
},
"stock": {
"type": "integer",
"maximum": 100000000,
"minimum": 0,
"description": "The whole new stock value, not a delta."
}
}
},
"maxItems": 50,
"minItems": 1,
"description": "1-50 stock updates."
},
"project_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Channable project id (Project settings). Default: the project chosen at login.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Update product stock on all marketplaces",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}Order statistics of a project for a time frame: orders, ordered products, marketplace commission, shipping costs, revenue and daily revenue, per order connection and in total. Pass order_config_id (the order_config_id field of an order) for one order connection only. GET /v1/companies/{company}/projects/{project}/statistics/orders[/{order_config_id}].
| Parameter | Type | Description |
|---|---|---|
| end_date | string | Last day. |
| project_id | integer | Channable project id (Project settings). Default: the project chosen at login. |
| start_date | string | First day (yyyy-mm-dd or ISO 8601, UTC). |
| order_config_id | integer | Only this order connection (the order_config_id of an order). |
{
"name": "channable_get_order_statistics",
"title": "Get order statistics",
"description": "Order statistics of a project for a time frame: orders, ordered products, marketplace commission, shipping costs, revenue and daily revenue, per order connection and in total. Pass order_config_id (the order_config_id field of an order) for one order connection only. GET /v1/companies/{company}/projects/{project}/statistics/orders[/{order_config_id}].",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "Last day."
},
"project_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Channable project id (Project settings). Default: the project chosen at login.",
"exclusiveMinimum": 0
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "First day (yyyy-mm-dd or ISO 8601, UTC)."
},
"order_config_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this order connection (the order_config_id of an order).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get order statistics",
"readOnlyHint": true
}
}Channable transporter codes for shipping updates. With no argument: all codes and labels (transporter_code is what channable_ship_order expects). With transporter_code: the marketplace-specific carriers behind that code. With channel (a marketplace such as bol, amazon, ebay): the carriers that marketplace supports. Give at most one of the two. GET /v1/transporters/all | /transporter/{code} | /channel/{channel}.
| Parameter | Type | Description |
|---|---|---|
| channel | string | A marketplace name, lowercase, e.g. bol, amazon, ebay, otto. |
| transporter_code | string | A Channable transporter code, e.g. DHL. |
{
"name": "channable_list_transporters",
"title": "List transporter codes",
"description": "Channable transporter codes for shipping updates. With no argument: all codes and labels (transporter_code is what channable_ship_order expects). With transporter_code: the marketplace-specific carriers behind that code. With channel (a marketplace such as bol, amazon, ebay): the carriers that marketplace supports. Give at most one of the two. GET /v1/transporters/all | /transporter/{code} | /channel/{channel}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"channel": {
"type": "string",
"pattern": "^[a-z0-9_]{2,60}$",
"description": "A marketplace name, lowercase, e.g. bol, amazon, ebay, otto."
},
"transporter_code": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "A Channable transporter code, e.g. DHL."
}
}
},
"annotations": {
"title": "List transporter codes",
"readOnlyHint": true
}
}Tools for Channable, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "List marketplace orders waiting for shipment."; "Show returns received this week."; "Check the latest stock updates for a project.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Channable data. Free plan: 50 tool calls per month. Run channable_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run channable_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run channable_upgrade without a plan: it returns both plans, each with a payment link for the user to open. channable_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.