Skip to content

Pi

Pi is a minimal terminal coding agent. Version 0.99 and later can connect to remote MCP servers.

  1. Add the server:

    Terminal window
    pi mcp add hypedoc --url https://app.myhypedoc.com/mcp

    This saves it to ~/.pi/agent/mcp.json. Add --local to save it to the project’s .pi/mcp.json instead.

  2. Sign in:

    Terminal window
    pi mcp login hypedoc

    Pi opens your browser. Sign in to Hype Doc and approve the request. Over SSH, paste the redirected URL into Pi when it asks.

  3. Run pi mcp list to confirm it connected, then start pi and ask: “Log a win: finished the database migration”

Inside a session, /mcp shows the connection and lets you sign in again or reconnect. Run /reload after changing mcp.json by hand.

The Hype Doc package registers the server and adds four skills (log-win, draft-review, weekly-update, and find-wins). Skip pi mcp add above and run:

Terminal window
pi install git:github.com/myhypedoc/plugins

Then sign in with pi mcp login hypedoc. If you also have a hypedoc entry in mcp.json, that entry wins.

By default Pi keeps MCP tools out of the model’s tool list and reaches them through codemode scripts and tool search. That keeps context small. If you log wins often, make the common tools direct by editing the entry in mcp.json:

{
"mcpServers": {
"hypedoc": {
"url": "https://app.myhypedoc.com/mcp",
"toolExposure": {
"log_win": "direct",
"list_wins": "direct"
}
}
}
}

If you use the community pi-mcp-adapter package, it replaces Pi’s built-in MCP support. Add the same URL to its config and sign in with /mcp-auth hypedoc.

  • “Log a win in my Work space: cleaned up the release pipeline”
  • “Show my wins from this week”
  • “Turn my wins tagged impact into resume bullets”

Next: Available Tools.