Menu
Use the bundled pi-mcp-adapter to connect MCP servers through .pi/mcp.json.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
ARCHIVED — project work items are tracked in GitHub Issues and GitHub Projects. Use the github-issues skill when installed, or use gh directly.
Diagnose and fix piclaw extension issues (imports, DB init errors, watcher perms), update skel, and restart safely.
Search the web via SearXNG (or DuckDuckGo fallback) and optionally fetch result pages as raw Markdown content.
Search via SearXNG (or DuckDuckGo fallback), fetch top results, and return sentence-level summaries plus optional converted page content.
Fetch a user's recent tweets (tweets, replies, retweets) using Playwright + Nitter fallbacks and produce compact JSON/Markdown summaries.
Write and review concise technical documentation using a plain-English voice guide and anti-trope filter. Use for READMEs, design notes, runbooks, API documentation, release notes, and pull-request text.
| name | mcp-adapter |
| description | Use the bundled pi-mcp-adapter to connect MCP servers through .pi/mcp.json. |
| distribution | public |
Use pi-mcp-adapter to expose MCP servers to the agent through one mcp tool plus /mcp commands.
Preferred project-local config:
/workspace/.pi/mcp.json
Starter example:
cp /workspace/.pi/mcp.json.example /workspace/.pi/mcp.json
The adapter also understands the global Pi config at:
/config/.pi/agent/mcp.json
Use the project-local file when you want MCP servers tied to the current workspace.
{
"mcpServers": {
"filesystem": {
"command": "bunx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "."],
"lifecycle": "lazy"
}
}
}
mcp({})
mcp({ search: "read file" })
mcp({ describe: "filesystem_read_file" })
mcp({ tool: "filesystem_read_file", args: "{\"path\":\"./README.md\"}" })
args must be a JSON string.
/mcp
/mcp tools
/mcp reconnect
/mcp reconnect filesystem
/mcp-auth <server>
.pi/mcp.json, restart the session or reload Pi so the adapter re-reads config.directTools only for small, high-value tool sets. Keep large MCP servers behind the mcp proxy.