# actuate MCP server

> Turns TypeScript files into durable, stateful tools for AI agents with built-in human approvals, SQLite storage, and exactly-once execution.

- Repository: https://github.com/actuate-run/actuate
- Page: https://hostedmcp.org/servers/actuate-run/actuate
- Transport: stdio
- Stars: 1
- License: Apache-2.0

## Install

### Claude Code

```sh
claude mcp add actuate -- npx -y @actuate/cli
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "actuate": {
      "command": "npx",
      "args": [
        "-y",
        "@actuate/cli"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "actuate": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@actuate/cli"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"actuate","type":"stdio","command":"npx","args":["-y","@actuate/cli"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "actuate": {
      "command": "npx",
      "args": [
        "-y",
        "@actuate/cli"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add actuate -- npx -y @actuate/cli
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.actuate]
command = "npx"
args = ["-y", "@actuate/cli"]
```

### Gemini CLI

```sh
gemini mcp add -s user actuate npx -- -y @actuate/cli
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "actuate": {
      "command": "npx",
      "args": [
        "-y",
        "@actuate/cli"
      ]
    }
  }
}
```

## FAQ

### How does actuate ensure a tool doesn't run twice?

It uses a journaling system where each step is recorded. Replays and retried tool calls receive the stored result instead of executing the logic again.

### Does actuate charge for periods when a tool is waiting for approval?

No, the system hibernates during sleep or wait periods, meaning nothing runs and nothing is billed until the tool wakes up.

### What kind of database does each actuator use?

Each actuator has its own dedicated SQLite database with support for migrations and data exports.
