Buscar produto via MCP (Model Context Protocol)
Endpoint MCP (Model Context Protocol) para integração com agentes de IA (Claude Desktop, Cursor, Zed, etc.). Requer autenticação OAuth2 via Scalekit.
post
Body
application/json
Body
application/json
Forneça ‘barcode’ ou ‘name’ para buscar o produto. Se ambos forem fornecidos, ‘barcode’ terá prioridade.
barcodestring
Código de barras EAN-13 do produto (12 ou 13 dígitos numéricos)
Match pattern:^[0-9]{12,13}$
Example:7891234567890
namestring
Nome do produto para busca textual
>= 3 characters
Example:Smartphone Samsung Galaxy
Response
application/json
Response
application/json
Produto encontrado com sucesso
idstring(uuid)required
Identificador único do produto
Example:550e8400-e29b-41d4-a716-446655440000
barcodestring | null
Código de barras EAN-13
Match pattern:^\d{12,13}$
Example:7891000100103
namestringrequired
Nome do produto
Example:Coca-Cola 2L
shortDescriptionstring | null
Descrição curta do produto
Example:Refrigerante Coca-Cola 2 Litros
longDescriptionstring | null
Descrição detalhada do produto
Example:Refrigerante Coca-Cola sabor original em garrafa PET de 2 litros. Produto ideal para toda a família.
brandstring | null
Marca do produto
Example:Coca-Cola
manufacturerstring | null
Fabricante do produto
Example:Coca-Cola Brasil
categoryPathstringrequired
Caminho completo da categoria
Example:Alimentos e Bebidas > Bebidas > Refrigerantes
imagesarray[string](uri)required
Lista de URLs das imagens do produto
Example:https://s3.amazonaws.com/stone-catalog/products/550e8400-e29b-41d4-a716-446655440000/image1.jpg
attributesobject | null
Atributos específicos do produto (pares chave-valor)
Example:{"volume":"2L","sabor":"Original","tipo":"Refrigerante"}
weightKgnumber | null(float)
Peso do produto em quilogramas
Example:2.1
heightCmnumber | null(float)
Altura do produto em centímetros
Example:32.5
widthCmnumber | null(float)
Largura do produto em centímetros
Example:10.5
depthCmnumber | null(float)
Profundidade do produto em centímetros
Example:10.5
pricestring | null(string)
Faixa de preço do produto em reais. Retorna null quando não disponível.
Example:R$ 7.50
metadataobjectrequired
Show Child Parameters
post/products/mcp
Authentication
Body
{
"barcode": "7891234567890"
}
application/json
Partner
objectidstring(uuid)required
Identificador único do parceiro
Example:550e8400-e29b-41d4-a716-446655440000
companyNamestringrequired
Nome da empresa parceira
Example:Acme Corp
documentstringrequired
Documento do parceiro: CPF numérico, CNPJ numérico legado ou CNPJ alfanumérico. Em caso de erro de validação, o retorno inclui detalhe específico por motivo.
Match pattern:^(\d{11}|\d{14}|[A-Za-z0-9]{12}\d{2})$
Example:12ABC34501DE35
emailstring(email)required
Email do parceiro
Example:contato@acmecorp.com
consoleIdstring
ID do console
Example:console-123
isActivebooleanrequired
Indica se o parceiro está ativo
Example:true
createdAtstring(date-time)required
Data de criação
Example:2024-01-15T10:30:00Z
updatedAtstring(date-time)required
Data de última atualização
Example:2024-01-15T10:30:00Z
Example
Application
objectidstring(uuid)required
Identificador único da aplicação
Example:660e8400-e29b-41d4-a716-446655440001
namestringrequired
Nome da aplicação
Example:App Mobile iOS
partnerIdstring(uuid)required
ID do parceiro
Example:550e8400-e29b-41d4-a716-446655440000
consoleIdstring
ID do console
Example:console-app-123
apiKeystringrequired
API Key da aplicação
Example:key_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
isActivebooleanrequired
Indica se a aplicação está ativa
Example:true
dailyRequestLimitinteger
Limite diário de requisições (null = ilimitado)
Example:10000
createdAtstring(date-time)required
Data de criação
Example:2024-01-15T10:30:00Z
updatedAtstring(date-time)required
Data de última atualização
Example:2024-01-15T10:30:00Z
Example
Merchant
objectidstring(uuid)required
Identificador único do merchant
Example:770e8400-e29b-41d4-a716-446655440002
documentstringrequired
Documento do merchant: CPF numérico, CNPJ numérico legado ou CNPJ alfanumérico. Em caso de erro de validação, o retorno inclui detalhe específico por motivo.
Match pattern:^(\d{11}|\d{14}|[A-Za-z0-9]{12}\d{2})$
Example:12ABC34501DE35
applicationIdstring(uuid)required
ID da aplicação
Example:660e8400-e29b-41d4-a716-446655440001
isActivebooleanrequired
Indica se o merchant está ativo
Example:true
createdAtstring(date-time)required
Data de criação
Example:2024-01-15T10:30:00Z
updatedAtstring(date-time)required
Data de última atualização
Example:2024-01-15T10:30:00Z
Example
ProductResponse
objectidstring(uuid)required
Identificador único do produto
Example:550e8400-e29b-41d4-a716-446655440000
barcodestring
Código de barras EAN-13
Match pattern:^\d{12,13}$
Example:7891000100103
namestringrequired
Nome do produto
Example:Coca-Cola 2L
shortDescriptionstring
Descrição curta do produto
Example:Refrigerante Coca-Cola 2 Litros
longDescriptionstring
Descrição detalhada do produto
Example:Refrigerante Coca-Cola sabor original em garrafa PET de 2 litros. Produto ideal para toda a família.
brandstring
Marca do produto
Example:Coca-Cola
manufacturerstring
Fabricante do produto
Example:Coca-Cola Brasil
categoryPathstringrequired
Caminho completo da categoria
Example:Alimentos e Bebidas > Bebidas > Refrigerantes
imagesarray[string](uri)required
Lista de URLs das imagens do produto
Example:https://s3.amazonaws.com/stone-catalog/products/550e8400-e29b-41d4-a716-446655440000/image1.jpg
attributesobject
Atributos específicos do produto (pares chave-valor)
Example:{"volume":"2L","sabor":"Original","tipo":"Refrigerante"}
weightKgnumber(float)
Peso do produto em quilogramas
Example:2.1
heightCmnumber(float)
Altura do produto em centímetros
Example:32.5
widthCmnumber(float)
Largura do produto em centímetros
Example:10.5
depthCmnumber(float)
Profundidade do produto em centímetros
Example:10.5
pricestring(string)
Faixa de preço do produto em reais. Retorna null quando não disponível.
Example:R$ 7.50
metadataobjectrequired
Show Child Parameters
Example