Herramientas del MCP

Qué puede consultar y registrar un asistente conectado a Middleout, con los parámetros de cada herramienta.

Todas las herramientas actúan como la persona que conectó el asistente: ven solo lo que esa persona puede ver en Middleout. Si algo no existe o no es visible para ella, la respuesta es la misma: no encontrado.

Los objetos de la memoria se identifican por un handle, que las herramientas de búsqueda devuelven y las de lectura reciben.

¿Cómo define finanzas la venta neta?

Un asistente conectado busca en Middleout antes de responder. La llamada y la respuesta son las reales del MCP; la interfaz depende de tu asistente.

Consultar

Herramienta	Para qué sirve	Parámetros
`ask`	Hacerle una pregunta de negocio a Middleout y recibir su respuesta fundamentada, con las fuentes que cita.	`question`; `investigation_id` (opcional) para preguntar dentro de una investigación.
`search_knowledge`	Encontrar lo que la empresa sabe sobre algo, por significado o por número de registro.	`query`; `types` (opcional); `limit` (hasta 20, por defecto 10).
`read_object`	Leer un objeto completo: sus campos, sus fuentes y, en un modelo mental, sus causas.	`handle`.
`get_neighbourhood`	Ver qué rodea a un objeto en el grafo.	`handle`; `depth` (1 o 2).
`get_knowledge_map`	Ver de un vistazo qué sabe la empresa: sus áreas y los totales por tipo.	Ninguno.
`get_instructions`	Leer las instrucciones para trabajar en un repositorio conectado: sus archivos `AGENTS.md` y `CLAUDE.md`.	`repository` (`owner/name`).
`list_investigations`	Listar las investigaciones que puedes abrir, de la más nueva a la más antigua.	`limit` (hasta 50, por defecto 20).
`read_investigation`	Leer una investigación: su pregunta, su objetivo y lo que las personas ya concluyeron.	`investigation_id`.

Los tipos que acepta search_knowledge son: metric, decision, definition, procedure, learning, mental_model, table y document.

ask tiene un límite de 30 preguntas por hora por persona cuando se usa por MCP.

Registrar

Cuando en la conversación aparece algo que la empresa debería saber, el asistente puede registrarlo en Middleout. Lo registrado queda en la memoria de inmediato y con su origen: el asistente que lo registró, a nombre de la persona.

Herramienta	Qué registra	Parámetros principales
`record_decision`	Una decisión: la pregunta, lo que se eligió, las alternativas y los supuestos. Si se registra otra decisión sobre la misma pregunta, reemplaza a la anterior, que queda como historia.	`question`, `outcome`, `alternatives`, `assumptions`, `rests_on`, `scope`.
`record_teaching`	Una enseñanza: una definición, una regla o una preferencia de formato.	`statement`, `subject`, `confirmed`, `scope`, `kind` (`definition`, `rule` o `formatting`).
`record_relation`	Una relación entre dos objetos de la memoria, con la cita que la respalda.	`source`, `target`, `relation`, `quote`, `confirmed`.
`record_question`	Una pregunta abierta que nadie ha respondido todavía.	`statement`, `scope`.
`record_evidence`	Evidencia a favor o en contra de algo que la memoria ya contiene.	`statement`, `stance` (`supports` o `contradicts`), `bears_on`, `scope`.

scope dice a quién le sirve lo registrado: org (toda la organización), team (tu equipo) o user (solo tú).

Buenas prácticas para agentes

Antes de responder sobre el negocio, busca con search_knowledge o pregunta con ask: la empresa puede tener una definición acordada distinta de la habitual.
Cita los handles que usaste, para que la persona pueda abrirlos en Middleout.
Registra solo lo que la persona confirmó o decidió en la conversación, y marca confirmed cuando lo hizo explícitamente.
Si una herramienta dice que algo no existe, puede que la persona no tenga acceso. No lo des por inexistente para toda la empresa.