CLI

Run Executor as a local background service and drive it from the command line.

The CLI runs a small HTTP runtime on your machine: a durable background service that any MCP-compatible agent can connect to. Your integrations, credentials, and policies stay local.

Install

Requires Node.js 20 or newer.

npm install -g executor

pnpm add -g executor

bun add -g executor

yarn global add executor

Start the service

Install the durable background service, then open the web UI:

executor install   # install/start the durable background service
executor web        # open the web UI at http://127.0.0.1:4788

executor install registers Executor so it keeps running across restarts. For a throwaway foreground runtime instead, run executor web --foreground.

Behind a TLS reverse proxy

The daemon listens over HTTP on loopback. If a reverse proxy terminates TLS in front of it, set EXECUTOR_WEB_BASE_URL to the public HTTPS origin so browser approval links use that origin:

EXECUTOR_WEB_BASE_URL=https://executor.example.test executor daemon run --foreground

Generated approval URLs take this value, not X-Forwarded-Proto or Host.

Connect an agent

Add Executor to any MCP client (Claude Code, Cursor, OpenCode) with npx add-mcp. It detects the client and writes its config for you. Connect over HTTP or through the CLI:

Executor serves a streamable-HTTP MCP endpoint at http://127.0.0.1:4788/mcp:

npx add-mcp http://127.0.0.1:4788/mcp --transport http --name executor

The Connect card in the web UI shows this command with your exact URL (and port, if it differs) already filled in.

With the executor CLI on your PATH, the client launches executor mcp directly (no URL needed):

npx add-mcp "executor mcp" --name executor

Add an integration

From the web UI, click Add Integration and paste an OpenAPI, GraphQL, or MCP URL. Executor detects the type, indexes the tools, and handles auth. Or add one from the CLI:

executor call executor openapi addIntegration '{
  "spec": "https://petstore3.swagger.io/api/v3/openapi.json",
  "namespace": "petstore",
  "baseUrl": "https://petstore3.swagger.io/api/v3"
}'

Use baseUrl when the OpenAPI document has relative servers entries (e.g. "/api/v3").

Confirm it’s live:

executor tools integrations   # lists configured integrations + tool counts

Call tools

executor tools search "send email"      # find tools by intent
executor call github issues --help      # browse a namespace
executor call github issues create '{"owner":"octocat","repo":"Hello-World","title":"Hi"}'

executor call, executor resume, and executor tools … auto-start the local daemon if it isn’t already running. If an execution pauses for auth or approval, resume it:

executor resume --execution-id exec_123