Skip to content

akarachen/agent-plugin-mcp

v1.0.0MIT

Call MCP servers from any agent through the mcporter CLI.

GitHubOpen Website

agent-plugin-mcp

An Agent Plugins v1 package that teaches any compatible agent to call MCP servers through mcporter.

mcporter carries MCP tool calls between an agent and any MCP server — stdio, Streamable HTTP, or a one-off URL, with OAuth handled. It is a CLI, so the portable way to package it is one skill rather than a server declaration. This package is exactly that: one skill.

agent-plugin-mcp/
├── plugin.json
├── skills/
│   └── calling-mcp/
│       └── SKILL.md
├── README.md
└── LICENSE

What the skill covers

calling-mcp gives the agent the three commands it needs almost every time — list servers, read a server's tool signatures, call one tool — plus the pitfalls that produce silent failures. Everything else is a mcporter <subcommand> --help away instead of being restated here.

Requirements

  • mcporter on PATH, or npx available so npx -y mcporter works. The skill starts by checking mcporter --version and gives the install lines if nothing prints:

    npm install -g mcporter                  # needs Node 24+
brew install steipete/tap/mcporter

Install

Any client that supports Agent Plugins v1 can load this directory. With Hermes Agent:

hermes plugins install AkaraChen/agent-plugin-mcp
hermes plugins enable agent-plugin-mcp

Portable packages install disabled, so enable it explicitly. Other clients point at the repository or copy the directory into their own plugin location.

Verify it works

npx -y mcporter list https://mcp.context7.com/mcp --brief
npx -y mcporter call https://mcp.context7.com/mcp.resolve-library-id \
  query="react hooks" libraryName=react --output json

The second command returns matching library IDs. Nothing to configure or authenticate.

License

MIT