Wyrd
Serves one granted folder to any AI client, read-only, behind a path-containment fence
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.4.0
- Listing updated
- today
Similar MCP servers
About Wyrd
Wyrd is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add wyrd -- npx -y wyrd-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"wyrd": {
"command": "npx",
"args": [
"-y",
"wyrd-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"wyrd": {
"command": "npx",
"args": [
"-y",
"wyrd-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"wyrd": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"wyrd-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"wyrd": {
"command": "npx",
"args": [
"-y",
"wyrd-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"wyrd": {
"command": "npx",
"args": [
"-y",
"wyrd-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
WYRD_GRANTAbsolute path to the single folder to serve, read-only. Used when --grant is not passed. The server refuses to start if neither is set.WYRD_SEARCH_BACKENDOptional. Absolute path to one module file that answers search instead of the built-in search. Used when --search-backend is not passed. The module runs inside the server process and is not confined to the granted folder; leave unset unless you trust it.
What it does
- 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
Pricing
Open source
Wyrd 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.



