Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MCP_WORKSPACE_ROOTNoThe only supported environment override; sets the workspace root. The server defaults to the current directory when no workspace is supplied.

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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
server_healthB

Return safe server health, version, configuration state, and diagnostics status.

workspace_infoA

Return an opaque workspace identifier and active safety limits.

list_directoryC

List one workspace directory. Use cursor for the next bounded page.

get_file_metadataB

Return safe metadata for one file without reading its contents.

read_text_fileC

Read a bounded UTF-8 excerpt from an approved workspace file.

search_workspace_textC

Search bounded text files and return sanitized line excerpts.

summarize_project_structureC

Return a shallow, bounded inventory without reading file contents.

git_repository_statusB

Return bounded read-only Git status; no untracked filenames are enumerated.

git_recent_historyB

Return a bounded list of recent commit summaries.

git_diff_summaryA

Return bounded diff statistics without patch contents.

get_capability_helpA

Return the capability inventory or one capability's manifest entry.

validate_server_configurationB

Validate the loaded configuration without returning machine-specific paths.

create_diagnostic_bundleB

Write a sanitized local diagnostic summary to the approved diagnostics directory.

create_fileB

Create a file (and parent dirs) with the given content. Writes are atomic.

edit_fileA

Replace old_string with new_string in a file. Fails unless it matches exactly once (or replace_all is true). dry_run=true returns a unified diff without writing.

edit_file_multiA

Apply several edits atomically. Each edit is {"old_string": ..., "new_string": ..., optional "replace_all": "true"}. Edits apply in order; if any fails nothing is written.

replace_linesA

Replace lines start_line..end_line (1-based, inclusive) with new_text. Use end_line=start_line-1 to insert before start_line.

create_directoryC

Create a directory and any missing parents. Succeeds if it already exists.

delete_fileA

Delete a file or directory (recursively). Irreversible. Refuses the workspace root, trees that contain links, nested repositories or protected files, and huge trees.

move_pathB

Move or rename a file or directory inside the workspace. Never overwrites.

copy_pathB

Copy a file or directory inside the workspace. Never overwrites.

grepA

Regex search file contents. Returns path:line: text matches. Skips git-ignored files (and .git, node_modules, .venv) unless respect_gitignore=false. Use offset to page.

globA

Find files by glob pattern (e.g. '**/*.py'), relative to path. Skips git-ignored files unless respect_gitignore=false. Use offset to page.

run_commandA

Run a shell command and return exit code, stdout and stderr. Uses PowerShell on Windows and the default shell elsewhere. The working directory must be inside the workspace (default: the workspace root). The command itself is NOT confined: a shell can still reach any path the server's user can. Secret-named environment variables are removed and output is redacted.

git_statusC

Show short git status.

git_diffB

Show git diff (optionally staged and/or for one path).

git_logC

Show recent commits.

git_addC

Stage files.

git_commitC

Commit staged changes.

git_initB

Initialise a new git repository (non-destructive; existing repos are left intact).

git_branch_createA

Create a new branch (and optionally switch to it). Never overwrites an existing branch.

git_switchB

Switch to an existing branch. Git refuses if it would overwrite local changes.

git_tag_createB

Create a tag (annotated if message given). Never moves or replaces an existing tag.

git_pushA

Push a branch (default: current) to a remote. Force pushes and ref deletion are not supported. tags=true pushes tags instead of a branch.

git_blameB

Show who last changed each line of a file (read-only). Optionally limit to a line range.

git_showB

Show a commit's message and diff (read-only). stat_only=true gives only the file summary.

git_branch_listA

List branches with their last commit and upstream (read-only). all_branches includes remotes.

git_stash_listB

List stashes (read-only).

git_remote_infoA

List configured remotes and their URLs (read-only). Credentials in URLs are masked.

git_diff_statB

Summarise changes per file (read-only), compact for large diffs. base compares with a revision.

run_testsC

Run pytest on a path with optional extra args (e.g. '-k name -x').

lintB

Lint Python code with ruff (optionally auto-fix).

format_codeB

Format Python code with ruff; check_only=True only reports.

web_fetchA

Download a web page (after explicit user confirmation), sanitise it and save it as a local markdown file. Returns the file path only; read the file to consume it. Executable/archive/ document extensions and non-text content types are rejected; scripts, forms, iframes, event handlers and unsafe links are stripped. Private/loopback addresses are blocked.

convert_dataA

Convert between json, yaml, toml, csv, xml and psd1 (PowerShell data files). Provide either path or text. from_format is inferred from the file extension when omitted. With output_path the result is written there; otherwise it is returned. Reading psd1 needs pwsh (restricted language mode, no code execution); XML uses @attr / #text conventions.

query_dataB

Extract values from a json/yaml/toml/csv/xml/psd1 file with a path expression such as 'servers[0].name', 'users[].email' or '.port'. Returns JSON (a list of matches).

script_to_markdownA

