Pi
Pi is a minimal terminal coding agent. Version 0.99 and later can connect to remote MCP servers.
-
Add the server:
Terminal window pi mcp add hypedoc --url https://app.myhypedoc.com/mcpThis saves it to
~/.pi/agent/mcp.json. Add--localto save it to the project’s.pi/mcp.jsoninstead. -
Sign in:
Terminal window pi mcp login hypedocPi opens your browser. Sign in to Hype Doc and approve the request. Over SSH, paste the redirected URL into Pi when it asks.
-
Run
pi mcp listto confirm it connected, then startpiand 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.
Install as a package
Section titled “Install as a package”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:
pi install git:github.com/myhypedoc/pluginsThen sign in with pi mcp login hypedoc. If you also have a hypedoc entry in mcp.json, that entry wins.
How Pi uses the tools
Section titled “How Pi uses the tools”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.
Example prompts
Section titled “Example prompts”- “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.