Skip to main content
Glama
praxisgaurdrails

Praxis Lite

Official
by praxisgaurdrails
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

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

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

Tools

Functions exposed to the LLM to take actions

NameDescription
fs_searchA

Search the user's disk by filename (v1 filename fuzzy).

Returns a ranked list of file paths whose name matches the query. Ranking blends fuzzy match, recency, and a directory prior — so files in ~/Documents outrank equivalents in ~/Library/Caches.

Args: query: The text the user is looking for. Case-insensitive. Synonyms are auto-expanded (resume also matches cv, passport matches id, etc.). paths: Optional list of directories to search under. Empty = search the user's home directory. ext: Optional extension filter, e.g. "pdf". limit: Max hits to return (default 10).

Returns: result.hits is a list of {path, score, matched_query} dicts sorted best-first.

fs_readA

Read a file's bytes as a UTF-8 string.

Refuses to touch credential stores (~/.ssh, ~/.aws, keychains, .env) regardless of principal. Files larger than max_bytes (or the executor's default cap) are truncated with result.truncated == true.

fs_statA

Return metadata for a path — size, mtime, mode, is_dir, is_file.

fs_list_dirA

List entries directly under a directory.

Args: path: The directory to list. glob: Optional shell-style pattern, e.g. "*.pdf". Empty = list everything.

fs_create_dirA

Create a directory (parents included). Idempotent.

For external agents this triggers a user-approval prompt.

fs_create_fileA

Create a new file with the given UTF-8 content.

Refuses if the path already exists — use fs_overwrite (T2) to replace an existing file.

For external agents this triggers a user-approval prompt.

fs_writeA

Write UTF-8 bytes to a file.

Args: path: Destination file. content: The text to write. if_exists: One of "error" (default — refuse), "append" (add to end). Overwriting an existing file is a T2 op — use fs_overwrite.

fs_deleteA

Delete file(s) — staged to Praxis's trash for 24h.

Files are moved to ~/.praxis/trash/ first, not hard-deleted. The user can restore any staged entry within the retention window.

For external agents this is blocked by default. A trusted- agent policy may enable it with per-op approval. For the local user (praxis:local) this triggers OS-native 2FA + a 10s cool-off before the trash move happens.

fs_moveB

Move file(s) into a target directory. Destructive → T2.

fs_renameA

Rename a file in place. new_name must be a basename.

fs_overwriteA

Overwrite an existing file — backs the original up to trash first.

Unlike fs_write this replaces existing content but always keeps a recoverable copy in ~/.praxis/trash/.

praxis_statusA

Report the daemon's current principal, trash size, and health.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.9/5.0

Scored across 12 tools

Disambiguation4/5

Tools are mostly distinct, but fs_create_file and fs_write with if_exists=error overlap in purpose (both create new files), and fs_rename vs fs_move both relocate files. Descriptions clarify differences, but a few tools could be confused in edge cases.

Naming Consistency5/5

All file tools follow a consistent fs_verb pattern (fs_search, fs_read, fs_stat, fs_list_dir, etc.), with clear verb usage. praxis_status is a separate but logical outlier for daemon status, not a deviation from the file operation naming.

Tool Count5/5

12 tools is a well-scoped size for a file system server, covering search, read, metadata, directory listing, creation, writing, renaming, deletion, moving, overwriting, and status. Each tool has a clear role without redundancy.

Completeness4/5

The tool set covers common file operations comprehensively, but lacks a copy operation (only move/rename are available). Also missing permission modification, though that may be intentionally out of scope. The trash/recovery mechanism is a nice extra.

Maintenance

ActivityNo data
ResponsivenessNo issues

Resources