Shift4Shop MCP by usefulapi is an MCP server published by io.usefulapi, hosted at shift4shop.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 13 tools, including shift4shop_list_orders, shift4shop_get_order, shift4shop_list_order_items, shift4shop_list_order_shipments, shift4shop_list_order_transactions.
Read orders, payments, shipments, customers, products and stock in Shift4Shop.
4,167 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 store orders, filterable by status, order (invoice) number, date range, last-update range or billing email. Use this first to find orders. Shift4Shop API: GET /Orders.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum number of items to return. |
| offset | integer | Starting point for the returned items (0 = first). |
| dateend | string | Orders placed before this time (mm/dd/yyyy hh:mm:ss). |
| countonly | boolean | Return only the number of matching rows. |
| datestart | string | Orders placed after this time (mm/dd/yyyy hh:mm:ss). |
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.
| orderstatus | string | Only orders in this status (see shift4shop_list_order_statuses). |
| billingemail | string | Billing email address of the order. |
| invoicenumber | string | Exact invoice (order) number. |
| invoiceprefix | string | Only orders whose invoice number has this prefix. |
| lastupdateend | string | Orders last updated before this date (mm/dd/yyyy). |
| lastupdatestart | string | Orders last updated after this date (mm/dd/yyyy). |
| invoicenumberend | string | Last invoice number of a range. |
| invoicenumberstart | string | First invoice number of a range. |
{
"name": "shift4shop_list_orders",
"title": "List orders",
"description": "List store orders, filterable by status, order (invoice) number, date range, last-update range or billing email. Use this first to find orders. Shift4Shop API: GET /Orders.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Maximum number of items to return.",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Starting point for the returned items (0 = first)."
},
"dateend": {
"type": "string",
"pattern": "^\\d{2}\\/\\d{2}\\/\\d{4}( \\d{2}:\\d{2}:\\d{2})?$",
"description": "Orders placed before this time (mm/dd/yyyy hh:mm:ss)."
},
"countonly": {
"type": "boolean",
"description": "Return only the number of matching rows."
},
"datestart": {
"type": "string",
"pattern": "^\\d{2}\\/\\d{2}\\/\\d{4}( \\d{2}:\\d{2}:\\d{2})?$",
"description": "Orders placed after this time (mm/dd/yyyy hh:mm:ss)."
},
"orderstatus": {
"type": "string",
"description": "Only orders in this status (see shift4shop_list_order_statuses)."
},
"billingemail": {
"type": "string",
"description": "Billing email address of the order."
},
"invoicenumber": {
"type": "string",
"description": "Exact invoice (order) number."
},
"invoiceprefix": {
"type": "string",
"description": "Only orders whose invoice number has this prefix."
},
"lastupdateend": {
"type": "string",
"pattern": "^\\d{2}\\/\\d{2}\\/\\d{4}$",
"description": "Orders last updated before this date (mm/dd/yyyy)."
},
"lastupdatestart": {
"type": "string",
"pattern": "^\\d{2}\\/\\d{2}\\/\\d{4}$",
"description": "Orders last updated after this date (mm/dd/yyyy)."
},
"invoicenumberend": {
"type": "string",
"description": "Last invoice number of a range."
},
"invoicenumberstart": {
"type": "string",
"description": "First invoice number of a range."
}
}
},
"annotations": {
"title": "List orders",
"readOnlyHint": true
}
}Get one order by its id (the invoice number), with customer, totals and status. Shift4Shop API: GET /Orders/{orderid}.
| Parameter | Type | Description |
|---|---|---|
| orderid * | string | The order id (invoice number), for example from shift4shop_list_orders. |
{
"name": "shift4shop_get_order",
"title": "Get an order",
"description": "Get one order by its id (the invoice number), with customer, totals and status. Shift4Shop API: GET /Orders/{orderid}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"orderid"
],
"properties": {
"orderid": {
"type": "string",
"minLength": 1,
"description": "The order id (invoice number), for example from shift4shop_list_orders."
}
}
},
"annotations": {
"title": "Get an order",
"readOnlyHint": true
}
}List the line items of one order (products, quantities, prices). Shift4Shop API: GET /Orders/{orderid}/Items.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum number of items to return. |
| offset | integer | Starting point for the returned items (0 = first). |
| orderid * | string | The order id (invoice number). |
{
"name": "shift4shop_list_order_items",
"title": "List order items",
"description": "List the line items of one order (products, quantities, prices). Shift4Shop API: GET /Orders/{orderid}/Items.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"orderid"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Maximum number of items to return.",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Starting point for the returned items (0 = first)."
},
"orderid": {
"type": "string",
"minLength": 1,
"description": "The order id (invoice number)."
}
}
},
"annotations": {
"title": "List order items",
"readOnlyHint": true
}
}List the shipments recorded for one order, including tracking data. Shift4Shop API: GET /Orders/{orderid}/Shipments.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum number of items to return. |
| offset | integer | Starting point for the returned items (0 = first). |
| orderid * | string | The order id (invoice number). |
{
"name": "shift4shop_list_order_shipments",
"title": "List order shipments",
"description": "List the shipments recorded for one order, including tracking data. Shift4Shop API: GET /Orders/{orderid}/Shipments.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"orderid"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Maximum number of items to return.",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Starting point for the returned items (0 = first)."
},
"orderid": {
"type": "string",
"minLength": 1,
"description": "The order id (invoice number)."
}
}
},
"annotations": {
"title": "List order shipments",
"readOnlyHint": true
}
}List the payment transactions recorded for one order. Shift4Shop API: GET /Orders/{orderid}/Transactions.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum number of items to return. |
| offset | integer | Starting point for the returned items (0 = first). |
| orderid * | string | The order id (invoice number). |
{
"name": "shift4shop_list_order_transactions",
"title": "List order transactions",
"description": "List the payment transactions recorded for one order. Shift4Shop API: GET /Orders/{orderid}/Transactions.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"orderid"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Maximum number of items to return.",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Starting point for the returned items (0 = first)."
},
"orderid": {
"type": "string",
"minLength": 1,
"description": "The order id (invoice number)."
}
}
},
"annotations": {
"title": "List order transactions",
"readOnlyHint": true
}
}List the order statuses configured in the store (use their ids or names in shift4shop_list_orders). Shift4Shop API: GET /OrderStatus.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum number of items to return. |
| offset | integer | Starting point for the returned items (0 = first). |
| countonly | boolean | Return only the number of matching rows. |
{
"name": "shift4shop_list_order_statuses",
"title": "List order statuses",
"description": "List the order statuses configured in the store (use their ids or names in shift4shop_list_orders). Shift4Shop API: GET /OrderStatus.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Maximum number of items to return.",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Starting point for the returned items (0 = first)."
},
"countonly": {
"type": "boolean",
"description": "Return only the number of matching rows."
}
}
},
"annotations": {
"title": "List order statuses",
"readOnlyHint": true
}
}List store customers, filterable by email, name, country, state, city, phone or last-update range. Shift4Shop API: GET /Customers.
| Parameter | Type | Description |
|---|---|---|
| city | string | City. |
| string | Customer email address. | |
| limit | integer | Maximum number of items to return. |
| phone | string | Phone number. |
| state | string | State or region. |
| offset | integer | Starting point for the returned items (0 = first). |
| country | string | Country name. |
| lastname | string | Customer last name. |
| countonly | boolean | Return only the number of matching rows. |
| firstname | string | Customer first name. |
| lastupdateend | string | Customers last updated before this time (mm/dd/yyyy hh:mm:ss). |
| lastupdatestart | string | Customers last updated after this time (mm/dd/yyyy hh:mm:ss). |
{
"name": "shift4shop_list_customers",
"title": "List customers",
"description": "List store customers, filterable by email, name, country, state, city, phone or last-update range. Shift4Shop API: GET /Customers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"city": {
"type": "string",
"description": "City."
},
"email": {
"type": "string",
"description": "Customer email address."
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Maximum number of items to return.",
"exclusiveMinimum": 0
},
"phone": {
"type": "string",
"description": "Phone number."
},
"state": {
"type": "string",
"description": "State or region."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Starting point for the returned items (0 = first)."
},
"country": {
"type": "string",
"description": "Country name."
},
"lastname": {
"type": "string",
"description": "Customer last name."
},
"countonly": {
"type": "boolean",
"description": "Return only the number of matching rows."
},
"firstname": {
"type": "string",
"description": "Customer first name."
},
"lastupdateend": {
"type": "string",
"pattern": "^\\d{2}\\/\\d{2}\\/\\d{4}( \\d{2}:\\d{2}:\\d{2})?$",
"description": "Customers last updated before this time (mm/dd/yyyy hh:mm:ss)."
},
"lastupdatestart": {
"type": "string",
"pattern": "^\\d{2}\\/\\d{2}\\/\\d{4}( \\d{2}:\\d{2}:\\d{2})?$",
"description": "Customers last updated after this time (mm/dd/yyyy hh:mm:ss)."
}
}
},
"annotations": {
"title": "List customers",
"readOnlyHint": true
}
}Get one customer by id, with contact and billing details. Shift4Shop API: GET /Customers/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The customer id, for example from shift4shop_list_customers. |
{
"name": "shift4shop_get_customer",
"title": "Get a customer",
"description": "Get one customer by id, with contact and billing details. Shift4Shop API: GET /Customers/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "The customer id, for example from shift4shop_list_customers."
}
}
},
"annotations": {
"title": "Get a customer",
"readOnlyHint": true
}
}List catalog products, filterable by SKU, name, cost or price range, stock range and flags (hidden, on sale, not for sale). Shift4Shop API: GET /Products.
| Parameter | Type | Description |
|---|---|---|
| sku | string | Product SKU. |
| hide | boolean | Only hidden products. |
| name | string | Product name. |
| limit | integer | Maximum number of items to return. |
| costto | number | Cost less than this. |
| offset | integer | Starting point for the returned items (0 = first). |
| onsale | boolean | Only products on sale. |
| priceto | number | Price less than this. |
| stockto | number | Stock less than this. |
| costfrom | number | Cost greater than this. |
| countonly | boolean | Return only the number of matching rows. |
| pricefrom | number | Price greater than this. |
| stockfrom | number | Stock greater than this. |
| notforsale | boolean | Only products set as not for sale. |
| lastupdateend | string | Products last updated before this time (mm/dd/yyyy hh:mm:ss). |
| lastupdatestart | string | Products last updated after this time (mm/dd/yyyy hh:mm:ss). |
{
"name": "shift4shop_list_products",
"title": "List products",
"description": "List catalog products, filterable by SKU, name, cost or price range, stock range and flags (hidden, on sale, not for sale). Shift4Shop API: GET /Products.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"sku": {
"type": "string",
"description": "Product SKU."
},
"hide": {
"type": "boolean",
"description": "Only hidden products."
},
"name": {
"type": "string",
"description": "Product name."
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Maximum number of items to return.",
"exclusiveMinimum": 0
},
"costto": {
"type": "number",
"description": "Cost less than this."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Starting point for the returned items (0 = first)."
},
"onsale": {
"type": "boolean",
"description": "Only products on sale."
},
"priceto": {
"type": "number",
"description": "Price less than this."
},
"stockto": {
"type": "number",
"description": "Stock less than this."
},
"costfrom": {
"type": "number",
"description": "Cost greater than this."
},
"countonly": {
"type": "boolean",
"description": "Return only the number of matching rows."
},
"pricefrom": {
"type": "number",
"description": "Price greater than this."
},
"stockfrom": {
"type": "number",
"description": "Stock greater than this."
},
"notforsale": {
"type": "boolean",
"description": "Only products set as not for sale."
},
"lastupdateend": {
"type": "string",
"pattern": "^\\d{2}\\/\\d{2}\\/\\d{4}( \\d{2}:\\d{2}:\\d{2})?$",
"description": "Products last updated before this time (mm/dd/yyyy hh:mm:ss)."
},
"lastupdatestart": {
"type": "string",
"pattern": "^\\d{2}\\/\\d{2}\\/\\d{4}( \\d{2}:\\d{2}:\\d{2})?$",
"description": "Products last updated after this time (mm/dd/yyyy hh:mm:ss)."
}
}
},
"annotations": {
"title": "List products",
"readOnlyHint": true
}
}Get one product by its catalog id, with price, stock and description. Shift4Shop API: GET /Products/{catalogid}.
| Parameter | Type | Description |
|---|---|---|
| catalogid * | string | The product catalog id, for example from shift4shop_list_products. |
{
"name": "shift4shop_get_product",
"title": "Get a product",
"description": "Get one product by its catalog id, with price, stock and description. Shift4Shop API: GET /Products/{catalogid}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"catalogid"
],
"properties": {
"catalogid": {
"type": "string",
"minLength": 1,
"description": "The product catalog id, for example from shift4shop_list_products."
}
}
},
"annotations": {
"title": "Get a product",
"readOnlyHint": true
}
}List the store's product categories. Shift4Shop API: GET /Categories.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum number of categories (max 500). |
| offset | integer | Starting point for the returned items (0 = first). |
| category | string | Find a category by its name. |
| countonly | boolean | Return only the number of matching rows. |
{
"name": "shift4shop_list_categories",
"title": "List categories",
"description": "List the store's product categories. Shift4Shop API: GET /Categories.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"description": "Maximum number of categories (max 500).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Starting point for the returned items (0 = first)."
},
"category": {
"type": "string",
"description": "Find a category by its name."
},
"countonly": {
"type": "boolean",
"description": "Return only the number of matching rows."
}
}
},
"annotations": {
"title": "List categories",
"readOnlyHint": true
}
}Get one product category by id. Shift4Shop API: GET /Categories/{categoryid}.
| Parameter | Type | Description |
|---|---|---|
| categoryid * | string | The category id, for example from shift4shop_list_categories. |
{
"name": "shift4shop_get_category",
"title": "Get a category",
"description": "Get one product category by id. Shift4Shop API: GET /Categories/{categoryid}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"categoryid"
],
"properties": {
"categoryid": {
"type": "string",
"minLength": 1,
"description": "The category id, for example from shift4shop_list_categories."
}
}
},
"annotations": {
"title": "Get a category",
"readOnlyHint": true
}
}Get the store's general settings (store name, currency and other configuration). Shift4Shop API: GET /StoreSettings.
No parameters.
{
"name": "shift4shop_get_store_settings",
"title": "Get store settings",
"description": "Get the store's general settings (store name, currency and other configuration). Shift4Shop API: GET /StoreSettings.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get store settings",
"readOnlyHint": true
}
}Tools for Shift4Shop, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which orders came in today, and what is their status?"; "Find the order for jane@example.com and list its items and shipments."; "Which products are on sale, and how many are in stock?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Shift4Shop data. Free plan: 50 tool calls per month. Run shift4shop_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 shift4shop_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 shift4shop_upgrade without a plan: it returns both plans, each with a payment link for the user to open. shift4shop_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.