CLI

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.

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:

HTTP
CLI (stdio)

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 Source 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 addSource '{
  "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 sources   # 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

Get started

Local

Hosted

Concepts

Install

Start the service

Connect an agent

Add an integration

Call tools

​Install

​Start the service

​Connect an agent

​Add an integration

​Call tools

Install

Start the service

Connect an agent

Add an integration

Call tools