moveit-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
@voxslopuli/moveit-mcp
MCP server exposing the MOVEit Automation REST API over stdio — 52 tools across 6 groups for browsing configuration, controlling tasks and the scheduler, running audit, file-activity, and task-runs reports, and editing tasks and the configuration.
Features
52 tools across 6 groups covering the MOVEit Automation REST API (
/api/v1), targets 2018–2024.1Only 21 tools visible by default (info, tasks, reports, meta); other groups are enabled on demand via meta tools
Browse configuration objects: hosts, task groups, resource groups, global parameters, custom scripts, date lists, PGP keys, SSH keys, SSL certificates, standard scripts, tasks
Control task execution and scheduler: start/stop task runs (with optional task parameters), force-kill (2024.1+), enable/disable the global scheduler
Edit tasks and configuration: create/update/delete tasks, export/import the full configuration incl. the v2 passphrase-encrypted XML API (config import = full overwrite)
Web Admin-equivalent reports: audit (failed transfers), file activity (file/folder errors), task runs (completed runs), plus report export
Resource group ACL management: read, add, update, delete ACL entries (2019.1+)
OAuth token lifecycle handled transparently: automatic refresh, revocation on shutdown
Strict TLS by default; opt-out flag for self-signed certificates
Related MCP server: mcp-devops-deploy
Requirements
Node.js >= 20
MOVEit Automation with the Web Admin REST API reachable over HTTPS
A MOVEit account with API access enabled
Installation
From npm (no clone needed):
npx -y @voxslopuli/moveit-mcpFrom source:
git clone https://github.com/voxslopuli/moveit-mcp
cd moveit-mcp
npm ci
npm run buildConfiguration
All configuration is via environment variables (see .env.example):
Variable | Required | Default | Description |
| yes | — | Server root without |
| yes | — | MOVEit account username |
| yes | — | MOVEit account password |
| no | — | Server hostname sent in the token request when different from the base URL host |
| no |
| Set |
| no | — | Path to a PEM CA bundle file for custom/enterprise CAs. Keeps TLS verification strict — use this for leaf-only chains or API-gateway deployments instead of disabling verification. Alternative when spawning: |
Missing required variables fail startup with a list of what is missing.
Security notes
Credentials come from environment variables only; never passed as tool arguments.
Access/refresh tokens are never logged or echoed in tool output or error messages.
Token lifecycle: ~15 min access token, ~30 min refresh token; refresh is automatic.
Tokens are revoked on
SIGINT/SIGTERMshutdown.Set
MOVEIT_TLS_REJECT_UNAUTHORIZED=falseonly for self-signed certificates in non-production environments.Set
MOVEIT_CA_FILEto a PEM bundle for custom CA chains — verification stays strict.Error messages from the server have RFC 1918 private IP addresses (10.x, 172.16–31.x, 192.168.x) replaced with
[redacted-ip]so server-internal topology is not exposed; public IP addresses are preserved.
Client setup
OpenCode
Add the server to ~/.config/opencode/opencode.json (global) or .opencode/opencode.json (project):
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"moveit-mcp": {
"type": "local",
"command": ["npx", "-y", "@voxslopuli/moveit-mcp"],
"environment": {
"MOVEIT_BASE_URL": "https://moveit.example.com",
"MOVEIT_USERNAME": "svc-account",
"MOVEIT_PASSWORD": "changeme",
"MOVEIT_TLS_REJECT_UNAUTHORIZED": "true"
}
}
}
}
}Verify the connection with opencode mcp list. Set "disabled": true on a server to keep it configured without connecting.
Other clients
claude_desktop_config.json (Claude Desktop):
{
"mcpServers": {
"moveit": {
"command": "npx",
"args": ["-y", "@voxslopuli/moveit-mcp"],
"env": {
"MOVEIT_BASE_URL": "https://moveit.example.com",
"MOVEIT_USERNAME": "svc-account",
"MOVEIT_PASSWORD": "changeme",
"MOVEIT_TLS_REJECT_UNAUTHORIZED": "true"
}
}
}
}Generic MCP client — any client that supports mcpServers:
{
"mcpServers": {
"moveit": {
"command": "npx",
"args": ["-y", "@voxslopuli/moveit-mcp"],
"env": {
"MOVEIT_BASE_URL": "https://moveit.example.com",
"MOVEIT_USERNAME": "svc-account",
"MOVEIT_PASSWORD": "changeme",
"MOVEIT_SERVER_HOST": "",
"MOVEIT_TLS_REJECT_UNAUTHORIZED": "true"
}
}
}
}
MOVEIT_BASE_URLis the server root WITHOUT/api/v1— deployments serve the API at different roots: some athttps://<host>/api/v1(sethttps://moveit.cnyric.org), others under Web Admin athttps://<host>/webadmin/api/v1(sethttps://host/webadmin). A trailing/api/v1is tolerated and stripped automatically.
Tool groups
The default advertised surface is deliberately small: 21 tools (the info, tasks, reports, and meta groups). The remaining groups — config, resources, access — are registered but hidden until enabled. Small tool lists keep tool selection reliable.
Group | Tools | Enabled by default | Minimum server version |
| 1 | yes | — |
| 3 | yes | — |
| 13 | yes | 2018 (task logs 2019.1, |
| 4 | yes | 2018 (report export 2019.1) |
| 4 | no | 2018 (config v2 2019.1+) |
| 20 | no | 2018 (SSL certs, standard scripts, resource groups 2019.1) |
| 7 | no | 2019.1 |
Discover and enable groups with the always-available meta tools. A typical conversation:
User: What groups does this server have? Assistant: (calls
moveit_tools_list) Six groups: info, tasks, reports, and meta are enabled; config, resources, and access are hidden. User: I need to manage hosts and task groups. Assistant: (callsmoveit_tools_enablewithgroups: ["resources"]) Done — the 20 resources tools are now available.
Notes:
Enabling or disabling a group sends a tool-list-changed notification; the group's tools immediately appear in (or disappear from) the client's tool list.
Tools that target newer REST endpoints (e.g.
moveit_kill_taskon 2024.1) return 404 on older servers. That 404 is expected for the server's version and is surfaced as a tool error.Only
infocannot be disabled; every other group can be toggled back off.
Tool reference
Pagination tools accept page, perPage, fields, and (where noted) a name/uid filter — all optional.
Dangerous operations:
moveit_put_config(full config overwrite),moveit_import_config_v2(full config overwrite),moveit_update_task(full task replacement), andmoveit_delete_taskare destructive — get the current object before writing; there is no undo.
Meta (always available)
Tool | Input | Description |
| none | List tool groups with description, enabled flag, and tool names. |
|
| Enable one or more groups, making their tools visible to the client. |
|
| Disable one or more groups (hides their tools). The |
Info (always available)
Tool | Input | Description |
| none | Server info including product version. |
Tasks (enabled by default; 2018)
Tool | Input | Description |
| pagination, | List tasks. |
|
| Get one task by ID. |
| none | List currently running task runs. |
|
| Mutating: start a run of a task on the server. |
|
| Mutating: stop a running task gracefully. |
|
| Mutating: start or stop the global scheduler. |
|
| List log entries (runs) for a task. Requires 2019.1+ (404 on older servers). |
|
| Get one task log entry. Requires 2019.1+ (404 on older servers). |
|
| Mutating: force-kill a running task (2024.1+); use |
| none | Get global scheduler status (running/stopped). Requires 2020.1+ (404 on older servers). |
Task CRUD
Tool | Input | Description |
|
| Create a new traditional task. |
|
| DESTRUCTIVE: replace a task — full replacement, not a merge. |
|
| DESTRUCTIVE: delete a task permanently. |
Reports (enabled by default; 2018)
All report tools take predicate (required), optional orderBy, optional maxCount (positive integer, max 10000). MOVEit accepts single-quoted strings in predicates, e.g. Status=in=('Success','Failure'), which is convenient when embedding in JSON bodies.
Tool | Input | Description |
|
| Audit report. Web Admin failed-transfers view: |
|
| File activity report. Web Admin file/folder errors view: |
|
| Task runs report. Completed runs of both outcomes: |
|
| Export a report using the same query as the inline report tools. Requires 2019.1+ (404 on older servers). Returns an exported report reference rather than inline data. |
Example:
{
"predicate": "Status==\"Failure\"",
"orderBy": "!LogTime",
"maxCount": 100
}Predicate language
Combining:
;orandfor AND,,ororfor OR.Operators:
==,!=,=lt=(<),=le=(<=),=gt=(>),=ge=(>=),=in=,=out=,=like=.=like=supports%(any string) and_(any single character) wildcards.String values are quoted;
=in=/=out=take a parenthesized, comma-separated list of quoted values, e.g.Status=in=("Success","Failure"). MOVEit also accepts single quotes in predicates, e.g.Status=in=('Success','Failure'), which is convenient when embedding the predicate in a JSON body.A leading
!inorderByvalues sorts descending (!LogTime= newest first).
Config (hidden by default; 2018)
Tool | Input | Description |
| none | Export the full configuration ( |
|
| DESTRUCTIVE: import (full overwrite) of the entire configuration. Get first, modify, then import. |
|
| Export the configuration as XML (v2 API, 2019.1+). Encrypted-with-passphrase (portable, secrets encrypted) or sanitized (secrets removed). |
|
| DESTRUCTIVE: import (full overwrite) a configuration XML (2019.1+). Pair with |
Resources (hidden by default; 2018)
Hosts
Tool | Input | Description |
| pagination, | List hosts. |
|
| Get one host by ID (host name). |
Task Groups (deprecated)
Task groups are a deprecated MOVEit Automation concept; kept for older servers.
Tool | Input | Description |
| pagination, | List task groups. |
|
| Get one task group by name. |
Global Parameters
Tool | Input | Description |
| pagination, | List MOVEit Transfer global system parameters. |
|
| Get one global parameter by exact name. |
Custom Scripts
Tool | Input | Description |
| pagination, | List custom scripts. |
|
| Get one custom script by ID (script name). |
Date Lists
Tool | Input | Description |
| pagination, | List date lists (named date collections for schedule conditions). |
|
| Get one date list by ID (list name). |
PGP Keys
Tool | Input | Description |
|
| List OpenPGP keys. |
|
| Get one PGP key by ID. |
SSH Keys
Tool | Input | Description |
| pagination, | List SSH client keys. |
|
| Get one SSH key by ID (key name). |
SSL Certificates (2019.1+)
Tool | Input | Description |
| pagination, | List SSL certificates. |
|
| Get one SSL certificate by SHA-1 thumbprint. |
Standard Scripts (2019.1+)
Tool | Input | Description |
| pagination, | List standard (built-in) scripts. |
|
| Get one standard script by ID. |
Resource Groups (2019.1+)
Tool | Input | Description |
| pagination, | List resource groups. |
|
| Get one resource group by name. |
Access (hidden by default; 2019.1)
User Groups
Tool | Input | Description |
| pagination, | List user groups. |
|
| Get one user group by name. |
Resource Group ACLs
Tool | Input | Description |
| pagination | List ACL entries controlling resource group access. |
|
| Get one ACL entry by ID. |
|
| Mutating: create an ACL entry granting a permission on a resource group. |
|
| Mutating: replace an existing ACL entry (overwrite, not a merge). |
|
| DESTRUCTIVE: delete an ACL entry — removes the permission with no undo. |
Out of scope (v1)
SSH key / PGP key write operations (import/delete) — read-only today
Host management (create/update/delete hosts)
Schedule CRUD (date lists are readable only)
ASx host config editing (AS1/AS2/AS3 details beyond listing)
Troubleshooting
Missing environment variables — startup fails with a list naming exactly which required variables are missing.
401 loops — usually wrong credentials, or
MOVEIT_BASE_URLpointing at the wrong root (bare host for a Web Admin-served deployment, or/webadminwhere the API lives at the host root) whileMOVEIT_SERVER_HOSTdiverges from the base URL host. Verify all three.Self-signed certificate errors — set
MOVEIT_TLS_REJECT_UNAUTHORIZED=false(non-production only).UNABLE_TO_VERIFY_LEAF_SIGNATURE— the server's certificate chain is signed by a CA Node doesn't know (private CA, API gateway). SetMOVEIT_CA_FILEto a PEM bundle containing the leaf and intermediate certificates downloaded from your CA. This keeps TLS verification strict — prefer it over disabling verification.HTTP 422 on reports — invalid
page/perPagecombinations or out-of-rangemaxCount; both must be positive integers (maxCount≤ 10000).404 on newer-API tools — tools targeting newer REST endpoints (
moveit_kill_task2024.1, task logs 2019.1, scheduler status 2020.1, report export 2019.1, config v2 2019.1, SSL certs / standard scripts / resource groups / ACLs 2019.1) return 404 on older servers. This is expected for the server's version and is surfaced as a tool error, not a bug.
Development
Script | Description |
| Run from source via tsx. |
| Build to |
| Run vitest suite. |
| Biome check (lint + format). |
| Biome check with auto-fix. |
Stack: TypeScript (ESM), @modelcontextprotocol/server, zod, tsup, tsx, vitest, Biome, husky + lint-staged.
Workflow is test-driven: write the failing test (red), implement minimally (green), refactor. Commits follow Conventional Commits (feat:, fix:, docs:, ...). Coverage: npx vitest --coverage.
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Headless task management for bots, apps and AI agents. Remote MCP server, OAuth or access token.
List tables, read records and search a knowledgebase in Agiloft.
Remote MCP for 1,500+ APIs. Vault-managed credentials; OAuth or API key. Search, load, and execute.
Read Axis LMS users, courses, learning paths, certifications and reports; manage enrollments.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnables interaction with Tableau Cloud and Tableau Server through the REST API, supporting workbook management, view queries, extract refreshes, and content search operations.-
- AlicenseBqualityDmaintenanceEnables automated deployments, environment management, snapshots, and deployment monitoring through DevOps Deploy's REST API.1513 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to investigate threats, pull reports, manage security policies, and administer deployment infrastructure through the Cisco Secure Access REST API.-
- AlicenseAqualityBmaintenanceEnables management of Omnissa Horizon VDI infrastructure through the Horizon REST API, offering tools for inventory, monitoring, configuration, entitlements, Active Directory, and help desk operations.721MIT