π¦
Pi Mcporter
Single-tool MCPorter bridge extension for pi and Model Context Protocol (MCP) servers.
0 installs
Trust: 42 β Fair
Ai
Ask AI about Pi Mcporter
Powered by Claude Β· Grounded in docs
I know everything about Pi Mcporter. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Loading tools...
Reviews
Documentation
π§³ pi-mcporter
Use MCP tools from pi through one stable tool (mcporter), powered by MCPorter.
π§ Philosophy: CLI > MCP
- pi is fundamentally CLI-first.
- Prefer native CLIs whenever available (
gh,git,kubectl,aws, etc.). - Use MCP via
mcporterwhen it adds clear value (for example: Linear, Slack, hosted auth-heavy integrations, cross-tool workflows). - This package is intentionally a thin bridge, not a replacement for piβs normal tool-driven workflow.
β¨ Why use this package
- Keeps context small: one stable
mcportertool instead of exposing many MCP tools - Uses your MCPorter config/runtime as source of truth
- Supports discovery (
search), schema help (describe), and execution (call) - Returns useful error hints for auth/offline/http/stdio failures
π Prerequisites
You need MCPorter installed and configured with at least one MCP server:
npm install -g mcporter
npx mcporter list # verify your servers are visible
π¦ Install
Install as a pi package:
pi install npm:pi-mcporter
Try it once without installing:
pi -e npm:pi-mcporter
π Quick start
- Confirm MCPorter sees your servers:
npx mcporter list
- Start pi:
pi
- Ask for what you need β pi picks the right MCP tools automatically:
What are my open Linear issues this sprint?Catch me up on #engineering in Slack from today.Find the onboarding runbook in Notion and summarize the setup steps.
π§° Tool input (reference)
Tool name: mcporter
action:"search" | "describe" | "call"selector?:"server.tool"(required fordescribeandcall)query?: free-text query forsearchlimit?: result limit (default 20, max 100)args?: object arguments forcallargsJson?: JSON-object-string fallback forcalltimeoutMs?: per-call timeout override
βοΈ Optional flags
--mcporter-config <path>: explicit MCPorter config path (overridesMCPORTER_CONFIGenv var and default locations)--mcporter-timeout-ms <ms>: default call timeout in milliseconds (default30000)
πͺ Output behavior
Tool output follows pi's native expand/collapse behavior:
- Collapsed view shows a compact summary
- Expanded view shows the full rendered output
- Use pi's
expandToolskeybinding (defaultCtrl+O) to toggle expansion
π§― Troubleshooting
- Unknown server/tool: run
npx mcporter listandnpx mcporter list <server>to verify names. - Auth issues: run
npx mcporter auth <server>. - Slow calls: increase
timeoutMsor--mcporter-timeout-ms. - Config not found: set
--mcporter-config <path>or exportMCPORTER_CONFIG=<path>. - Truncated output: the response includes a temp file path with full output.
