Endor

What is Endor?

Endor is an MCP (Model Context Protocol) server that provisions and manages ephemeral infrastructure services — including PostgreSQL, MariaDB, Redis, Valkey, Memcached, and Alpine Linux environments — directly from AI clients. It allows developers to spin up disposable databases, caches, and development environments, execute shell commands inside service VMs, and retrieve connection details, all via natural language through an MCP-compatible assistant.

How to use Endor?

Install the Endor CLI globally with npm install -g @endorhq/cli, then start the MCP server in stdio mode using endor mcp (add --allow-net for network access). Configure your AI client to connect with { "mcpServers": { "endor": { "command": "endor", "args": ["mcp", "--allow-net"] } } }. Use the server’s tools to list, provision, stop, and get connection details for services, and to run commands inside running service instances.

Key features of Endor

• List available service types that can be provisioned
• List all currently running service instances
• Run shell commands inside any running service VM
• Provision, stop, and get connection details for six service types
• Each service offers run, stop, and get_connection tools
• Services are ephemeral and start with default, unsecured configurations

Use cases of Endor

• Provision a disposable PostgreSQL database for a one-off test or demo
• Combine a database and a cache (e.g., PostgreSQL + Redis) for a microservice stack
• Spin up an Alpine Linux environment to install tools and clone a project for development
• Execute ad‑hoc queries or commands inside running services without manual SSH
• Rapidly create and tear down isolated service instances to avoid local setup overhead

FAQ from Endor

What service types does Endor support?

Endor currently supports Alpine Linux, MariaDB, Memcached, PostgreSQL, Redis, and Valkey.

How do I connect to a provisioned service?

Use the get_{service}_connection tool to retrieve the host, port, username, and password (if applicable). For PostgreSQL and MariaDB, SSH access is also available on port 2222 as user root.

Does Endor authenticate database services?

No. By default, PostgreSQL (user postgres), MariaDB (user root), Redis, Valkey, and Memcached all start with no password required.

What is the maximum timeout for commands?

The run_command_in_service tool accepts an optional timeout parameter in seconds, with a maximum of 600 seconds (10 minutes).

Should I manually assign ports?

Endor recommends letting the platform assign host ports automatically to avoid conflicts. You can optionally specify a preferred port via the hostPort parameter.