olivetin-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_pending_approvalsA | List all OliveTin actions currently waiting for human approval, with the URL the human must visit to approve or deny. Call this after triggering a destructive action to get the approval link. No approval needed — read-only. |
| brave_searchA | Search the web using the Brave Search API. Returns top results with title, URL, and description. No approval needed — read-only. |
| render_diagramA | Render a Mermaid diagram spec as PNG via mermaid.ink. Returns /tmp path. No approval needed. |
| render_chartA | Render a Chart.js config as PNG via quickchart.io. Returns /tmp path. No approval needed. |
| list_olivetin_actionsA | List all available OliveTin actions: IDs, titles, argument schemas, and whether each requires approval. No approval needed. |
| get_execution_logsA | Get recent OliveTin execution history (LogEntry records). Proto fields: datetime_started, action_title, output, exit_code, timed_out, user, execution_tracking_id, blocked. No approval needed. |
| get_execution_statusA | Check the status of a running OliveTin action by its execution_tracking_id (returned by StartAction). No approval needed. |
| kill_actionA | Kill a currently running OliveTin action by its execution_tracking_id. Only works when the LogEntry's can_kill field is true. Returns killed/already_completed/not_found status. No approval needed — this is a safety stop, not a destructive write. |
| start_action_asyncA | Start an OliveTin action asynchronously (StartAction RPC). Returns an execution_tracking_id immediately without waiting for completion. Use get_execution_status to poll progress, kill_action to cancel. Requires human approval — this triggers a real action on the host. |
| restart_actionA | Restart a previously executed OliveTin action by its execution_tracking_id (RestartAction RPC). Re-runs with the same arguments as the original execution. Requires human approval — this re-triggers a real action on the host. |
| validate_argumentA | Validate an argument value against an OliveTin argument type (ValidateArgumentType RPC). type: unicode | ascii_identifier | url | int | float | bool. No approval needed — read-only. |
| whoamiA | Return information about the current authenticated OliveTin user (WhoAmI RPC). No approval needed — read-only. |
| get_server_infoA | Return OliveTin server info and version (Init RPC). No approval needed — read-only. |
| get_action_bindingA | Fetch a single OliveTin action binding by ID (GetActionBinding RPC). Returns full Action proto including arguments, icon, timeout, and ACL fields. No approval needed — read-only. |
| get_entitiesA | List all OliveTin entities (GetEntities RPC). Entities represent monitored services/hosts. No approval needed — read-only. |
| get_entityA | Fetch a single OliveTin entity by unique key and type (GetEntity RPC). No approval needed — read-only. |
| readyzA | OliveTin readiness probe (GetReadyz RPC). Returns 200/ready when OliveTin is healthy. No approval needed — read-only. |
| reload_actionsA | Force an immediate refresh of the OliveTin action catalog from GetDashboard. Use this after adding, removing, or editing actions in OliveTin config without waiting for the automatic refresh interval. No approval needed — read-only. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| olivetin_run | Compose a prompt for running an OliveTin action with formatted output. output_format: plain | json | markdown | summary |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| OliveTin Actions Catalog | Full catalog of OliveTin actions with argument schemas (from ActionArgument proto), read-only status, approval requirements, and prompt templates. Read this before calling any action. |
| OliveTin Execution Logs | Recent execution history across all actions (LogEntry proto records: datetime_started, output, exit_code, timed_out, user, execution_tracking_id, blocked). |
| Pending Approvals | Live list of actions waiting for human approval, with approval URLs. Read this after triggering a destructive action to get the link to share. |
TDQS
Scored across 18 tools
The core OliveTin tools are mostly distinct, but the inclusion of unrelated tools (brave_search, render_diagram, render_chart) creates confusion about the server's purpose and could lead to misselection. There is also mild overlap between get_execution_logs and get_execution_status, though descriptions help clarify.
Most tools follow a clear verb_noun snake_case pattern (e.g., list_olivetin_actions, get_execution_status, kill_action). Minor exceptions like whoami, readyz, and brave_search deviate from the pattern but are still recognizable and don't cause significant inconsistency.
At 18 tools, the set is on the heavier side. The 15 OliveTin-specific tools are reasonably scoped for the domain, but the three unrelated utility tools pad the count and make the server feel less focused.
The OliveTin surface covers the core lifecycle: listing/getting actions, starting/killing/restarting, status/logs, approvals, entities, validation, user/server info, health, and reload. Minor gaps include lack of entity mutations and synchronous action start, but these are not critical for typical workflows.