Referencia de herramientas MCP

Un comando de inicio.
Herramientas de memoria claras.

Ejecuta setup una vez y reinicia tu herramienta de IA. Engram aparece como herramientas MCP con guía de inicio; revisa las herramientas enfocadas cuando las necesites.

Empieza con una prueba gratuita de npm

El cliente npm no necesita correo ni clave API. Con permiso para modificar la configuración de tu herramienta de IA, ejecuta setup, reinicia el cliente y describe tu repositorio y tarea reales. Añade --dry-run para previsualizar los cambios. Conserva cualquier espacio de Engram ya conectado.

npx -y engram-tools@latest --setup

Llama a engram_start, guarda una decisión confirmada del proyecto con engram_store y recupérala en una sesión nueva.

La primera llamada de memoria inicia la prueba de 7 días: 25 registros privados, 20 llamadas al día y 100 en total.

Para conservar el mismo espacio, ejecuta después npx -y engram-tools@latest connect y verifica tu correo.

Las conexiones OAuth remotas, como las de los directorios, verifican el correo al conectarse.

O crea un espacio cuya propiedad verifiques por correo

Paso 1

Ingresa tu email

Empieza gratis con 100 memorias privadas, 1 desarrollador y el banco público de 100.000 memorias. No necesitas tarjeta.

Paso 2

Verifica el código OTP

Primero enviamos un código de 6 dígitos para que nadie cree cuentas con el email de otra persona.

Paso 3

Recibe tu API key

Después de verificar, Engram crea tu workspace automáticamente y te envía la key de setup.

¿Dónde obtengo una clave de API?

Crea un espacio de trabajo gratuito y verifica tu email. Engram te envía tu clave de API personal y el comando de instalación listo para ejecutar en el email de bienvenida. Si ya te registraste, usa el mismo email para recibir tu clave actual.

Obtener una clave gratis
Paso 4

Inicia tu agente

Ejecuta npx engram-tools@latest --setup con tu clave API, reinicia tu herramienta de IA y describe el proyecto y la tarea con normalidad. Engram guía al agente automáticamente mediante MCP.

npx -y engram-tools@latest --setup

Comprueba la conexión y tu primera memoria útil

Describe el proyecto y la tarea al agente. Después de trabajar, pídele que recuerde una decisión duradera. En una sesión nueva, pídele recuperarla. Instalar no crea memoria privada del proyecto.

npx -y engram-tools@latest --doctor
  • ¿Faltan herramientas? Cierra por completo y abre el cliente. Comprueba Node.js 20+ y npx. Normalmente no hace falta reinstalar.
  • Cada cliente tiene su configuración. Ejecuta la comprobación de abajo y usa --setup --client codex con la clave del workspace correcto. --update conserva las conexiones existentes.
  • Gemini puede pedir confianza en la carpeta y permiso MCP. Invita a tu equipo desde el dashboard: cada persona recibe su clave para el mismo workspace compartido.

Configuración por cliente

El comando de setup lo escribe automáticamente. Estos ejemplos muestran el formato exacto de clientes que no usan el JSON estándar.

Antigravity

El flujo actual de Gemini puede llevar al usuario a Antigravity. Engram escribe la config compartida de Gemini y los archivos específicos de Antigravity.

// ~/.gemini/config/mcp_config.json
// ~/.gemini/antigravity/mcp_config.json
{
"mcpServers": {
"engram": {
"command": "npx",
"args": ["-y", "engram-tools@latest", "mcp"]
}
}
}

OpenCode

OpenCode usa un arreglo de comandos en lugar de mcpServers. El setup escribe ese formato automáticamente.

// ~/.config/opencode/opencode.json
{
"mcp": {
"engram": {
"type": "local",
"command": ["npx", "-y", "engram-tools@latest", "mcp"],
"enabled": true
}
}
}

Codex

Codex usa TOML. Engram reemplaza solo la tabla engram y conserva el resto de tu configuración de Codex.

# ~/.codex/config.toml
[mcp_servers.engram]
type = "stdio"
command = "npx"
args = ["-y", "engram-tools@latest", "mcp"]
Mensaje inicial opcional para el agente

Engram también guía al agente por MCP. Este prompt deja clara la primera sesión y ayuda a usar recall, cross-pollination y rehydrate en el momento correcto.

