agents.mcp

agents.mcp

A minimal MCP server that reads AGENTS.md from the working directory and serves its contents as the server's instructions field. This lets MCP clients automatically pick up project-level agent instructions without any extra configuration.

The server exposes no tools, prompts, or resources — it only provides instructions.

Install

go install github.com/karashiiro/agents.mcp@latest

Usage

Add the server to your MCP client configuration, setting the working directory to your project root:

{
  "mcpServers": {
    "agents-mcp": {
      "command": "agents-mcp",
      "cwd": "/path/to/your/project"
    }
  }
}

When the server starts, it reads AGENTS.md from the working directory and wraps the contents with delimiters:

=== AGENTS.md ===
<contents of AGENTS.md>
=== AGENTS.md ===

If AGENTS.md is not found, the server logs a warning to stderr and starts with empty instructions.