Skills
.Work. You
Rest

pi-mcp-adapter

Official

Connect MCP servers to Pi without token bloat.

Software Engineering#oauth#mcp#lazy loading#tool discovery#token optimization#proxy#pi coding agent
AuthorAradotso
Version1.0.0
Installs0

System Documentation

What problem does it solve?

pi-mcp-adapter solves the context-window bloat problem caused by exposing hundreds or thousands of MCP tool definitions to an LLM-backed coding agent, slowing decisions and wasting tokens.

Core Features & Use Cases

  • Token-efficient MCP proxy: exposes a single compact proxy tool that discovers MCP capabilities on-demand instead of loading everything at once
  • Lazy loading lifecycle: connects only when tools are actually called, disconnecting after idle time to reduce overhead
  • Direct tool registration options: registers a selected subset of high-priority tools for stronger LLM visibility while keeping the rest proxy-based
  • Standard MCP config support: reads .mcp.json plus ~/.config/mcp/mcp.json and Pi project overrides to minimize manual wiring
  • Interactive Pi configuration: configure and troubleshoot via the /mcp overlay, including reconnection and OAuth triggering
  • OAuth support: supports autoAuth and interactive OAuth flows for servers that require authorization
  • Resource and UI integration: supports MCP resources and can open MCP UI payloads using the MCP UI standard

Quick Start

Add a .mcp.json in your project root with the servers you want, then restart Pi and call the proxy tool mcp to lazily discover and use tools from those servers.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: pi-mcp-adapter
Download link: https://github.com/Aradotso/mcp-skills/archive/main.zip#pi-mcp-adapter

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.