El email de bienvenida también lo incluye. Aquí queda como respaldo si el cliente AI ignora la guía inicial de MCP.

Llama engram_start con este contexto:
project: <producto o cliente>
repo: <repo>
role: <rol>
market: <dominio o mercado>
stack: <tecnologías principales>
task: <tarea actual>
Antes de elegir enfoque, llama engram_recall.
Si otro repo pudo resolver este patrón, llama engram_cross_pollinate.
Si el chat fue compactado o retomado, llama engram_rehydrate.

Memoria, vigencia y comentarios

El contrato práctico de las herramientas. Las tablas de parámetros se generan desde el esquema MCP. Los ejemplos de respuesta son extractos HTTP sin datos sensibles. MCP devuelve JSON, Markdown o confirmaciones breves mediante text/format; comprueba format antes de interpretarlos.

Elige la herramienta según lo que necesitas

Empezar a trabajar en un repositorio

engram_start

Guía del espacio y memoria pertinente

Responder una pregunta concreta

engram_recall

Registros ordenados para esa pregunta

Cambiar de tarea conservando el contexto

engram_smarter

Resumen enfocado en la nueva tarea

Continuar tras perder contexto

engram_rehydrate

Recuperación segura del diario y apoyo en memoria actual

Guardar un hito

engram_reflect

Punto de control; la sesión sigue abierta

El cliente npm puede iniciar una prueba gratuita aislada sin correo ni clave API. Las conexiones OAuth remotas verifican el correo. Nunca inventes credenciales. repo es un filtro dentro del espacio autorizado, no permiso para acceder a otro espacio.

Usa engram_start al comenzar, engram_recall para una pregunta, engram_smarter al cambiar de tarea y engram_rehydrate después de compactar el contexto o de una interrupción. Smarter busca memoria duradera para la nueva tarea; no reconstruye el diario anterior. Ambos pueden registrar eventos. Rehydrate puede leer sesiones cerradas o de compañeros, pero no reabrirlas ni escribir en ellas. engram_reflect deja la sesión abierta; engram_close_session la termina explícitamente.

Los valores focused predeterminados son start=8, recall=5, smarter=5 y cross_pollinate=5 registros. Con deep son 16, 12, 12 y 12, respectivamente. Un limit explícito sustituye el presupuesto dentro del máximo de la herramienta. Salvo que include_skills se haya especificado explícitamente como true o false, las guías se eligen por palabras clave de la tarea.

Rehydrate tiene otro presupuesto: depth=brief devuelve hasta 12 eventos y 2 resúmenes; standard, 30 y 4; full, 60 y 8. No acepta limit ni los valores de búsqueda focused/deep.

Si recall devuelve count=0, indica que no encontró memoria pertinente. Revisa repo y consulta; reformula o usa depth=deep cuando proceda. Más resultados no vuelven pertinente la información ajena. Usa cross_pollinate si otro repositorio probablemente contiene una lección transferible. get_context sirve para inspeccionar categorías deliberadamente, no como paso automático tras cada búsqueda vacía.

Separa las reglas de los hechos que cambian

Prefiere un hecho mantenible de forma independiente por registro. Una regla de permisos y una observación del despliegue necesitan IDs separados. Para una unidad usa type, content y claim opcional; para 1–32 unidades independientes usa claims, cada una con type, content y claim. No mezcles ambas formas. Las memorias antiguas sin tipo siguen como legacy_unassessed; añadir metadatos no demuestra que contengan un solo hecho.

type es la categoría de búsqueda, como CONVENTION o SOLUTION; claim.kind distingue rule, decision, state, lesson y reference. Solo state lleva stage: proposed, implemented, tested o deployed. Requiere observed_at en formato ISO con zona horaria, como máximo un minuto por delante del reloj del servidor. Se admiten UTC y desfases explícitos; sincroniza el reloj del cliente. tested/deployed requieren evidence. La aporta el agente; Engram no la verifica independientemente. review_after es opcional, no puede preceder a observed_at y es una fecha de revisión, no caducidad automática ni permiso para retirar una regla.