Convert a script into literate markdown: column-0 comment blocks (and PowerShell <# #> blocks) become prose, everything else becomes fenced code. Heuristic and meant for documentation; markdown_to_script reverses it.

markdown_to_scriptA

Extract code from a markdown file. Only fenced blocks tagged with language are kept unless extract_all_blocks is true. Prose becomes comments when include_prose is true.

pandoc_convertB

Convert documents with pandoc (docx, html, md, rst, pdf output needs a LaTeX engine...). Runs in --sandbox mode so the document cannot read other files or run filters.

http_requestA

Send an HTTP request (localhost and private addresses allowed) and report status, timing, redacted headers and a truncated body. Optional assertions: expect_status, expect_json ({"data.items[0].id": 5} path->value), expect_contains (substring of body), max_latency_ms. Result begins with PASS/FAIL when assertions are given.

api_load_testA

Tiny load probe: send requests requests (max 200) with concurrency workers (max 20) and report status counts, errors and latency percentiles. Use only against systems you own.

system_infoA

OS, kernel, uptime, CPU, load, memory, swap and disk usage for this machine.

list_processesB

List processes (pid, name, user, cpu%, memory) sorted by 'memory' or 'cpu' or 'pid'.

list_portsB

List TCP/UDP sockets with owning process. May need elevated rights to see other users' PIDs.

network_interfacesA

NIC configuration: addresses, netmask, MAC, MTU, speed and up/down state, plus I/O counters.

dns_lookupB

Resolve a hostname to its addresses using the system resolver.

check_tcp_portB

Test whether a TCP connection to host:port succeeds, with connect time.

list_servicesB

List services (systemd on Linux, Get-Service on Windows, launchctl on macOS). state: e.g. running / stopped (Windows) or running / failed / active (systemd).

service_statusC

Detailed status of one service.

read_event_logsA

Recent system events. Linux: journalctl (source = unit name, level = minimum severity). Windows: Get-WinEvent (source = log name, default 'System'; level = exact level). macOS: log show. level: critical|error|warning|info|verbose.

cim_queryA

Query CIM/WMI classes via Get-CimInstance (Windows only), e.g. Win32_OperatingSystem, Win32_LogicalDisk, Win32_NetworkAdapterConfiguration, Win32_Service. filter is a WQL WHERE clause such as "DriveType=3". Read-only.

environment_variablesB

Environment variables of the server process. Values of secret-looking names are redacted.

todo_listA

List the workspace todo scratchpad. Optional status filter: pending, in_progress, done.

todo_addA

Add a todo (status pending) to the workspace scratchpad and return the updated list.

todo_updateA

Change a todo's status (pending, in_progress, done) and/or text; returns the updated list.

todo_removeA

Remove one todo from the scratchpad by id; returns the updated list.

policy_infoA

Show whether an operator policy file exists and its contents (allow/deny lists, command deny patterns, web_fetch domain allow-list).

get_tool_docsA

Return usage docs and examples for a toolkit group (filesystem, search, shell, git, python, web-fetch, data-conversion, api-testing, diagnostics, todo, policy) or 'index'. Call this after a tool error.

Prompts

Interactive templates invoked by user choice

NameDescription
inspect_workspaceGuide a staged, low-risk workspace inspection.
understand_projectGuide concise project-structure and documentation review.
troubleshoot_serverGuide safe local server troubleshooting.
choose_toolRoute a request to the least-privileged capability.

Resources

Contextual data attached and managed by the client

NameDescription
capability_index
tool_documentation_index
prompt_documentation_index
resource_documentation_index
skill_documentation_index
security_summary
configuration_reference
troubleshooting_guide
release_information
compatibility_information
known_limitations
toolkit_indexIndex of toolkit groups and rules that apply to every tool.

TDQS

C2.9/5.0

Scored across 68 tools

Disambiguation3/5

Tools are grouped into clear domains, but several within-domain pairs overlap heavily: git_status vs git_repository_status, git_log vs git_recent_history, and git_diff vs git_diff_summary vs git_diff_stat. Descriptions help distinguish bounded/read-only variants, but an agent could still easily misselect among them.

Naming Consistency3/5

All names are snake_case, which is consistent, but the structural convention is mixed: verb_noun (list_directory, read_text_file), noun_verb (todo_list, git_status), and noun_noun (service_status, git_repository_status) all appear. The domain prefixes help readability, but there is no single predictable pattern.

Tool Count1/5

With 68 tools, the surface is extremely large even for a broad personal automation server, and several tools duplicate existing read-only git functionality. This is squarely in the 50+ extreme-count range and makes discovery and selection harder.

Completeness4/5

The server covers filesystem, search, shell, Python tooling, git, data conversion, web/API testing, diagnostics, todos, and system inspection with broad lifecycle support. The main gaps are git network/workflow operations such as clone/fetch/pull/merge and service or process control, though run_command provides a workaround.

Maintenance

ActivityNo data
ResponsivenessSyncing