agentctl
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@agentctlwhat's the current fleet status?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
agentctl
K8s-native agent/model workload operator with SAM mesh registration and MCP ops plane.
Replaces process-spawning orchestrators (vllm-orchestrator) with declarative K8s resources. Every operation is exposed as an MCP tool for LangGraph/LangChain workflow composition.
Architecture
LangGraph agent ──MCP──▶ agentctl ops plane (:8091)
│
┌─────────┼─────────┐
▼ ▼ ▼
workload_* fleet_* sam_*
tools tools tools
│ │ │
▼ ▼ ▼
K8s API K8s API SAM node
(CRDs) (pods) (discovery)Related MCP server: Hatchet MCP
Install
pip install agentctl
# or
uv pip install agentctlInstall (cluster)
kubectl apply -f https://github.com/moreWax/agentctl/releases/latest/download/install.yamlThis installs the CRD, the operator, and the MCP ops plane into
agentctl-system. The ops plane is reachable in-cluster at
http://agentctl-mcp.agentctl-system.svc.cluster.local:8091/mcp
(stateless Streamable HTTP).
Usage
Deploy the example workloads
kubectl apply -f examples/qwen3.8-27b.yaml # Qwen3.8-27B, TP2 on 2 GPUs
kubectl apply -f examples/qwen3.8-27b-fp8.yaml # FP8 variant, single GPU
kubectl apply -f examples/litellm-gateway.yaml # LiteLLM proxy gatewayFrom source (development)
uv venv && uv pip install -e ".[dev]"
kubectl apply -f crd/agentctl-crd.yaml
agentctl serve # operator (kopf controllers)
agentctl mcp --port 8091 # MCP ops-plane server (stateless Streamable HTTP)Deploy a model workload
kubectl apply -f examples/qwen3.8-27b.yaml # Qwen3.8-27B, TP2 on 2 GPUs
kubectl apply -f examples/qwen3.8-27b-fp8.yaml # FP8 variant, single GPU
kubectl apply -f examples/litellm-gateway.yaml # LiteLLM proxy gatewayThe LiteLLM gateway routes OpenAI-compatible requests to the vLLM backends.
Point your agents at http://litellm-gateway:4000/v1 and use model names like
qwen3.8-27b or qwen3.8-27b-fp8.
MCP tools (for LangGraph / agent composition)
The ops plane exposes 3 action-routed tools — a small surface that keeps
agent context cheap and tool selection trivial, while all 20 capabilities
stay available as actions. Everything is stateless, returns structured JSON,
and gates destructive actions behind approved=true.
fleet(action=...) — cluster-wide views (read-only)
Action | Params | Description |
| — | Aggregate: workloads by phase, GPU totals |
| — | Per-node capacity / allocated / free + consumers |
|
| Per-pod: node, boot phase, role, sleeping, GPUs, restarts |
|
| Dry-run placement — call before boot |
|
| Endpoint readiness per service |
|
| SAM mesh discovery |
workload(action=...) — AgentWorkload CRUD
Action | Params | Description |
|
| Workloads with phase, GPUs, pin state |
|
| Full detail incl. per-pod boot phases |
|
| Recent container logs per pod |
|
| 0 parks; refuses pinned scale-down unless forced |
|
| Delete workload + pods |
|
| Create (idempotent) |
|
| Remove |
model(action=...) — model lifecycle & actuation
Action | Params | Description |
|
| Deploy + optional wait → |
|
| Pod phases + vLLM markers ( |
|
| Suspend, free GPUs. FMA: seconds-level ( |
|
| Resume; FMA wake takes seconds |
|
| Force-delete hung pod; Deployment recreates it |
|
| Pin blocks scale-down/sleep unless forced |
Agent boot-wait pattern (LangGraph loop):
model(action="boot", model_id="qwen38-27b", image="vllm/vllm-openai:v0.26.0", gpu_count=2)
while True:
s = model(action="boot_status", model_id="qwen38-27b")
if s["ready"]: break # proceed to inference
if s["failed"]: ... # inspect s["pods"], kill_pod + retry
time.sleep(10) # poll againErrors are structured: {"error": "unknown_action", "valid_actions": [...]},
{"error": "missing_params", "required": [...]}, or {"error": <cause>, "detail": ...}.
Development
uv venv && uv pip install -e ".[dev]"
pytest tests/ -qLicense
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Control plane for autonomous software labor. Agents claim objectives over MCP with audit trail.
MCP Hub: AI service discovery, per-user OAuth, and multi-service workflow orchestration
MCP-first control plane for ProAgentStore agents and private instances.
Protocol-native energy infrastructure orchestration for AI data centers. Provides 46 MCP tools across 8 grid protocols (IEC-61850, DNP3, Modbus, OCPP, OpenADR, IEEE 2030.5, IEC 60870-5-104, ICCP) with 5 core API primitives: connect, dispatch, settle, comply, and intel. Enables AI agents to programmatically interact with substations, grid interfaces, and energy assets for real-time workload-grid coordination.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables management of Mistral AI agents through MCP tools including creating, listing, searching, viewing details, and deleting agents. Integrates with Mistral API to provide agent management capabilities through natural language interactions.1
- AlicenseNot gradedqualityBmaintenanceEnables running durable, traceable AI agents via LangGraph through a universal MCP interface, integrating with Hatchet for orchestration, logging, and retries. Provides tools for knowledge management (ingestion, RAG) and Kubernetes operations (diagnosis, auto-fix).MIT
- AlicenseAqualityBmaintenanceGoverned Kubernetes operations for AI agents with 15 MCP tools, audit logging, policy engine, and safety features.55MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI-powered Kubernetes management using natural language, supporting kubectl, Helm, diagnostics, and port forwarding via MCP protocol.MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/moreWax/agentctl'
If you have feedback or need assistance with the MCP directory API, please join our Discord server