mcp-only

Configure an MCP filesystem server with read-only workspace access.

182|8|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/compozy/agh --skill mcp-only
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-only
Source: https://github.com/compozy/agh/tree/main/internal/skills/testdata/loader/mcp-only
Command: npx skills add https://github.com/compozy/agh --skill mcp-only

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you integrate a read-only filesystem capability into an AGH environment by providing MCP server metadata without adding extra skill logic.

Core Features & Use Cases

  • MCP Filesystem Server Metadata: Registers an MCP server named filesystem that can be used by connected agents.
  • Read-only Workspace Access: Configures the server to mount the workspace root with MODE set to read-only.
  • Use Case: When an agent needs to inspect files inside a workspace for analysis (e.g., reading configuration or documents) without modifying them, it can rely on the MCP filesystem server.

Quick Start

Add the workspace and start a session with an agent that supports MCP, then ensure the session can discover the filesystem MCP server in read-only mode using the workspace root.

Frequently Asked Questions about mcp-only

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure an MCP filesystem server for read-only workspace access?

To configure a read-only MCP filesystem server, define the server command, args, and set the environment variable ROOT to your workspace root with MODE explicitly set to read-only. This registers the filesystem server metadata for connected agents.

What is read-only filesystem access used for in agent integration?

Read-only filesystem access in agent integration is used for workspace-scoped inspection tasks, allowing agents to read documents, configs, and project files for analysis while strictly preventing any modifications or writes to the workspace.

Can I use this MCP filesystem server to modify project files?

No, you cannot modify project files using this MCP filesystem server. It is configured with MODE set to read-only, which prevents writes and ensures the workspace root is mounted exclusively for safe inspection and reading.

How do I expose workspace files to an agent runtime via MCP?

You expose workspace files to an agent runtime by providing MCP server metadata that defines the filesystem server command and environment variables. The session then discovers this server to mount the workspace root in read-only mode.

Does an agent need extra skill logic to read workspace files through MCP?

No, an agent does not need extra skill logic to read workspace files. This integration provides the necessary MCP server metadata directly, satisfying the need for server discovery without adding any additional processing logic.