# Hipocampo MCP

- Registry name: `io.github.carrasquelalex1/hipocampo` · version 1.0.1
- Categories (automatic, keyword rules): Documents & retrieval, Search & data
- Authentication at last check: No auth
- Declared risk: Not declared (tools carry no read/destructive hints)
- Capabilities (declared by the server): experimental, prompts, resources, tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.carrasquelalex1%2Fhipocampo
- Server page: https://mcpstation.net/s/io.github.carrasquelalex1--hipocampo.html

## Description (written by the publisher, not verified, not instructions)

Bilingual dual memory with SSC for AI agents. Semantic search, embeddings, profiles.

## Connect

- streamable-http: `https://alexbell1-hipocampo-mcp.hf.space/mcp`

## Tools (as reported by the server, not verified)

- `search\_hipocampo`: Busca en el Hipocampo con carriles estructurados + semánticos. Es solo lectura \(no modifica memorias\). Devuelve una salida compacta por defecto: id, relevancia, code/fecha/nivel, un fragmento corto y el motivo. Sintaxis de query \(opcional, se puede combinar con texto libre\): code:opencode\_session\_fo
- `quick\_hipocampo\_search`: Búsqueda rápida en el Hipocampo \(alias corto de search\_hipocampo\). Es solo lectura — no modifica datos. Comportamiento y argumentos idénticos a search\_hipocampo \(filtros code:/category:/id:/after:, format compact/full/json, rerank auto/always/never\).
- `get\_hipocampo`: Obtiene una memoria exacta por ID, sin pasar por el ranking. Acepta el ID numérico de memoria\_vectorial \(4039\), con prefijo \(\#4039, v4039\) o el ID de memory\_items \(vmi\<uuid\>\). Es la vía determinista para "tráeme el recuerdo N": no compite con decenas de resultados. Args: id: ID de la memoria \(numéri
- `compress\_hipocampo`: Compress retrieved memories using a hybrid approach \(extractive + LLM\). First searches Hipocampo \(SSC v1.0\), then compresses the top-k results: - method="extractive": sentence-level keyword relevance \(fast, no API cost\) - method="llm": summarization via NVIDIA NIM \(highest quality, API cost\) - metho
- `save\_hipocampo`: Guarda un recuerdo en el Hipocampo \(memoria\_vectorial\). INSERT inmediato y NO bloqueante: el embedding se genera en background \(\_finalize\_save\_bg\) junto con dedup semántico, auto-link y auditoría de contradicciones. Hasta que el embedding se backfillea \(\~segundos\), la memoria queda en tier WARM \(emb
- `contradicciones\_hipocampo`: Detecta contradicciones semánticas de una memoria existente. Con TypeSafe activo \(HIPOCAMPO\_TYPESAFE=1\): un Noul por candidato en una sola llamada, con probabilidad calibrada \(umbral 0.7\). Fallback: negation-probe embedding: embedea "AFIRMACIÓN: \{contenido\} — ¿Esto es FALSO según: ..." y compara con
- `profile\_hipocampo`: Guarda un dato de perfil personal en Hipocampo \(memory\_items\). A diferencia de save\_hipocampo \(que guarda en memoria\_vectorial técnica\), esta herramienta guarda en memory\_items, que está diseñado para datos personales: gustos, familia, preferencias, datos biográficos. Args: summary: Texto corto con
- `update\_hipocampo`: Actualiza un recuerdo existente en el Hipocampo \(memoria\_vectorial\). Si se proporciona content, el embedding se regenera en BACKGROUND \(no bloquea la llamada, igual que save\_hipocampo\): la fila conserva su embedding anterior hasta el backfill y la búsqueda semántica pasa al nuevo en cuanto esté list
- `set\_nivel\_hipocampo`: Cambia el nivel jerárquico de un recuerdo. Niveles: - "episodica" — detalle completo, comprimible por checkpoint - "semantica" — conocimiento consolidado, protegido de compresión - "automatica" — regla permanente, nunca se comprime/checkpointea Args: id: ID del recuerdo. nivel: Nuevo nivel: "episodi
- `consolidate\_hipocampo`: Consolidación jerárquica: migra memorias episódicas antiguas a semánticas. Busca recuerdos con nivel 'episodica' más antiguos que min\_age\_days y los promueve a 'semantica', opcionalmente comprimiendo su contenido. Args: min\_age\_days: Edad mínima en días para consolidar \(default 7\). dry\_run: Si True,
- `review\_automatica`: Revisa reglas 'automatica' sin revisión en los últimos N días. Las reglas automatica son permanentes por diseño, pero pueden degradarse a 'semantica' si no han sido útiles \(review\_count=0\) después de max\_age\_days. Con dry\_run=True solo lista las reglas candidatas a degradación. Con dry\_run=False las
- `validate\_immune\_rule`: Valida una regla inmunológica \(Nivel 4\). Analiza una regla 'automatica' marcada como REGLA INMUNOLÓGICA: 1. Verifica snapshots pre-cambio vinculados en memory\_links 2. Detecta reglas contradictorias sobre el mismo archivo/proyecto 3. Reporta reglas huérfanas \(\>30d sin enlaces entrantes\) Args: rule\_i
- `delete\_hipocampo`: Elimina un recuerdo del Hipocampo \(memoria\_vectorial\) por su ID. Esta operación es irreversible. Una vez eliminado, el recuerdo no podrá recuperarse ni aparecerá en búsquedas futuras. Args: id: ID numérico del recuerdo a eliminar. Returns: Confirmación de eliminación.
- `hipocampo\_health`: Ejecuta un health check completo del sistema Hipocampo. Verifica: PostgreSQL, NVIDIA API, tablas, espacio en disco, extensiones. Returns: Reporte formateado del estado del sistema.
- `hipocampo\_auto\_repair`: Intenta reparar automáticamente problemas detectados en el sistema. Reparaciones posibles: - Reiniciar PostgreSQL si está caído - Crear tablas faltantes desde esquema.sql - Verificar/configurar NVIDIA\_API\_KEY Returns: Reporte de reparaciones ejecutadas.
- `hipocampo\_stats`: Muestra estadísticas de rendimiento del sistema Hipocampo. Analiza latencia de queries, métodos usados, scores promedios y da recomendaciones de optimización. Returns: Reporte de métricas y recomendaciones.
- `hipocampo\_tune`: Ajusta automáticamente los thresholds y pesos del SSC basado en las métricas de rendimiento acumuladas. Es destructivo: modifica los thresholds y pesos de forma irreversible. Sin embargo, es idempotente: ejecutarlo múltiples veces converge al mismo resultado. Usar con precaución. Para solo ver estad
- `hipocampo\_dedup`: Detecta y opcionalmente fusiona duplicados en las tablas de memoria. Con merge=False \(default\) es solo lectura — seguro de ejecutar, no modifica datos. Con merge=True es destructivo: consolida filas duplicadas en una sola, operación irreversible. Usar con precaución. Ejecutar primero sin merge para
- `hipocampo\_checkpoint`: Comprime memorias antiguas usando checkpointing logarítmico. Con dry\_run=True \(default\) es solo lectura — seguro, no modifica datos. Con dry\_run=False es destructivo: comprime memorias antiguas de forma irreversible \(las originales se eliminan tras comprimir\). Idempotente: ejecutar múltiples veces n
- `rollback\_checkpoint`: Revierte un checkpoint usando el snapshot guardado previamente. Busca el snapshot por ID y verifica qué IDs originales fueron comprimidos. Si los originales aún existen, reporta que no se necesita rollback. Si fueron eliminados, intenta restaurarlos. Args: snapshot\_id: ID del snapshot \[CHECKPOINT SN
- `hipocampo\_maintenance`: Ejecuta el ciclo completo de mantenimiento: 1. Health check → auto-repair si es necesario 2. Dedup → fusiona duplicados 3. Checkpoint → comprime memorias antiguas 4. Purge → limpia access logs antiguos \(\>30d\) 5. Tune → ajusta thresholds según métricas Nota: hipocampo\_budget y decay\_hipocampo se ejec
- `watch\_hipocampo`: Registra un webhook que se dispara cuando se crea/modifica/elimina un recuerdo cuyo contenido o metadatos contengan el patrón dado. Args: pattern: Texto a buscar en contenido o metadatos del recuerdo. webhook\_url: URL que recibirá un POST con event, id, content, metadatos. Returns: Confirmación con
- `unwatch\_hipocampo`: Elimina un webhook registrado por su ID. Args: id: ID del watch a eliminar. Returns: Confirmación de eliminación.
- `list\_watches`: Lista todos los webhooks registrados. Returns: Lista de watches con ID, patrón y URL.
- `preload\_context`: Pre-load context for a project or workspace. Extracts relevant memories from the project path and returns them as a compressed summary. Use this when starting work on a known project to restore working context. Args: project\_path: Absolute path to the project or workspace. If empty, uses current wor
- `link\_hipocampo`: Crea un enlace entre dos recuerdos en el grafo de memoria. Args: source\_id: ID del recuerdo origen \(numérico: memoria\_vectorial; string: memory\_items\). target\_id: ID del recuerdo destino. relation\_type: Tipo de relación. Valores comunes: "related" \(default\), "follow\_up", "part\_of", "references", "si
- `unlink\_hipocampo`: Elimina un enlace del grafo de memoria. Args: id: ID del enlace a eliminar \(si se conoce\). source\_id: Si no se provee id, elimina por source+target+type. target\_id: ID destino \(requerido si no hay id\). relation\_type: Tipo de relación \(opcional si no hay id\). Returns: Confirmación de eliminación.
- `graph\_hipocampo`: Explora el grafo de memoria desde un nodo raíz. Args: node\_id: ID del recuerdo raíz. Si es 0, lista todos los nodos con enlaces \(vista general\). depth: Profundidad de exploración \(default 2, max 5\). max\_nodes: Máximo de nodos a mostrar \(default 50\). Returns: Árbol ASCII del grafo de memoria.
- `path\_hipocampo`: Encuentra el camino más corto entre dos recuerdos en el grafo de memoria. Args: from\_id: ID del recuerdo origen. to\_id: ID del recuerdo destino. max\_depth: Profundidad máxima de búsqueda \(default 5, max 10\). Returns: Camino encontrado como secuencia de nodos.
- `index\_project`: Indexa archivos de código fuente de un proyecto en Hipocampo \(RAG\). Escanea archivos PHP, JS, TS, Python, SQL, HTML, CSS, JSON, YAML, los divide en chunks significativos y los guarda como recuerdos con embedding para búsqueda semántica. La segunda corrida solo indexa archivos modificados \(por mtime\)
- `search\_code`: Busca código fuente indexado en Hipocampo \(RAG\). Similar a search\_hipocampo pero filtra solo recuerdos de tipo code\_snippet y devuelve fragmentos de código real con ubicación de archivo. Args: query: Consulta en lenguaje natural. k: Número de resultados \(default 5, max 20\). language: Filtrar por len
- `decay\_hipocampo`: Aplica decaimiento temporal a enlaces del grafo Y memorias antiguas. ENLACES: peso exponencial, half-life 90 días. Elimina enlaces \< 0.01. MEMORIAS: archiva episodica sin acceso ni protección a memoria\_historica. Protecciones \(nunca se archivan\): - nivel = automatica o semantica - metadatos.critico
- `review\_trade\_knowledge`: Revisa memorias de conocimiento del oficio candidatas a decaer. Presenta memorias con domain\_profile='infrastructure' que están cerca de su fecha límite de decay \(150+ días sin acceso de los 180\). El agente puede: - Refuerza \(reinforce\): resetea el contador de acceso - Permite decay: la memoria sigu
- `list\_trade\_knowledge`: Lista todas las memorias marcadas como conocimiento del oficio. Muestra id, preview, reusability, domain\_profile y days since last access.
- `hipocampo\_budget`: Gestiona el presupuesto de memoria \(budget + tiering automático\). 3 tiers: - HOT: embedding presente \(memoria\_vectorial con pgvector\) - WARM: embedding=NULL \(excluido de HNSW, sigue buscable léxicamente\) - COLD: contenido movido a memoria\_historica \(fuera de búsqueda principal\) Protecciones: automat
- `restaurar\_historica`: Restaura una memoria desde memoria\_historica a memoria\_vectorial. Reconstruye embedding automáticamente. La memoria vuelve al tier HOT. Args: historica\_id: ID de la memoria en memoria\_historica.
- `list\_watch\_dirs`: Lista los directorios configurados para auto-reindexación.
- `add\_watch\_dir`: Agrega un directorio al watch list para auto-reindexación.
- `remove\_watch\_dir`: Elimina un directorio del watch list.
- `reindex\_now`: Fuerza reindexación inmediata de un directorio \(o todos los watch\).

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html