La etiqueta kind=rule no concede autoridad humana ni anula instrucciones actuales. Usa supersedes_memory_ids y change_reason solo para un reemplazo verificado. Para dividir una nota antigua, split_from incluye memory_id y content_sha256; por defecto se previsualiza. Aplica únicamente con dry_run=false y la confirmación devuelta split:<id>:<plan_hash>. Las partes históricas siguen siendo históricas; no copies votos de éxito a hechos nuevos no relacionados.

Ejemplo: sustituye los marcadores por los valores realmente devueltos.

{
  "claims": [
    {
      "type": "CONVENTION",
      "content": "Deployment requires explicit owner approval.",
      "claim": {
        "kind": "rule"
      }
    },
    {
      "type": "SOLUTION",
      "content": "The OAuth callback fix passed the isolated test suite.",
      "claim": {
        "kind": "state",
        "stage": "tested",
        "observed_at": "2026-11-15T09:00:00Z",
        "evidence": "Commit abc1234; isolated OAuth regression receipt"
      }
    }
  ]
}
Revisa una nota mixta sin perder su regla válida

Si una nota combina una regla válida y un estado de publicación obsoleto, no retires toda la nota para ocultar ese estado. Revisa cada hecho independiente. Mantén activa la regla y marca como histórica solo la parte obsoleta de claims. Puede dividirla su creador o el propietario humano; la fuente debe ser privada, activa y todavía no declarada como claim.

Envía claims y split_from juntos para previsualizar. Calcula content_sha256 sobre el texto conservado exacto, no sobre una vista abreviada o paráfrasis. La vista previa no escribe memorias. Revisa claims, active_claims e historical_claims antes de aplicar. El ejemplo es pseudocódigo del SDK MCP: source es el registro real y claims tu lista revisada; usa historical:true solo en las partes obsoletas.

Reenvía la misma fuente y el mismo plan con dry_run=false y la confirmation de la vista previa, sin modificarla. No construyas una confirmación. Si cambia la fuente o el plan, pide otra vista previa. El original queda como historia; cada unidad obtiene su propio ID sin heredar votos. La vista previa valida la forma de la escritura, no la veracidad de tu revisión.

Ejemplo: sustituye los marcadores por los valores realmente devueltos.

const plan = {
  split_from: {
    memory_id: source.id,
    content_sha256: sha256(source.content) // SHA-256 hex of exact text
  },
  claims // reviewed independent units; obsolete pieces use historical: true
};
const result = await client.callTool({ name: "engram_store", arguments: plan });
if (result.isError) throw new Error("Split preview failed");
if (result.structuredContent?.format !== "json") throw new Error("Expected JSON preview");
const preview = JSON.parse(result.structuredContent.text);
// Review preview.claims, active_claims and historical_claims before applying.
await client.callTool({
  name: "engram_store",
  arguments: { ...plan, dry_run: false, confirmation: preview.confirmation }
});
Útil no significa verificado ni vigente

success=true significa que la memoria ayudó a la tarea. No prueba que siga siendo verdadera, esté desplegada o que cada frase de una nota mixta sea correcta. trust=validated y confidence son etiquetas de compatibilidad sobre utilidad reportada, no verificación independiente. Lee claim.stage, observed_at, evidence y last_outdated_report_at; contrasta hechos críticos con código y funcionamiento actuales.

La pertinencia inicial puede ser relevant, irrelevant o uncertain. La utilidad real puede ser helpful, unhelpful, not_used o not_evaluated. Solo helpful/unhelpful genera un voto y modifica confidence. Un resultado puede ser irrelevant y not_used sin voto negativo de uso. Sin comentarios queda sin evaluar. Las notas de pertinencia y las pruebas de uso se guardan por separado.

Los comentarios useful/noisy/stale/missing_context/too_long mediante engram_reflect.feedback o POST /api/v1/feedback evalúan Engram como producto. Son distintos de los resultados por memoria y no cambian su confidence.

Vincula los comentarios a la consulta exacta y gestiona los reintentos

retrieval_id identifica la presentación registrada de una lista de resultados; session_id identifica el diario. Conserva cada retrieval_id con su lista, sobre todo cuando la misma memoria aparece en consultas paralelas. Un retrieval_id null significa que esa respuesta no tiene atribución exacta. Una fuente antigua o cerrada puede recibir comentarios explícitos si el recibo, la memoria y quien llama siguen siendo accesibles; no reabras el diario.

