Familiar MCP Server
oficialUn copiloto de IA para Foundry VTT: gestiona combates, ambienta escenas y da voz a los PNJ hablando con tu asistente. 193 herramientas en 24 dominios, funciona con el contenido que ya posees.
Documentación
Trae tu propia IA, cualquiera de 25 proveedores. Creado para D&D 5e (2024).
Tu copiloto de IA para Foundry VTT.
Compraste Foundry para dirigir la partida para los demás. Familiar se pone del lado del dungeon master: las reglas, los dados, los monstruos, cada PNJ con su propia voz. Para que por fin puedas jugar. En solitario, uno contra uno o con un grupo completo.
Instalar en FoundryÚnete al Discord
Pausa
Instalar
Instalar Familiar en Foundry
Familiar se distribuye directamente desde GitHub. Pega esta URL en el diálogo de Instalar Módulo de Foundry.
URL del manifiesto: https://github.com/Ryanjansen92/familiar-releases/releases/latest/download/module.jsonCopiar URL del manifiesto
- En Foundry, abre Configuración → Módulos de complementos
- Haz clic en Instalar Módulo
- Pega la URL en el campo URL del manifiesto en la parte inferior y luego Instalar. Mostrar el diálogo de Instalar Módulo
Foundry VTT
v13, v14
Sistema de juego
D&D 5e (reglas 2024): soporte completo. Otros sistemas obtienen las funciones generales (chat, diarios, escenas, audio) pero no herramientas específicas del sistema como hojas de personaje o automatización de combate.
A la vista de todos. Publicado en npm y GitHub, con preguntas respondidas en Discord.
- npmfamiliar-vtt
- GitHublanzamientos
- Discordpregunta lo que sea
Trae tu propia IA
Conecta la IA que ya usas.
Pega una clave API o apunta Familiar a la suscripción de Claude o ChatGPT que ya pagas. Ambos caminos llegan a las mismas 193 herramientas; la diferencia es dónde se ejecuta el modelo y a quién le pagas.
Chat integrado
Pega una clave API y empieza a hablar con tu partida.
Sin servidor, sin terminal, sin archivos de configuración. La única ruta con voz, generación de imágenes y transcripción además del chat, y la única que funciona completamente sin conexión a través de Ollama o LM Studio. Un control de Razonamiento te permite ajustar cuánto se esfuerza el modelo en razonar, al máximo para combates difíciles, al mínimo para consultas rápidas.
Chat (16 proveedores)
- OpenRouter
- Anthropic
- OpenAI
- Groq
- Mistral
- Together AI
- DeepSeek
- xAI
- Cohere
- Perplexity
- Fireworks AI
- Cerebras
- SambaNova
- Ollama (local)
- LM Studio (local)
OpenRouter desbloquea más de 300 modelos con una sola clave.
Voz (3 proveedores)
- ElevenLabs
- Cartesia
- OpenAI TTS
Imagen (3 proveedores)
- OpenAI (GPT Image)
- fal.ai
- Leonardo AI
Transcripción (3 proveedores)
- Gladia
- Deepgram
- AssemblyAI
Usa tu suscripción
¿Ya pagas por Claude, ChatGPT/Codex o tienes una cuenta de Google? Ponla a trabajar.
Conéctate a través del Protocolo de Contexto de Modelos y tu suscripción existente se convierte en un asistente de DM sin costo adicional de API. El módulo incluye un Asistente de Configuración MCP que detecta tu cliente y genera la configuración para pegar. Ideal para cadenas largas de varios pasos. Tu modelo y su esfuerzo de razonamiento se configuran en tu propio cliente, no aquí.
Clientes MCP (8 proveedores)
- Claude Desktop
- Claude Code
- Codex CLI
- Codex Desktop
- ChatGPT
- Antigravity CLI
- Antigravity Editor
- Gemini CLIobsoleto 2026-06-18
Google retirará Gemini CLI el 2026-06-18. Migra a Antigravity CLI (misma cuenta de Google, nivel gratuito disponible) antes de esa fecha. El Asistente de Configuración MCP ya lo soporta.
Tus claves, tu costo.
La mayoría de las herramientas de IA para juegos de mesa enrutan a través de sus servidores, aumentan el costo de los tokens y te cobran por turno. ¿Quedarse sin créditos a mitad de sesión? Mala suerte. Familiar nunca usa proxy ni aumenta nada: tus claves API van directamente de tu navegador al proveedor, y con MCP tu suscripción se encarga. Sin intermediarios, sin medidor por turno.
Combate e IA
31 herramientas gestionan encuentros de principio a fin: iniciativa, ataques, hechizos, daño, condiciones, salvaciones de muerte y PX. Familiar resuelve cada acción de PNJ, incluyendo multiataque y acciones legendarias, a partir de una instantánea del campo de batalla con análisis de cobertura.
- Iniciativa, turnos, rondas: todo el flujo del encuentro
- Tiradas de ataque, salvaciones y daño, completamente automatizados
- Condiciones, salvaciones de muerte, PX
- Pilotar turnos de PNJ desde una instantánea del campo de batalla, cuando quieras
- Movimiento calculado con análisis de cobertura
- Multiataque y acciones legendarias resueltos
Tira iniciativa para todos los goblins, haz que ataquen al jugador más cercano y pon música de batalla.
Escucha una escena: cada PNJ con su propia voz
Voces de PNJ y generación de imágenes
Dale a cada PNJ su propia voz. TTS multivoz con ElevenLabs, Cartesia y OpenAI, además de retratos, arte de objetos y fondos de mapa de batalla generados durante la sesión.
- Dale a cada PNJ su propia voz
- Texto a voz multivoz en tres proveedores
- ElevenLabs, Cartesia, OpenAI TTS
- Genera retratos de personajes sobre la marcha
- Genera arte de objetos y fondos de mapa de batalla
- Arte de escena a partir de planos de texto
Atenúa las luces, empieza lluvia y truenos, y haz que el posadero susurre una advertencia sobre el camino que viene, con su voz.
Escenas y lienzo
Construye toda la escena preguntando. Fichas, muros y puertas, iluminación, clima, niebla de guerra, regiones de activación, sonido ambiental. Familiar lo coloca, tú lo diriges.
- Crea escenas y coloca fichas
- Dibuja muros, puertas y regiones de activación
- Configura iluminación, oscuridad y efectos climáticos
- Configura baldosas, dibujos y sonidos ambientales
- Niebla de guerra y control de cámara
- Genera fichas desde cualquier compendio
Genera dos Lobos del compendio como refuerzos, colócalos cerca del borde del bosque y añádelos al combate con iniciativa tirada.
Audio y atmósfera
Reproduce, detén y gestiona listas de reproducción y pistas individuales con control de volumen y fundido. Pon música de batalla, construye paisajes sonoros ambientales o silencia todo sin tocar la barra lateral de Foundry.
- Reproduce, detén y pon en cola listas de reproducción
- Control de pista individual con volumen y fundido
- Fundido cruzado entre pistas
- Pon música de batalla al empezar el combate
- Construye paisajes sonoros ambientales
- Silencia todo sin tocar la barra lateral
Pon la lista de reproducción de la taberna, baja las luces y deja que el bardo toque una suave pista de laúd de fondo.
Conocimiento y memoria
Búsqueda semántica en todos los diarios, personajes, escenas y objetos. Un banco de memoria persistente almacena hechos importantes de la campaña que se mantienen entre sesiones, con gestión completa de diarios para notas de sesión y documentos.
- Búsqueda semántica en diarios, personajes, escenas, objetos
- Banco de memoria persistente entre sesiones
- Resume las sesiones cuando dices que has terminado
- Gestión completa de diarios y documentos
- Creación y edición de chinchetas de mapa
- Envía y lee mensajes de chat desde cualquier fuente
Hemos terminado por esta noche. Resume lo que pasó esta sesión y guárdalo.
Personajes y objetos
Inspecciona, crea, actualiza y clona actores, inventario, hechizos, rasgos y efectos activos. Importa desde compendios, aplica mejoras personalizadas y gestiona la propiedad de los jugadores.
- Inspecciona, crea, actualiza y clona actores
- Gestiona inventario, hechizos y rasgos
- Aplica y alterna efectos activos (mejoras y penalizaciones)
- Importa desde cualquier paquete de compendio
- Configura la propiedad y los permisos de los jugadores
- Tira en tablas para encuentros aleatorios y botín
Encuentra un hombre lobo CR 3 en el compendio, colócalo en la escena como jefe y dale resistencia a armas no plateadas.
Piloto automático
Haz clic en "Ejecutar PNJ" y despreocúpate. Familiar juega cada turno enemigo por ti, con límites de seguridad y confirmación opcional turno por turno.
- Un clic ejecuta cada turno de PNJ en el encuentro
- Los límites de seguridad evitan bucles descontrolados
- Confirmación turno por turno cuando la quieras
- Funciona junto al rastreador de combate estándar
- Las instantáneas del campo de batalla informan las decisiones tácticas
- Se detiene en la ronda o el turno que indiques
Ejecuta todos los turnos de los PNJ esta ronda. Para después de que vaya el dragón.
Transcripción en vivo
Habla en lugar de escribir. Familiar transcribe tu sesión en tiempo real con tres proveedores, codifica por colores por hablante y guarda la transcripción en una entrada del diario de Foundry que puedes editar y buscar después.
- Habla en lugar de escribir en medio de una escena
- Transcripción en tiempo real con tres proveedores
- Codificación de colores por hablante
- Se guarda directamente en una entrada del diario de Foundry
- Edita y busca la transcripción después
- Gladia, Deepgram, AssemblyAI
Empieza a transcribir la sesión. Guárdala en un diario llamado 'Sesión 12' cuando terminemos.
Chat multisestión
Fija, archiva y cambia entre hilos de campaña con nombre. Cada hilo persiste como una entrada del diario de Foundry con un registro de auditoría completo, para que puedas volver a cualquier conversación más tarde, incluso meses después.
- Fija, archiva y renombra hilos de campaña
- Cada hilo persiste como una entrada del diario de Foundry
- Registro de auditoría completo de cada llamada de herramienta
- Cambia entre hilos sin perder contexto
- Busca en conversaciones pasadas
- Reabre una misión secundaria pausada en segundos
Abre el hilo 'Castillo de Stormpoint' y retoma donde lo dejamos la semana pasada.
Explora las 193 herramientas en 24 dominios
Funciona en conjunto
Construido alrededor del contenido que ya tienes.
Familiar no reemplaza tus módulos, mapas o campañas. Los lee, los ejecuta y no se interpone en tu camino.
-
Campañas predefinidas
Abre Ember, Dragon of Icespire Peak o cualquier aventura publicada. Familiar lee las entradas del diario, los PNJ y los encuentros que la acompañan, y los dirige en la mesa sin inventar contradicciones.
-
Mapas de batalla que ya usas
Coloca un mapa de Czepeku o Patreon. Familiar obtiene las fichas, luces, muros y sonido ambiental que configuraste, y ejecuta el combate sobre el trabajo de otra persona.
-
Compendios y tu propio contenido casero
Tus PNJ personalizados, tus reglas de la casa, tus importaciones de D&D Beyond. Familiar lee lo que ya está en tu mundo en lugar de inventar cosas.
Familiar no incluye sus propias aventuras, mapas o compendios. El contenido es tuyo. Tu IA cuenta la historia que tú traes, no inventa una, y Familiar dirige el lado del dungeon master de la mesa sobre ella.
Juega en cualquier mesa
Juega D&D en solitario, a dúo o con un grupo completo.
Sin importar cuántos se presenten, tú puedes jugar. Cuantos menos humanos en la mesa, más del mundo dirige Familiar, las reglas, los dados, los monstruos, cada PNJ. Tú tomas asiento en la partida que normalmente diriges para los demás.
-
En solitario
Solo tú
Juegas tu personaje. Familiar dirige todo lo que lo rodea: cada PNJ con su propia voz, cada turno de monstruo, la escena, con las reglas de D&D 5e 2024 aplicadas. La memoria de campaña lleva el mundo de una sesión a la siguiente.
-
A dúo
Tú y otra persona
Ninguno de los dos tiene que ser el DM. Familiar dirige el mundo para ambos, el reparto, los encuentros, las resoluciones, para que sigan siendo jugadores y la historia avance.
-
Mesa pequeña
Tú y unos pocos
El reparto secundario y los turnos de los monstruos se ejecutan para ti, con la iluminación, la música y las resoluciones, para que nadie salga del juego para mantenerlo en movimiento.
-
Grupo completo
Tú diriges para cuatro o más
La carga táctica se quita del GM. Tú diriges el encuentro y cuentas la historia; Familiar se encarga de la iniciativa, los turnos de los monstruos y la contabilidad. Tú diriges la escena, no la hoja de cálculo.
Un copiloto, no un DM sustituto. Quienquiera que esté en la mesa, tú sigues contando la historia, y los dados y las matemáticas siempre son correctos. Nada de "sacaste un 47".
Cómo funciona
Un mensaje de entrada. Familiar ejecuta las acciones de Foundry de salida.
Ninguna aplicación nueva que aprender y ningún comando que memorizar. Familiar funciona desde su propio chat dentro de Foundry, o desde un cliente MCP que ya uses.
-
Tú hablas
Escribe en el chat de Familiar dentro de Foundry, o conecta un cliente MCP como Claude, ChatGPT o Codex. Tu IA lee la escena y elige cuál de las 193 herramientas llamar.
2. ### A través de un socket seguro
Las llamadas de herramientas llegan a tu mundo a través de un WebSocket autenticado. Tu clave API va directamente de tu navegador a tu proveedor. Familiar nunca la proxy ni la almacena.
3. ### Familiar lo ejecuta
El módulo ejecuta las mismas operaciones de Foundry que harías manualmente: tirar iniciativa, colocar fichas, configurar luces, poner música. Tú te mantienes en el personaje.
El chat integrado no necesita nada extra. MCP añade un pequeño servidor local que inicias con un comando.
Por qué construí esto
Un copiloto para el game master que prefiere dirigir la historia que la hoja de cálculo.
Soy Ryan. Padre de dos niños pequeños, casado con mi persona favorita, con el tiempo libre que te imaginas. Mi esposa y yo jugamos a D&D juntos, solo nosotros dos, campañas uno a uno. Es lo nuestro. Pero dirigir en solitario es mucho trabajo. Eres el narrador, cada PNJ, el motor de reglas, el técnico de sonido y la ambientación, todo a la vez. En medio de un monólogo como un misterioso desconocido, tenía que romper el personaje para tirar iniciativa, buscar el alcance de un hechizo, ajustar la iluminación y encontrar esa pista de ambiente de taberna que juré haber marcado. Para cuando volvía a la escena, el momento se había esfumado.
Quería algo que pudiera encargarse del lado mecánico de la mesa para poder quedarme en la historia. No un director de juego sustituto, sino un copiloto. Algo a lo que pudiera decirle "tira iniciativa por los goblins, atenúa las antorchas y pon música de combate", y que se encargara de ello. Mientras yo seguía hablando.
Así que empecé a construirlo. Primero fueron un puñado de herramientas para mover fichas y tirar dados. Luego añadí seguimiento de combate. Después gestión de escenas. Luego "¿y si también pudiera generar retratos de PNJ sobre la marcha?" y "¿y si pudiera poner voz al tabernero?". Así es como acabas con 193 herramientas en 24 dominios y 25 proveedores de IA.
Me tomé mi tiempo con esto. Usé Familiar en mi propia mesa, sesión tras sesión, antes de abrirlo al público. No quería lanzar otra IA que convierta tu campaña en un sinsentido en el momento en que olvida lo de la semana pasada.
Empezó como un rascador de picores personal para un padre que quería dirigir mejores partidas de D&D para su esposa. Resulta que muchos directores de juego tienen el mismo picor.
Ryan, trabajando en Familiar
Precios
Un mes gratis. Tus claves, tu coste.
3 $ al mes o 25 $ al año mantienen Familiar en funcionamiento. Tu proveedor de IA te factura directamente por los tokens que gastes. Sin sobrecoste, sin intermediarios, sin límites por turno.
Alimenta al Familiar3 $al mes
Úsalo durante un año25 $al añoahorras 11 $
Gratis el primer mes, luego 3 $.
Facturación mensual o anual. Cancela cuando quieras.
Instalar en Foundryo empieza tu mes gratis
- Las 193 herramientas en todos los sistemas de Foundry compatibles
- Cada actualización. IA de combate, voz, imagen, transcripción, memoria
- BYOK o MCP. Conecta cualquier proveedor de la lista
- Informes de errores e ideas de funciones bienvenidos en Discord
Lo que pagas a tu proveedor de IA
Familiar nunca hace de proxy ni aplica sobrecostes a los tokens. Anthropic, OpenAI, OpenRouter, Ollama, tu suscripción MCP: tú configuras la clave, ellos te facturan. Una sesión típica de D&D cuesta entre 0,50 $ y 3 $ en costes de API, según el modelo. O nada: una suscripción a través de MCP o un modelo local a través de Ollama no te cuesta tokens.
Preguntas frecuentes
Respuestas sinceras.
Las preguntas que jugadores y directores de juego realmente hacen, respondidas sin rodeos. La lista completa está en GitHub.
-
¿Qué es Familiar?
Familiar es un copiloto de IA para Foundry VTT. Conectas la IA que ya usas, como Claude o ChatGPT, a través del Protocolo de Contexto de Modelo o una clave API, y ejecuta el lado del director de juego de una aventura publicada de D&D 5e que importes: las reglas, los dados, los monstruos y las voces de los PNJ. Tú sigues siendo el jugador y mantienes la historia; Familiar se encarga de la mesa.
-
¿Cómo conecto Claude o ChatGPT a Foundry VTT?
Dos maneras, y en ambas traes tu propia IA. Usa la suscripción a Claude, ChatGPT o Codex que ya pagas a través del Protocolo de Contexto de Modelo, y Familiar se ejecuta como un servidor MCP al que esos clientes se conectan. O pega una clave API en el chat integrado. Las mismas herramientas funcionan de cualquier manera; la diferencia es dónde se ejecuta el modelo y a quién pagas.
Lee la guía de conexión
-
¿Familiar recopila mis datos?
Sin telemetría, sin analíticas, sin llamadas a casa. Familiar se ejecuta dentro de tu mundo de Foundry; los datos solo salen cuando envías mensajes a tu proveedor de IA elegido. Usa Ollama o LM Studio para jugar completamente sin conexión.
-
¿Puede la IA romper mi mundo?
Las actualizaciones de documentos se sanean, por lo que la IA no puede cambiar la propiedad, los permisos ni los IDs internos. Las operaciones destructivas requieren confirmación, y la conexión WebSocket se autentica con un secreto compartido. Haz copias de seguridad de todos modos: es una buena práctica con o sin IA.
-
¿Funciona con sistemas de juego distintos de D&D 5e?
El soporte completo es solo para D&D 5e (reglas de 2024). Las funciones genéricas como dados, diarios, escenas y audio funcionan en todas partes, pero las herramientas específicas del sistema (hojas de personaje, automatización de combate) están construidas en torno al modelo de datos de dnd5e. Pathfinder 2e, La Llamada de Cthulhu y Savage Worlds están en la hoja de ruta.
-
¿Qué modelos de IA funcionan mejor?
Cualquier modelo insignia actual de Anthropic, OpenAI o Google maneja mejor el uso de herramientas; consulta la guía "Elegir un modelo de IA" para los niveles nombrados. Trae la clave o suscripción que ya pagas. La capacidad de razonamiento es lo que sostiene un combate difícil o una escena enredada: el chat integrado tiene un control de Pensamiento que puedes subir cuando un momento lo merece, y a través de MCP ese dial reside en tu propio cliente.
-
¿Puede una IA ayudarme a dirigir D&D en solitario?
Sí, esa es una razón principal por la que existe. La mayoría de las personas que tienen Foundry son el director de juego, el que nunca llega a jugar. Familiar ejecuta las reglas, los monstruos y los PNJ, y recuerda tu campaña entre sesiones, para que puedas tomar asiento en tu propia mesa, en solitario o uno a uno. Así empezó Familiar: D&D 1 a 1 con mi esposa.
-
¿Necesito mi propia campaña para empezar?
No. Compra una aventura lista para Foundry (los módulos oficiales de D&D cuestan entre 20 $ y 30 $, con los mapas y la iluminación ya construidos), coloca un par de mapas de batalla, activa Familiar y ya estás jugando. Familiar lee los diarios de la aventura para conocer la historia que estás a punto de descubrir, y extrae monstruos y objetos de tus compendios sobre la marcha.
-
¿La IA juega un personaje de mi lado?
Todavía no. Familiar dirige el lado del DM, las reglas, los monstruos y los PNJ, para que tú juegues tu propio personaje. Permitir que la IA ejecute los turnos de un aliado junto a ti está en la hoja de ruta, no implementado. Las sorpresas vienen de la aventura y de la niebla de guerra de Foundry, no de que la IA guarde secretos. Una IA no puede ocultar lo que puede leer.
-
¿Puede una IA dirigir mi partida como Dungeon Master?
Sí, con una salvedad sincera. Las IA son malas inventando una historia, así que Familiar no les pide que lo hagan. Tú traes una aventura publicada con sus mapas y PNJ, tu IA la lee y la dirige, y un humano puede tomar el control en cualquier momento. Conecta tu propia IA y dirige todo el lado del DM con memoria de tu campaña entre sesiones.
Hoja de ruta
Cosas en las que estoy trabajando.
Sin promesas de plazos. Aproximadamente en orden de prioridad.
Mejor juego en solitario y a dúo.
Para el DM que dirige la mesa para todos los demás y quiere jugar por una vez. Familiar ya dirige el lado del DM; esto lo afina para una mesa de uno o dos.
- Relleno de grupo acompañante: deja que la IA ejecute los turnos de combate de un aliado designado
- Escalado de encuentros: equilibra un combate para un grupo en solitario o a dúo
- Modo solitario: un preajuste de un clic para las reglas, los monstruos y las voces de los PNJ
Habla con los módulos que ya usas.
Deja que Familiar controle el resto de tu conjunto de Foundry: tiradas automatizadas, animaciones, botín, efectos.
- Midi-QOL: tiradas de ataque y salvaciones automatizadas
- Sequencer + JB2A: orquesta animaciones de hechizos
- Token Magic FX: efectos de sombreado en fichas y losetas
- Item Piles: botín y mercaderes
- DFreds Convenient Effects: efectos de estado y mejoras
Más sistemas, más allá de D&D 5e.
Herramientas completas específicas del sistema: hojas de personaje, automatización de combate, resolución de hechizos.
- D&D 5e (2024)Implementado
- Pathfinder 2ePlanificado
- La Llamada de CthulhuPlanificado
- Savage WorldsPlanificado
Campañas plug-and-play.
Importa una aventura publicada y Familiar ya conoce la historia, los PNJ, los mapas y los encuentros. Empezando por Ember.
Ember es la campaña sandbox oficial de 500 horas de Foundry. Más aventuras publicadas a continuación.
Perfeccionando lo que ya está implementado.
- IA de combate: retirada, moral, coordinación de grupo
- Voz: control de emociones, escenas multivoz más naturales
- Imagen: retratos de personaje consistentes entre sesiones
- MCP: retroalimentación más rica del progreso de herramientas en tiempo real para clientes externos
¿Tienes una idea? Discord es el mejor lugar para impulsar algo en la lista.
¿Listo para jugar por una vez?
Instala Familiar en Foundry y tu primer mes va por cuenta de la casa. Cancela cuando quieras, tu mundo sigue siendo tuyo.
Soy Ryan, construí Familiar. Únete al Discord y te ayudaré personalmente a empezar.