# Wyrd

> Wyrd is an open-source MCP server for files and documents. Serves one granted folder to any AI client, read-only, behind a path-containment fence. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Repository:** https://github.com/mortalpastry/wyrd-mcp
- **MCP Registry name:** com.wyrdmcp/wyrd
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents), [security](https://ai-powered.com/categories/security)
- **Listing updated:** 2026-11-18

## About

Wyrd is a collection of MCP servers plus a containment library. The Reader server works over a single folder you grant explicitly and applies a documented path boundary, so the assistant cannot read outside that folder. It starts only if a folder is set, either with a --grant argument or the WYRD_GRANT variable, and refuses otherwise.

Install it from npm as wyrd-mcp; for Claude Code that is a one-line claude mcp add using npx. An optional search backend can replace the built-in search, but the registry entry warns that this module runs inside the server process and is not confined to the granted folder, so leave it unset unless you trust it.

The repository scaffold is MIT, each package carries its own licence file, and each package README documents its security boundary and known limits.

## Features

- **Single granted folder:** Operates over one folder you name.
- **Read-only access:** Files can be read but not changed.
- **Path containment:** A documented boundary keeps paths inside the grant.
- **Refuses without a grant:** The server will not start unless a folder is set.
- **Pluggable search:** An optional module can replace the built-in search, at your trust.

## Good for

- Let an assistant read project notes without exposing the rest of the disk
- Search a documentation folder
- Give an AI client read access to an archive
- Keep file access narrow when testing a new client

## Install

### Claude Code (Terminal)

```sh
claude mcp add wyrd -- npx -y wyrd-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "wyrd": {
      "command": "npx",
      "args": [
        "-y",
        "wyrd-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "wyrd": {
      "command": "npx",
      "args": [
        "-y",
        "wyrd-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "wyrd": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "wyrd-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "wyrd": {
      "command": "npx",
      "args": [
        "-y",
        "wyrd-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "wyrd": {
      "command": "npx",
      "args": [
        "-y",
        "wyrd-mcp"
      ]
    }
  }
}
```

## FAQ

### How do I grant a folder?

Pass --grant with the folder path or set WYRD_GRANT; the server refuses to start with neither.

### Can it write files?

No, it is read-only.

### Is the custom search backend safe?

The README warns it runs in the server process and is not confined to the folder, so only use trusted modules.

### How do I install it?

From npm as wyrd-mcp, for example through npx.

### Is Wyrd free?

Yes. Wyrd is open source, so you can use and self-host it for free.

### How do I add Wyrd to Claude Code?

Run this command in your terminal: claude mcp add wyrd -- npx -y wyrd-mcp

### What are the best alternatives to Wyrd?

The closest alternatives to Wyrd are REA, AiSOC, redamon, x64dbg-mcp-server and Agent Roast.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [AiSOC](https://ai-powered.com/mcp/aisoc): AiSOC is an open-source MCP server for ai models and llm tooling.
- [redamon](https://ai-powered.com/mcp/redamon): redamon is an open-source MCP server for ai models and llm tooling.
- [x64dbg-mcp-server](https://ai-powered.com/mcp/x64dbg-mcp-server): x64dbg-mcp-server is an open-source MCP server for ai models and llm tooling.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [SSRS2](https://ai-powered.com/mcp/ssrs2): SSRS2 is an MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/wyrd