Para un uso real, llama a engram_report_outcome con memory_id, success y retrieval_id. Usa outcomes para un lote de hasta 20 pares consulta/memoria únicos. También puedes adjuntarlos como pending_feedback a la siguiente llamada start, recall, smarter, store, reflect, cross_pollinate, get_context, skill o report_outcome. Requiere outcome:write y no consume cuota adicional de llamadas. Omite lo que no puedes evaluar en vez de inventar un juicio.

Para repetir un resultado exacto, reenvía los mismos retrieval_id, memory_id y campos de uso. Engram responde con duplicate=true sin añadir otro voto. duplicate es un campo de respuesta, no de entrada; no existe un indicador retry. Ese reintento no es un error 409; cambiar un voto ya guardado sí devuelve 409. Sin retrieval_id, el formato antiguo selecciona la presentación más reciente de esa memoria para el mismo miembro y espacio en las últimas 24 horas. session_id restringe la selección a ese diario. Sus reintentos pueden añadir votos; la atribución inferida no es exacta. Un uso genuinamente nuevo necesita una nueva presentación.

El lote de comentarios se confirma antes de la acción principal. Revisa feedback_receipt aunque la acción falle: los comentarios pueden haberse guardado. MCP remoto y el cliente npm conservan ese recibo en los errores. Un fallo con comentarios ya confirmados no se reintenta automáticamente; la acción principal aún puede no ser idempotente. En reflect.used_memories, incluye retrieval_id en cada elemento de un lote exacto y atómico de hasta 20; separa los elementos antiguos en otra reflexión. Un aprendizaje o checkpoint posterior puede fallar; feedback_receipt muestra los resultados aceptados.

Ejemplo: sustituye los marcadores por los valores realmente devueltos.

{
  "repo": "example",
  "query": "Which deployment rule applies?",
  "pending_feedback": [
    {
      "retrieval_id": "<id from the previous result list>",
      "memory_id": "<memory in that list>",
      "relevance": "irrelevant",
      "usefulness": "not_used"
    }
  ]
}

Recomendado: resultados vinculados a la consulta (argumentos de engram_reflect)

{
  "store": false,
  "summary": "Applied the recalled approval rule.",
  "used_memories": [
    {
      "retrieval_id": "<id from that result list>",
      "memory_id": "<memory in that list>",
      "success": true,
      "detail": "Checked owner approval before releasing."
    }
  ]
}

Solo por compatibilidad: reflexión antigua separada (argumentos de engram_reflect)

{
  "store": false,
  "summary": "Reported a use without a retained query receipt.",
  "used_memories": [
    {
      "memory_id": "<accessible memory id>",
      "success": true,
      "detail": "This use has inferred attribution, not an exact query link."
    }
  ]
}
Retirada, borrado permanente y recuperación segura

engram_retract_memory retira reversiblemente conocimiento privado; puede hacerlo su creador o el propietario humano. engram_restore_memory exige un registro retirado que aún se conserve y comprueba cuota y reemplazos confirmados. Ni guardar el mismo texto ni rehydrate lo restauran silenciosamente. Los registros borrados no se recuperan.

Un token OAuth no puede previsualizar ni ejecutar el borrado permanente, aunque su miembro sea OWNER. Ambas operaciones requieren la vía separada de credencial API del propietario humano. No obtengas ni sustituyas su clave para eludir las restricciones OAuth. engram_delete_memory previsualiza el impacto por defecto; ejecuta solo con dry_run=false y confirmation=delete:<exact memory_id>. Elimina la memoria activa, copias vinculadas conocidas y texto libre de los diarios afectados. El contexto ya enviado a clientes, registros independientes, paráfrasis sin vínculo, proveedores y copias de seguridad quedan fuera de ese borrado dirigido.

El listado de sesiones oculta tareas vinculadas a conocimiento retirado, caducado o borrado. Si no se puede reconstruir el diario con seguridad, usa memoria actual segura o abre un diario limpio con engram_start(new_session=true); no eludas la ocultación. Restaurar una fuente conservada puede devolver acceso a su historial seguro.

Herramientas

Elige una herramienta para revisar

Bucle principal

Herramientas del flujo normal y recuperación tras compactación.

Avanzadas y checkpoints

Mantenerlas disponibles; usarlas solo cuando el trigger sea real.

Elige una herramienta para revisar
engram_start

