Tool Catalog

Complete catalog of built-in MCP tool servers with tool names and OCI references.

5 minute read

AgentOps ships six MCP tool servers as OCI artifacts. Each server is a compiled Go binary implementing MCP stdio transport. Agents reference them via AgentTool CRs, and the operator pulls the binary at pod startup via a crane init container.

All tool servers are published to ghcr.io/samyn92/agent-tools/.

kube-explore

Intent-based Kubernetes exploration. Higher-level than raw kubectl – the agent describes what it wants to understand, and the tool returns structured, relevant information.

OCI ref: ghcr.io/samyn92/agent-tools/kube-explore:0.3.3

Tool	Mode	Description
`kube_find`	ro	Find resources by name, label, or type across namespaces.
`kube_health`	ro	Health assessment for a workload or namespace – pods, conditions, events.
`kube_inspect`	ro	Deep inspection of a single resource with related objects.
`kube_topology`	ro	Map relationships between resources (owner refs, selectors, services).
`kube_diff`	ro	Compare live state against desired state or between two resources.
`kube_logs`	ro	Fetch logs with smart filtering (errors, time range, container).
`kube_exec`	rw	Execute a command in a running container.
`kube_apply`	rw	Apply a YAML manifest to the cluster.

8 tools (6 read-only, 2 read-write)

kubectl

Direct kubectl access for all standard operations. Provides fine-grained control when kube-explore’s higher-level tools are insufficient.

OCI ref: ghcr.io/samyn92/agent-tools/kubectl:0.3.3

Read-only tools

Tool	Description
`kubectl_get`	Get resources (supports `-o yaml/json/wide`, label selectors, all-namespaces).
`kubectl_describe`	Describe a resource with events and conditions.
`kubectl_logs`	Fetch container logs (tail, since, previous, container).
`kubectl_top`	Resource usage for pods or nodes.
`kubectl_events`	List events filtered by namespace, type, or involved object.
`kubectl_api_resources`	List available API resources on the cluster.
`kubectl_explain`	Explain a resource field path (e.g. `pod.spec.containers`).

Read-write tools

Tool	Description
`kubectl_exec`	Execute a command in a running container.
`kubectl_apply`	Apply a YAML manifest.
`kubectl_delete`	Delete a resource.
`kubectl_run`	Create and run a pod.
`kubectl_cp`	Copy files to/from a container.
`kubectl_rollout`	Manage rollouts (status, restart, undo, history).
`kubectl_scale`	Scale a deployment, statefulset, or replicaset.
`kubectl_label`	Add or update labels on a resource.
`kubectl_annotate`	Add or update annotations on a resource.

16 tools (7 read-only, 9 read-write)

git

Git operations for repository management. Agents use this for cloning repos, making changes, and pushing commits.

OCI ref: ghcr.io/samyn92/agent-tools/git:0.0.8

Read-only tools

Tool	Description
`git_status`	Show working tree status.
`git_diff`	Show changes between commits, index, or working tree.
`git_log`	Show commit history.
`git_branch_list`	List branches.
`git_show`	Show a commit, tag, or object.

Read-write tools

Tool	Description
`git_add`	Stage files for commit.
`git_commit`	Create a commit.
`git_push`	Push commits to remote.
`git_pull`	Pull changes from remote.
`git_branch`	Create, delete, or switch branches.
`git_clone`	Clone a repository.
`git_clone_or_pull`	Clone if not present, pull if already cloned.

12 tools (5 read-only, 7 read-write)

github

GitHub API operations. Agents use this for pull request workflows, issue management, and CI status checks.

OCI ref: ghcr.io/samyn92/agent-tools/github:0.3.1

