MCP serverAvailable tools
Read products
Search products, retrieve one product, or list its linked suppliers.
MCP tool
get_productsPurpose
Search products, retrieve one product, or list linked suppliers.
- Use when
- You need a product identifier or catalog details.
- Do not use when
- You need the official SAT product/service-key catalog.
- Required permissions
- Side effects
- None
- Idempotency
- Idempotent
Input schema
JSON Schema{ "type": "object", "properties": { "input": { "oneOf": [ { "type": "object", "properties": { "operation": { "type": "string", "const": "search" }, "query": { "type": "string", "minLength": 1 }, "status": { "default": "active", "type": "string", "enum": [ "active", "inactive", "all" ] }, "stockStatus": { "type": "string", "enum": [ "available", "out_of_stock" ] }, "cursor": { "type": "string" }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 } }, "required": [ "operation", "status" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "const": "get" }, "productId": { "type": "string" } }, "required": [ "operation", "productId" ], "additionalProperties": false }, { "type": "object", "properties": { "operation": { "type": "string", "const": "suppliers" }, "productId": { "type": "string" } }, "required": [ "operation", "productId" ], "additionalProperties": false } ] } }, "required": [ "input" ], "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false}Output schema
JSON Schema{ "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "products": { "type": "array", "items": { "$ref": "#/definitions/__schema0" } }, "nextCursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "hasMore": { "type": "boolean" } }, "required": [ "products", "nextCursor", "hasMore" ], "additionalProperties": false }, { "type": "object", "properties": { "suppliers": { "type": "array", "items": { "type": "object", "properties": { "supplierId": { "type": "string" }, "legalName": { "type": "string" }, "rfc": { "type": "string" }, "email": { "type": "string" } }, "required": [ "supplierId", "legalName" ], "additionalProperties": false } } }, "required": [ "suppliers" ], "additionalProperties": false }, { "$ref": "#/definitions/__schema0" } ] }, "error": { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "code": { "type": "string", "enum": [ "validation_error", "unauthenticated", "forbidden", "not_found", "method_not_allowed", "conflict", "idempotency_conflict", "operation_in_progress", "recovery_required", "rate_limited", "provider_unavailable", "internal" ] }, "message": { "type": "string" }, "details": { "type": "object", "properties": { "issues": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "array", "items": { "anyOf": [ { "type": "string" }, { "type": "number" } ] } }, "message": { "type": "string" }, "code": { "type": "string" } }, "required": [ "path", "message" ], "additionalProperties": false } }, "retryable": { "type": "boolean" }, "retryAfterSeconds": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "additionalProperties": false } }, "required": [ "code", "message" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "definitions": { "__schema0": { "type": "object", "properties": { "productId": { "type": "string", "minLength": 1 }, "description": { "type": "string" }, "sku": { "type": "string" }, "code": { "type": "string" }, "active": { "type": "boolean" }, "price": { "type": "number" }, "quantityDiscounts": { "maxItems": 10, "type": "array", "items": { "$ref": "#/definitions/__schema1" } }, "taxIncluded": { "type": "boolean" }, "taxRate": { "type": "number" }, "taxability": { "type": "string" }, "taxExemptReason": { "type": "string" }, "stock": { "type": "number" }, "stockStatus": { "type": "string", "enum": [ "available", "out_of_stock" ] }, "satProductCode": { "type": "string" }, "satUnitCode": { "type": "string" }, "updatedAt": { "type": "string", "format": "date-time" } }, "required": [ "productId", "description", "active", "price", "updatedAt" ], "additionalProperties": false }, "__schema1": { "type": "object", "properties": { "minQuantity": { "type": "number" }, "percentage": { "type": "number" } }, "required": [ "minQuantity", "percentage" ], "additionalProperties": false } }, "oneOf": [ { "required": [ "data" ] }, { "required": [ "error" ] } ]}Related workflow
See the canonical workflows in the introductionRelated tools
Save contact
Create or update one customer/supplier. Use get_contacts to obtain contactId for updates. Credit fields apply only to customers.
Read inventory
Read product inventory levels, product movements, the organization movement register, grouped inventory operations, or the movements within one inventory operation.