Al comenzar una sesión significativa; para contexto perdido usa rehydrate.

engram_start

Inicia el trabajo en un repositorio.

Al comenzar una sesión significativa; para contexto perdido usa rehydrate.

session_id
opcional
string

ID exacto del diario devuelto por start/rehydrate/list_sessions. Distingue trabajo paralelo; escribir exige tu sesión activa. Rehydrate puede leer historia compartida o cerrada.

agent_tool
opcional
string

Cliente que llama, como codex, claude-code, cursor o gemini. Omítelo si no se conoce.

project
recomendado
string

Nombre del producto/proyecto. Si falta repo, start/setup lo usan como pista del repositorio.

repo
recomendado
string

Nombre del repositorio dentro del espacio autorizado. Es un filtro de memoria, no una ruta ni un selector de espacio.

role
opcional
string

Responsabilidad del agente, como ingeniero backend. start/setup usan por defecto agente de implementación.

market
opcional
string

Contexto del negocio o dominio, como finanzas o educación; no controla acceso geográfico.

task
recomendado
string

Objetivo o decisión actual y concreta. Enfoca el contexto y la recuperación.

stack
opcional
string[]

Tecnologías del proyecto; omite el campo si no se conocen.

context
opcional
string

Contexto completo opcional; sustituye la consulta generada desde project, role, market, stack y task.

new_session
opcional
boolean

false reutiliza un diario activo adecuado. true crea otro para trabajo paralelo; reintentar puede crear más sesiones. Conserva session_id.

include_skills
opcional
boolean

Incluye guías pertinentes. Si se omite, el servidor las infiere por palabras clave; false las excluye.

limit
opcional
number

Máximo de 1–30 memorias. Predeterminados: focused=8, deep=16; limit explícito los sustituye.

depth
opcional
focused | deep

focused usa un presupuesto pequeño; deep lo amplía si no basta. Un limit explícito sustituye el presupuesto.

pending_feedback
opcional
object[]

Lote de retrieval_ids anteriores, confirmado antes de esta acción por separado. Exige outcome:write; repetir el mismo uso es seguro. Sin cuota adicional; omite resultados no evaluados.

Sigue leyendo

¿Qué es MCP?

El estandar que hace posible Engram.

📡

Un estandar abierto de Anthropic

MCP (Model Context Protocol) es un estandar abierto creado por Anthropic. Permite a los agentes de AI conectarse a herramientas externas y fuentes de datos a traves de una interfaz simple y universal.

🔌

USB para AI

Piensalo como USB para AI: un estandar, todas las herramientas funcionan. Sin integraciones personalizadas, sin SDKs propietarios, sin dependencia de proveedor. Si tu herramienta habla MCP, simplemente funciona.

🧠

Engram es un servidor MCP

Cualquier herramienta de AI compatible con MCP puede conectarse a Engram. Claude Code, Cursor, Gemini, Antigravity, Copilot, OpenCode, Windsurf, Devin. Si soporta MCP, soporta Engram.

⚡

Cero esfuerzo de integracion

No se necesita SDK. Sin codigo de integracion personalizado. Solo agrega Engram a la configuracion MCP de tu agente y obtiene 8 nuevas herramientas de memoria al instante.

Como se conecta

Tu Agente

Claude, Cursor, etcétera

MCP
➞

Engram

Servidor MCP

guardar/recordar
➞

Memoria del Equipo

PostgreSQL + pgvector

Los workspaces son el límite del equipo

Usa un workspace por equipo. Los repos organizan la memoria de proyecto dentro de él. Invita teammates desde el dashboard para que cada persona tenga su propia key.

Repo frontend

Herramientas

Claude CodeCursorCopilot
Memorias45

Repo API

Herramientas

Claude CodeWindsurf
Memorias128

Repo móvil

Herramientas

CursorDevin
Memorias67

Qué significa un workspace

  • ✓El workspace es el límite privado de memoria para un equipo o empresa.
  • ✓Repos y proyectos organizan memorias dentro de ese límite.
  • ✓Invita teammates desde el dashboard para que cada persona use una key separada.
  • ✓Los agentes del mismo workspace pueden reutilizar lecciones privadas entre repos.
  • ✓Workspaces distintos quedan aislados; la memoria pública puede enriquecer resultados.
workspace-sync.sh
$ engram_get_context({ repo: "api-backend" })

