pmcp

Use the skills your packages already ship, and keep your AI tools' project configuration in one place.

pmcp is for repositories where people work with AI coding tools such as Claude Code, Codex, Gemini CLI, Grok Build, Antigravity and opencode. It finds the SKILL.md instructions your installed packages and marketplaces carry and lets the tool load one when a task needs it, and it writes each tool's native configuration from one pmcp.toml. The tools keep their own model calls, logins and permission controls.

Install and connect

Requires Node.js 22 or later, or Bun 1.3 or later.

npm install --save-dev @modootoday/pmcp
claude mcp add pmcp -- npx @modootoday/pmcp serve

Other MCP hosts take a stdio entry:

{
  "mcpServers": {
    "pmcp": { "command": "npx", "args": ["@modootoday/pmcp", "serve"] }
  }
}

Reconnect your tool's MCP servers after changing the configuration. Reading local skills needs no pmcp account.

Related MCP server: skillmds

Find your first skill

pmcp list shows what the server sees from here: one row per skill, with the name and the description the search ranks.

npx @modootoday/pmcp list

Then ask your tool for help with a task in a full sentence. It calls skill_find, which returns matching skill names without their bodies, and skill_call for the one it picks. An empty catalog exits 1 and names the directories it searched. Getting started walks through the search and the options.

Free library skills as native plugins

This repository is also a plugin marketplace. Install the library major lines you use, one at a time:

claude plugin marketplace add modootoday/pmcp
claude plugin install typescript-5@pmcp
claude plugin install pmcp@pmcp

Codex (codex plugin add) and Grok (grok plugin install) take the same names; Gemini installs the pmcp bridge with gemini extensions install https://github.com/modootoday/pmcp, and pmcp marketplace export writes a plugin for Antigravity. The skills reference covers formats and versions; the library skills page also covers Python, Rust and Go.

Share configuration across your tools

[targets]
tools = ["claude", "codex", "gemini", "grok", "antigravity", "opencode"]

[mcp.docs]
url = "https://example.com/mcp"

npx @modootoday/pmcp init        # or write pmcp.toml yourself
npx @modootoday/pmcp project     # write each tool's native files
npx @modootoday/pmcp doctor      # ask each tool what it loads

project preserves settings it did not write, refuses conflicting ones and records what it owns in pmcp.lock; --check reports drift without writing. The pmcp.toml reference covers every table.

Guard commands and run several agents

[hooks] compiles guards (heredocs, git add -A, pushes that skip checks, credential reads and more) into one hook bundle every targeted tool runs. With sessions and the git workflow on, agents see each other, wait on shared files, work in linked worktrees and deliver through one gate instead of pushing. Run several agents in one repository shows how.

Watch and steer agent terminals

On Linux or macOS, pmcp opens a terminal workspace: a native main session, a dock of workers and a coordination panel, read only until you take control. npm installs the terminal host (pmcp-pty) and the workspace (pmcp-tui) with pmcp. Login, folder trust and tool approvals stay in each tool. See the terminal workspace and native terminal control guides.

Commands

pmcp list            # skills the server sees
pmcp available       # catalog skill packages that match your dependencies
pmcp install --all --dry-run
pmcp validate        # check skill documents
pmcp status          # features, drift, live sessions
pmcp --help

The command reference lists every command, flag and exit code.

Documentation

Licence

pmcp is source available under Elastic License 2.0. See NOTICE for dependency notices and the embedding guide for model licences. Website: pmcp.build.