Tool	Mode	Description
`github_get_repo`	ro	Get repository information.
`github_list_prs`	ro	List pull requests with filters (state, author, labels).
`github_get_pr`	ro	Get pull request details.
`github_get_pr_diff`	ro	Get the diff for a pull request.
`github_create_pr`	rw	Create a new pull request.
`github_add_pr_comment`	rw	Add a comment to a pull request.
`github_list_issues`	ro	List issues with filters.
`github_get_issue`	ro	Get issue details.
`github_add_issue_comment`	rw	Add a comment to an issue.
`github_list_branches`	ro	List repository branches.
`github_get_check_runs`	ro	Get check run results for a commit or PR.
`github_get_workflow_runs`	ro	Get GitHub Actions workflow run results.

12 tools (8 read-only, 4 read-write)

gitlab

GitLab API operations. Agents use this for merge request workflows, issue management, and pipeline status.

OCI ref: ghcr.io/samyn92/agent-tools/gitlab:0.3.1

Tool	Mode	Description
`gitlab_get_project`	ro	Get project information.
`gitlab_list_mrs`	ro	List merge requests with filters.
`gitlab_get_mr`	ro	Get merge request details.
`gitlab_get_mr_diff`	ro	Get the diff for a merge request.
`gitlab_create_mr`	rw	Create a new merge request.
`gitlab_add_mr_note`	rw	Add a note (comment) to a merge request.
`gitlab_list_issues`	ro	List issues with filters.
`gitlab_get_issue`	ro	Get issue details.
`gitlab_add_issue_note`	rw	Add a note to an issue.
`gitlab_get_pipeline`	ro	Get pipeline status and jobs.

10 tools (6 read-only, 4 read-write)

flux

Flux CD operations for GitOps workflows. Covers inspection, debugging, reconciliation, and lifecycle management of Flux resources.

OCI ref: ghcr.io/samyn92/agent-tools/flux:0.3.1

Read-only tools

Tool	Description
`flux_get`	List Flux resources (kustomizations, helmreleases, sources).
`flux_check`	Check Flux prerequisites and component health.
`flux_stats`	Show reconciliation statistics.
`flux_logs`	Tail Flux controller logs.
`flux_events`	List Flux-related events.
`flux_trace`	Trace a resource from Git source to cluster state.
`flux_tree`	Show the dependency tree for a kustomization or helmrelease.
`flux_diff`	Show pending changes between source and live state.
`flux_export`	Export Flux resources as YAML manifests.
`flux_debug`	Debug a specific Flux resource (gather all related info).
`flux_version`	Show Flux CLI and controller versions.

Read-write tools

Tool	Description
`flux_reconcile`	Trigger immediate reconciliation of a Flux resource.
`flux_suspend`	Suspend reconciliation of a Flux resource.
`flux_resume`	Resume reconciliation of a suspended Flux resource.
`flux_delete`	Delete a Flux resource.

15 tools (11 read-only, 4 read-write)

AgentTool CR example

To make a tool server available to agents, create an AgentTool CR:

apiVersion: agents.agentops.io/v1alpha1
kind: AgentTool
metadata:
  name: kubectl
  namespace: agents
spec:
  description: "Kubernetes operations -- get, describe, logs, apply, exec"
  category: infrastructure
  uiHint: kubernetes-resources
  oci:
    ref: ghcr.io/samyn92/agent-tools/kubectl:0.3.3
    pullPolicy: IfNotPresent

Then bind it to an Agent:

spec:
  tools:
    - name: kubectl
    - name: git
    - name: github

Permission overrides

Restrict an agent to read-only kubectl operations:

spec:
  tools:
    - name: kubectl
      permissions:
        mode: deny
        rules:
          - "kubectl_exec"
          - "kubectl_apply"
          - "kubectl_delete"
          - "kubectl_run"
          - "kubectl_cp"
          - "kubectl_rollout"
          - "kubectl_scale"
          - "kubectl_label"
          - "kubectl_annotate"

Summary

Server	Tools	Read-only	Read-write	OCI tag
kube-explore	8	6	2	`0.3.3`
kubectl	16	7	9	`0.3.3`
git	12	5	7	`0.0.8`
github	12	8	4	`0.3.1`
gitlab	10	6	4	`0.3.1`
flux	15	11	4	`0.3.1`
Total	73	43	30