Empieza con ventaja, no desde cero

Cada nuevo espacio de trabajo empieza con 100.000 memorias públicas con fuente sobre herramientas de agentes, MCP, RAG/búsqueda, seguridad, operaciones, documentación de ingeniería y producto/devex.

100K
Memorias públicas
7
Familias de fuentes
20
Guías de skills
🔄
330+
Patrones
Enfoques probados
Patrones

Enfoques probados para tareas comunes. Ejemplo: "Patron de ruta API: envolver en try-catch, validar entrada, verificar auth, luego logica de negocio." Los patrones te dicen COMO hacer algo correctamente.

📏
170+
Convenciones
Reglas y estandares del equipo
Convenciones

Reglas del equipo y estandares de codificacion. Ejemplo: "Siempre usar migraciones Prisma, nunca SQL ALTER TABLE directo." Las convenciones mantienen tu codigo consistente.

⚠️
155+
Trampas
Trampas y sorpresas
Trampas

Cosas que fallan o te sorprenden. Ejemplo: "async/await dentro de forEach NO funciona como esperas. Usa for...of." Las trampas te ahorran horas de depuracion.

🔧
215+
Soluciones
Correcciones probadas
Soluciones

Correcciones probadas en batalla para problemas comunes. Ejemplo: "Desajuste de hidratacion en Next.js: usa useEffect para logica solo del cliente." Las soluciones dan la respuesta, no solo la pista.

📦
100+
Dependencias
Especificas del framework
Dependencias

Conocimiento especifico de version para frameworks. Ejemplo: "Prisma 7 requiere patron de adaptador PrismaPg." Las dependencias previenen sorpresas de actualizacion.

🎓
20
Guias de Habilidades
Guias paso a paso
Guias de Habilidades

Guias paso a paso para tareas complejas. Ejemplo: "Habilidad de Revision de Codigo: 15 pasos desde clonar la rama hasta aprobar." Las habilidades dan a tu agente experiencia bajo demanda.

Fuentes: Cubre React, Next.js, Vue, Angular, Python, Go, Rust, TypeScript, PostgreSQL, Docker, Kubernetes, AWS y más de 25 tecnologías. También skills de negocio: producto, ventas, marketing, RRHH, legal, finanzas y más.

Otros agentes empiezan en blanco. El tuyo empieza con 100.000 memorias públicas con fuente, 20 guías paso a paso y una memoria privada del equipo que crece desde el primer día.

Dos bancos de memoria. Un agente inteligente.

Conocimiento público para todos. Conocimiento privado para tu equipo.

🌍
100K

Banco público de memoria

  • ✓100.000 memorias públicas con fuente
  • ✓Herramientas de agentes, MCP, RAG/búsqueda, seguridad, operaciones y devex
  • ✓20 guías paso a paso
  • ✓Patrones de buenas prácticas, advertencias, soluciones y controles de evidencia
  • ✓Se actualiza cuando crece el banco público
  • ✓Disponible para todos los usuarios de Engram
Gratis en todos los planes
🔒
aislado

Banco privado de memoria

  • ✓Conocimiento propio de tu equipo
  • ✓Convenciones específicas de tu código
  • ✓Decisiones internas de arquitectura
  • ✓Aprendizajes de incidentes y post-mortems
  • ✓Nunca se comparte fuera de tu workspace
  • ✓Aislado, cifrado y limitado al workspace
Tu ventaja competitiva
El agente hace recall
↓
Busca primero en privado
↓
Enriquece con público
↓
Mejores resultados combinados
Recall combinado

Primero la memoria privada. El conocimiento público rellena los huecos.

Engram busca primero en el conocimiento de tu espacio de trabajo y, cuando ayuda, añade prácticas públicas con fuente y guías.

engram_start

Soporte y feedback

Mejoremos Engram juntos

Si el setup confunde, una herramienta se comporta raro o un límite de precio no cuadra, escríbenos aquí. El mensaje llega directo a nosotros.

Comentarios

¿Qué mejoramos?

Bugs, pasos de setup confusos, dudas de precio e ideas de producto llegan directo al equipo de Engram.

Verifica tu correo antes de que tus comentarios lleguen a nuestro equipo. Esto no crea una cuenta.

Faltan 10 caracteres0/4000