Skip to main content
Glama

machines-mcp

Production-oriented Model Context Protocol server for Dedalus Machines.

Lets agents create persistent VMs, wait until they are running, execute commands, and run basic diagnostics — without hand-rolled polling loops.

Tools

Tool

Description

machines_create_and_wait

Create a machine and block until running

machines_get

Retrieve machine status

machines_list

List machines

machines_run

Run a shell command via executions API

machines_sleep / machines_wake

Lifecycle controls

machines_destroy

Destroy a machine

machines_doctor

Auth + API + optional machine health check

Related MCP server: tmux-agent

Quickstart

export DEDALUS_API_KEY=dsk-...
# optional:
# export DEDALUS_BASE_URL=https://api.dedaluslabs.ai
# export DEDALUS_ORG_ID=...

uv sync
uv run python -m src.main

Server listens on Streamable HTTP (:8080 by default).

Claude / Cursor MCP config

{
  "mcpServers": {
    "dedalus-machines": {
      "command": "uv",
      "args": ["run", "python", "-m", "src.main"],
      "cwd": "/path/to/machines-mcp",
      "env": {
        "DEDALUS_API_KEY": "dsk-..."
      }
    }
  }
}

Design notes

  • Built on dedalus-mcp (Dedalus MCP framework) + official dedalus Python SDK

  • Create-and-wait uses client-side polling with timeout / terminal-phase failures

  • machines_doctor is safe for onboarding: checks key presence, API reachability, lists machines

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to safely run bounded, sandboxed tasks on remote machines with persistent state and reviewable artifacts.
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables agents to spawn, monitor, and control CLI coding agents running in isolated tmux sessions, with verified input injection, redacted pane capture, fleet and per-session state classification, lineage tracking, blocking exec with exit codes, cross-agent messaging, waste analytics, and log/ledger reading. Ownership checks, policy controls, and audit events keep every control action safe by default.
      3 npm
      Apache 2.0
    • A
      license
      B
      quality
      B
      maintenance
      Enables any MCP client to start, inspect, wait for, and communicate with fleets of coding agents in worktrees, with structured status, completion events, orchestration mail, and terminal control.
      19
      339 npm
      1
      MIT