Letta MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Uses .env files for configuration, allowing storage of Letta API credentials and endpoints securely outside of the codebase.

  • Repository hosting for the Letta MCP server, enabling version control, contribution workflows, and distribution of the server code.

  • Provides package management for the Letta MCP server, managing dependencies and offering scripts for building and running the server.

Servidor Letta MCP

Un servidor que proporciona herramientas para la gestión de agentes, operaciones de memoria e integración con el sistema Letta.

Configuración rápida

Opción 1: Ejecutar con Node.js

# Development (with hot reload) npm run dev:sse # SSE transport # Production npm run build # Build TypeScript first npm run start:sse # SSE transport

Opción 2: Ejecutar con Docker

# Build and run locally docker build -t letta-mcp-server . docker run -d -p 3001:3001 -e PORT=3001 -e NODE_ENV=production --name letta-mcp letta-mcp-server # Or use the public image docker run -d -p 3001:3001 -e PORT=3001 -e NODE_ENV=production --name letta-mcp ghcr.io/oculairmedia/letta-mcp-server:latest

Estructura del directorio

  • index.js - Punto de entrada principal
  • core/ - Funcionalidad principal del servidor
  • tools/ - Implementaciones de herramientas individuales
  • transports/ - Implementaciones de transporte de servidor (stdio y SSE)

Herramientas disponibles

Gestión de agentes

HerramientaDescripciónParámetros requeridosParámetros opcionales
create_agentCrear un nuevo agente Lettanombre, descripciónmodelo, incrustación
list_agentsListar todos los agentes disponibles-filtrar
prompt_agentEnviar un mensaje a un agenteagent_id, mensaje-
get_agentObtener detalles del agente por IDid del agente-
modify_agentActualizar un agente existenteid_del_agente, datos_de_actualización-
delete_agentEliminar un agenteid del agente-
clone_agentClonar un agente existenteid_del_agente_de_origen, nombre_del_nuevo_agenteanular_herramientas_existentes, id_del_proyecto
bulk_delete_agentsEliminar varios agentes-identificadores de agente, filtro de nombre de agente, filtro de etiqueta de agente

Gestión de la memoria

HerramientaDescripciónParámetros requeridosParámetros opcionales
list_memory_blocksListar todos los bloques de memoria-filtro, agent_id, página, tamaño de página, etiqueta
create_memory_blockCrear un nuevo bloque de memorianombre, etiqueta, valoragent_id, metadatos
read_memory_blockLeer un bloque de memoriaid_de_bloqueid del agente
update_memory_blockActualizar un bloque de memoriaid_de_bloquevalor, metadatos, agent_id
attach_memory_blockAdjuntar memoria a un agenteid_de_bloque, id_de_agenteetiqueta

Gestión de herramientas

HerramientaDescripciónParámetros requeridosParámetros opcionales
list_toolsEnumere todas las herramientas disponibles-filtro, página, tamaño de página
list_agent_toolsLista de herramientas para un agente específicoid del agente-
attach_toolAdjuntar herramientas a un agenteid del agenteid_de_herramienta, id_de_herramienta, nombres_de_herramienta
upload_toolSubir una nueva herramientanombre, descripción, código fuentecategoría, id_del_agente
bulk_attach_tool_to_agentsAdjuntar una herramienta a varios agentesid_de_herramientafiltro_de_nombre_del_agente, filtro_de_etiqueta_del_agente

Herramientas adicionales

  • Gestión de modelos : list_llm_models , list_embedding_models
  • Gestión de archivos : list_passages , create_passage , modify_passage , delete_passage
  • Administración del servidor MCP : list_mcp_servers , list_mcp_tools_by_server
  • Importación/Exportación : export_agent , import_agent

Operaciones de Docker

# View container logs docker logs -f letta-mcp # Stop the container docker stop letta-mcp # Update to latest version docker pull ghcr.io/oculairmedia/letta-mcp-server:latest docker stop letta-mcp docker rm letta-mcp docker run -d -p 3001:3001 -e PORT=3001 -e NODE_ENV=production --name letta-mcp ghcr.io/oculairmedia/letta-mcp-server:latest

Configuración con ajustes de MCP

Agregue el servidor a su mcp_settings.json:

"letta": { "command": "node", "args": [ "--no-warnings", "--experimental-modules", "path/to/letta-server/index.js" ], "env": { "LETTA_BASE_URL": "https://your-letta-instance.com", "LETTA_PASSWORD": "yourPassword" }, "disabled": false, "alwaysAllow": [ "upload_tool", "attach_tool", "list_agents", "list_memory_blocks" ], "timeout": 300 }

Para instancias remotas, utilice la configuración de URL:

"remote_letta_tools": { "url": "http://your-server:3001/sse", "disabled": false, "alwaysAllow": [ "attach_tool", "list_agents", "list_tools", "get_agent" ], "timeout": 120 }

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Una implementación de servidor MCP que permite la interacción con la API de Letta para administrar agentes, bloques de memoria y herramientas en el sistema Letta.

  1. Quick Setup
    1. Option 1: Run with Node.js
    2. Option 2: Run with Docker
  2. Directory Structure
    1. Available Tools
      1. Agent Management
      2. Memory Management
      3. Tool Management
      4. Additional Tools
    2. Docker Operations
      1. Configuration with MCP Settings
        ID: fuuaesngfg