mcporter

Discover, configure, authenticate, and call MCP servers from the terminal.

Updated May 26, 2026
One-click install
npx skills add https://github.com/ruiyangruiyi/hermes-agent --skill mcporter-ruiyangruiyi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcporter
Source: https://github.com/ruiyangruiyi/hermes-agent/tree/main/optional-skills/mcp/mcporter
Command: npx skills add https://github.com/ruiyangruiyi/hermes-agent --skill mcporter-ruiyangruiyi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

mcporter removes the friction of finding and using Model Context Protocol (MCP) servers and tools by letting you list, configure, authenticate, and call them directly from your terminal.

Core Features & Use Cases

  • Discover MCP servers and tools: Auto-discovers servers configured by other MCP clients on your machine and can connect to ad-hoc servers by HTTP URL or stdio command.
  • Call tools with multiple input styles: Supports key=value calls, function-style calls, JSON payloads, and recommended JSON output for easier parsing by Hermes.
  • Manage auth, config, and daemonized connections: Provides OAuth login flows, config management (including import/export), and a daemon mode for persistent server connections.

Use case example: You want to fetch and transform data from an MCP tool without manually wiring up server endpoints; you can list available tools, authenticate if needed, then call a tool with structured parameters and machine-readable output.

Quick Start

Use mcporter to call a specific MCP tool by giving a server and tool name with key=value parameters and requesting JSON output.

Frequently Asked Questions about mcporter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I call MCP tools directly from the CLI?

You can call MCP tools from the CLI by invoking mcporter with a specific server and tool name, providing parameters in key=value or JSON format, and requesting JSON output for structured parsing.

What is the Model Context Protocol and when do I need it?

Model Context Protocol (MCP) is a standard for discovering and invoking external tools. You need it when accessing ad-hoc HTTP or stdio server connections and setting up OAuth authentication.

Can I manage OAuth login flows and server configurations for MCP connections?

Yes, you can manage MCP server configurations and OAuth login flows from the terminal. The tool also supports importing/exporting configurations and running daemonized persistent server sessions.

Does mcporter work with ad-hoc HTTP and stdio MCP servers?

Yes, mcporter connects to ad-hoc MCP servers via HTTP URL or stdio command. It also auto-discovers servers already configured by other MCP clients on your machine.

What is the best way to generate code from discovered MCP servers?

The best way to generate code from discovered MCP servers is using the CLI's built-in code and type generation features after listing available tools, ensuring structured integration.