Foundry IMS

Foundry IMS — Servidor MCP

Servidor remoto oficial de Model Context Protocol para Foundry IMS, un sistema de gestión de inventario e información de producto para piezas, equipos y minoristas multicanal.

Permite que un asistente de IA trabaje directamente sobre un catálogo de Foundry: buscar y editar productos y variantes, gestionar marcas y categorías, curar imágenes, e inspeccionar o reconstruir ensamblajes (listas de materiales) y paquetes.

Endpoint: https://mcp.foundryims.com/mcp (HTTP transmisible) Nombre de registro: com.foundryims/foundry-ims

Este repositorio contiene la documentación pública y el manifiesto server.json para el servicio alojado. El servidor en sí está alojado: no hay nada que instalar o ejecutar localmente.

---

Instalación

Claude

Foundry IMS está publicado en el directorio de conectores de Claude: busque Foundry IMS en Configuración → Conectores y haga clic en Conectar. Inicie sesión con su cuenta de Foundry y la conexión se limitará a las organizaciones a las que pertenece.

Para agregarlo manualmente como conector personalizado, use la URL https://mcp.foundryims.com/mcp.

ChatGPT

Configuración → Conectores → Crear, luego agregue https://mcp.foundryims.com/mcp y autentíquese con una clave API de Foundry (ver más abajo).

Cursor, VS Code, Zed y otros clientes MCP

Apunte cualquier cliente que admita servidores MCP remotos a:

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

Autenticación

Se admiten dos modos:

Modo	Cómo	Multi-org
OAuth	Inicie sesión con su cuenta de Foundry cuando el cliente lo solicite	Sí: use list_orgs / set_org para cambiar
Clave API	Envíe Authorization: Bearer fims_…	No: la clave está vinculada a una organización

Cree una clave API en el administrador de Foundry en Configuración → Claves API. Cada llamada se limita a los permisos de esa clave; un 403 significa que la clave carece del permiso requerido.

Herramientas

36 herramientas con OAuth, o 34 con una clave API (list_orgs y set_org son solo OAuth, ya que una clave ya está vinculada a una sola organización).

Organizaciones (solo OAuth)

Herramienta
list_orgs	Enumere las organizaciones a las que pertenece y cuál está activa
set_org	Establezca la organización activa para llamadas posteriores

Productos

Herramienta
search_products	Busque por nombre, SKU, UPC/GTIN/MPN o SKU de canal/proveedor
get_product	Obtenga un producto con sus variantes
create_product	Cree un producto SIMPLE, FAMILY, ASSEMBLY o BUNDLE
update_product	Actualice nombre, descripción, marca, categoría
delete_product	Elimine suavemente (papelera) un producto
restore_product	Restaure un producto eliminado

Variantes (SKU vendibles)

Herramienta
search_variants	Busque variantes por SKU, nombre y códigos de barras
get_variant	Obtenga una variante, incluidos precio y cantidad disponible
update_variant	Actualice SKU, nombre, precio, costo e identificadores

Ensamblajes / listas de materiales

Herramienta
get_bom	Obtenga la lista de materiales activa de un ensamblaje
bom_can_build	Cuántas unidades se pueden construir con el stock disponible
set_bom	Reemplace la BOM de un ensamblaje con una nueva versión activa
delete_bom	Elimine la receta (el producto en sí no se modifica)
flatten_bom	Incorpore los componentes de un subensamblaje en su padre
find_where_used	Búsqueda inversa: todas las BOM y paquetes que usan un componente
replace_bom_component	Intercambie un componente en todas las BOM que lo usan

Paquetes

Herramienta
get_bundle_components	Enumere las variantes de componentes de un paquete
add_bundle_component	Agregue un componente con una cantidad
update_bundle_component	Cambie la cantidad de un componente
remove_bundle_component	Elimine un componente

Marcas

Herramienta
list_brands	Enumere marcas
create_brand	Cree una marca
update_brand	Renombre, re-slug, o establezca descripciones enriquecidas y metadatos SEO
merge_brands	Reasigne todos los productos de una marca a otra

Categorías

Herramienta
list_categories	Enumere el árbol de categorías
create_category	Cree una categoría
update_category	Renombre, re-slug, reasigne de padre, o establezca descripciones y metadatos SEO
reorder_categories	Establezca el orden de visualización dentro de un grupo de hermanos

Imágenes

Herramienta
add_variant_image	Agregue una imagen por URL: Foundry obtiene y vuelve a alojar los bytes
remove_variant_image	Elimine una imagen
reorder_variant_images	Establezca el orden de las imágenes

Campos personalizados

Herramienta
list_custom_fields	Enumere las definiciones de campos personalizados de la organización
get_custom_values	Lea los valores de campos personalizados en un producto o variante
set_custom_values	Establezca valores de campos personalizados (upsert)

Notas para agentes

• Los ID son UUID y no son adivinables: llame primero a search_products o search_variants, luego actúe sobre el id devuelto.
• La búsqueda coincide con identificadores, no solo nombres: pase un SKU, UPC, GTIN, MPN o un SKU de canal/proveedor directamente a search.
• El precio y los SKU viven en la variante, no en el producto. Use update_variant.
• Para enumerar todos los productos de un tipo, llame a search_products con type establecido y sin término search, luego pagine usando meta.total.
• delete_product y set_bom son cambios significativos: confirme primero con el usuario.

Enlaces

• Foundry IMS
• Documentación del conector
• Documentación de la API de tienda
• Model Context Protocol

Soporte

Preguntas o problemas: support@foundryims.com

Licencia

La documentación de este repositorio se publica bajo la Licencia MIT. El servicio Foundry IMS en sí es propietario.