Foundry IMS

Servidor MCP remoto oficial para Foundry IMS: gerencie um inventário e catálogo de produtos — produtos, variantes, marcas, categorias, imagens, campos personalizados, kits e montagens/BOMs.

GitHubExperimente este MCPPatrocinado

Documentação

Foundry IMS — Servidor MCP

Servidor remoto oficial do Model Context Protocol para Foundry IMS, um sistema de gerenciamento de inventário e informações de produtos para peças, equipamentos e varejistas multicanais.

Ele permite que um assistente de IA trabalhe diretamente em um catálogo Foundry: pesquisar e editar produtos e variantes, gerenciar marcas e categorias, selecionar imagens e inspecionar ou reconstruir montagens (listas de materiais) e pacotes.

Endpoint: https://mcp.foundryims.com/mcp (Streamable HTTP) Nome do registro: com.foundryims/foundry-ims

Este repositório contém a documentação pública e o server.json para o serviço hospedado. O servidor em si é hospedado — não há nada para instalar ou executar localmente.

Instalação

Claude

A Foundry IMS está publicada no diretório de conectores do Claude — procure por Foundry IMS em Configurações → Conectores e clique em Conectar. Entre com sua conta Foundry e a conexão será limitada às organizações às quais você pertence.

Para adicioná-la manualmente como um conector personalizado, use a URL https://mcp.foundryims.com/mcp.

ChatGPT

Configurações → Conectores → Criar, depois adicione https://mcp.foundryims.com/mcp e autentique-se com uma chave de API Foundry (veja abaixo).

Cursor, VS Code, Zed e outros clientes MCP

Aponte qualquer cliente que suporte servidores MCP remotos para:

{
  "mcpServers": {
    "foundry-ims": {
      "url": "https://mcp.foundryims.com/mcp"
    }
  }
}

Autenticação

Dois modos são suportados:

Modo	Como	Multi-org
OAuth	Entre com sua conta Foundry quando o cliente solicitar	Sim — use `list_orgs` / `set_org` para alternar
Chave de API	Envie `Authorization: Bearer fims_…`	Não — a chave está vinculada a uma organização

Crie uma chave de API no admin da Foundry em Configurações → Chaves de API. Cada chamada é limitada às permissões dessa chave; um 403 significa que a chave não tem a permissão necessária.

Ferramentas

36 ferramentas via OAuth, ou 34 com uma chave de API (list_orgs e set_org são somente OAuth, já que uma chave já está vinculada a uma única organização).

Organizações (somente OAuth)

Ferramenta
`list_orgs`	Liste as organizações às quais você pertence e qual está ativa
`set_org`	Defina a organização ativa para chamadas subsequentes

Produtos

Ferramenta
`search_products`	Pesquise por nome, SKU, UPC/GTIN/MPN ou SKU de canal/fornecedor
`get_product`	Busque um produto com suas variantes
`create_product`	Crie um produto SIMPLES, FAMÍLIA, MONTAGEM ou PACOTE
`update_product`	Atualize nome, descrição, marca e categoria
`delete_product`	Exclua logicamente (lixeira) um produto
`restore_product`	Restaure um produto excluído logicamente

Variantes (SKUs vendáveis)

Ferramenta
`search_variants`	Pesquise variantes por SKU, nome e código de barras
`get_variant`	Busque uma variante, incluindo preço e quantidade disponível
`update_variant`	Atualize SKU, nome, preço, custo e identificadores

Montagens / listas de materiais

Ferramenta
`get_bom`	Obtenha a lista de materiais ativa de uma montagem
`bom_can_build`	Quantas unidades podem ser construídas a partir do estoque disponível
`set_bom`	Substitua o BOM de uma montagem por uma nova versão ativa
`delete_bom`	Remova a receita (o produto em si não é alterado)
`flatten_bom`	Embute os componentes de uma submontagem no pai
`find_where_used`	Consulta reversa — todos os BOMs e pacotes que usam um componente
`replace_bom_component`	Troque um componente em todos os BOMs que o utilizam

Pacotes

Ferramenta
`get_bundle_components`	Liste as variantes de componentes de um pacote
`add_bundle_component`	Adicione um componente com uma quantidade
`update_bundle_component`	Altere a quantidade de um componente
`remove_bundle_component`	Remova um componente

Marcas

Ferramenta
`list_brands`	Liste marcas
`create_brand`	Crie uma marca
`update_brand`	Renomeie, re-slug ou defina descrições ricas e metadados de SEO
`merge_brands`	Reatribua todos os produtos de uma marca para outra

Categorias

Ferramenta
`list_categories`	Liste a árvore de categorias
`create_category`	Crie uma categoria
`update_category`	Renomeie, re-slug, redefina a categoria pai ou defina descrições e metadados de SEO
`reorder_categories`	Defina a ordem de exibição dentro de um grupo de irmãos

Imagens

Ferramenta
`add_variant_image`	Adicione uma imagem por URL — a Foundry busca e re-hospeda os bytes
`remove_variant_image`	Remova uma imagem
`reorder_variant_images`	Defina a ordem das imagens

Campos personalizados

Ferramenta
`list_custom_fields`	Liste as definições de campos personalizados da organização
`get_custom_values`	Leia os valores de campos personalizados em um produto ou variante
`set_custom_values`	Defina valores de campos personalizados (upsert)

Notas para agentes

IDs são UUIDs e não são adivinháveis — chame search_products ou search_variants primeiro, depois aja sobre o id retornado.
A pesquisa corresponde a identificadores, não apenas a nomes: passe um SKU, UPC, GTIN, MPN ou um SKU de canal/fornecedor diretamente em search.
Preço e SKUs vivem na variante, não no produto. Use update_variant.
Para enumerar todos os produtos de um tipo, chame search_products com type definido e sem termo search, depois pagine usando meta.total.
delete_product e set_bom são alterações significativas — confirme com o usuário primeiro.

Suporte

Dúvidas ou problemas: support@foundryims.com

Licença

A documentação neste repositório é publicada sob a Licença MIT. O serviço Foundry IMS em si é proprietário.