io.github.wyre-technology/action1-mcp

Official

by wyre-technology · TypeScript

Action1

Action1 MCP server — endpoint inventory, patch visibility, and policy automation via REST API.

View endpoint inventory, patch status, and automate policies across managed devices.

README.md3 KBView on GitHub

Action1 MCP Server

MCP server for Action1 — endpoint inventory, patch visibility, and policy automation via the Model Context Protocol.

Read-only in v1. Deploy / automation surface is intentionally separated to a later release for blast-radius reasons (a bad policy push can brick endpoint fleets).

Tools

Tool	Description
`action1_navigate`	Discover available tools by domain (organizations / endpoints / policies / updates)
`action1_list_organizations`	List Action1 tenants accessible to the configured credentials
`action1_list_endpoints`	List managed devices in an organization
`action1_get_endpoint`	Get a single endpoint by id
`action1_list_missing_updates`	List missing OS/application patches across endpoints — Action1's headline value-prop
`action1_list_policies`	List automation / policy / remediation rules

API surface maps to PSAction1 (Action1's MIT-licensed PowerShell module). When the v1 surface earns its keep, write tools (deploy, requery, package upload) come in v2 behind separate review.

Usage

Claude Desktop (MCPB)

Install via the MCPB bundle from the latest release.

Required credentials (created in Action1 → Settings → API Credentials, non-recoverable on creation — copy immediately):

API Key (Client ID)
Secret
Region (NorthAmerica default; also Europe, AsiaPacific, Australia)
Optional default organization id (for single-tenant use)

Stdio (direct)

bash

ACTION1_API_KEY=... \
ACTION1_SECRET=... \
ACTION1_REGION=NorthAmerica \
ACTION1_DEFAULT_ORG_ID=org-... \
npx -y github:wyre-technology/action1-mcp

HTTP (gateway mode)

bash

MCP_TRANSPORT=http PORT=8080 AUTH_MODE=gateway \
  docker run -p 8080:8080 ghcr.io/wyre-technology/action1-mcp:latest

Per-request credentials via headers:

X-Action1-API-Key
X-Action1-Secret
X-Action1-Region
X-Action1-Default-Org-Id

Architecture

code

src/
├── index.ts                  # stdio + HTTP transports, tool dispatch
├── sdk/
│   └── action1-client.ts     # embedded REST + OAuth client (factor-out candidate
│                             # if surface crosses ~20 tools / 2+ domains)
├── utils/
│   ├── client.ts             # credential resolution (env vs gateway headers)
│   └── types.ts              # DomainHandler interface
├── domains/                  # one file per resource type
│   ├── organizations.ts
│   ├── endpoints.ts
│   ├── policies.ts
│   └── updates.ts
└── __tests__/domains/        # one test per domain

Per-request credential isolation via AsyncLocalStorage — concurrent requests in HTTP mode never share credentials through process.env.

Development

bash

npm install
npm run build
npm test
npm run dev      # tsc --watch
npm run lint     # eslint
npm run typecheck

License

Apache-2.0. See LICENSE.

Install

Configuration

Environment variables

ACTION1_CLIENT_IDrequired

Action1 OAuth client ID

ACTION1_CLIENT_SECRETrequiredsecret

Action1 OAuth client secret

ACTION1_TENANT

Action1 tenant identifier (subdomain). Provide this or ACTION1_BASE_URL.

ACTION1_BASE_URL

Action1 base URL (e.g. https://your-instance.action1.com). Provide this or ACTION1_TENANT.

MCP_TRANSPORTdefault stdio

Transport mode for the server. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting.

AUTH_MODEdefault env

Credential source: 'env' reads vars locally, 'gateway' expects header injection from the WYRE MCP Gateway.

LOG_LEVELdefault info

Log verbosity: debug, info, warn, error

claude_desktop_config.json

{
  "mcpServers": {
    "action1-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wyre-technology/action1-mcp:v1.0.6"
      ],
      "env": {
        "ACTION1_CLIENT_ID": "<YOUR_ACTION1_CLIENT_ID>",
        "ACTION1_CLIENT_SECRET": "<YOUR_ACTION1_CLIENT_SECRET>",
        "ACTION1_TENANT": "<YOUR_ACTION1_TENANT>",
        "ACTION1_BASE_URL": "<YOUR_ACTION1_BASE_URL>",
        "MCP_TRANSPORT": "stdio",
        "AUTH_MODE": "env",
        "LOG_LEVEL": "info"
      }
    }
  }
}