mcporter

List, configure, authenticate, and call MCP servers and tools from the terminal.

14|5|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill mcporter-mlt-oss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcporter
Source: https://github.com/MLT-OSS/hermes-agent-go/tree/main/skills/mcp/mcporter
Command: npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill mcporter-mlt-oss

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Interacting with Model Context Protocol servers normally requires writing client code or editing config files by hand. This Skill lets you discover, authenticate, and invoke MCP tools directly from the terminal using the mcporter CLI, including ad-hoc servers with no prior configuration. ## Core Features & Use Cases - Server Discovery and Listing: Auto-detect MCP servers configured by other clients like Claude Desktop or Cursor, and list their tools with full schema details. - Direct Tool Invocation: Call any MCP tool using key=value, function, or JSON argument syntax, over HTTP or stdio transports, with machine-readable JSON output. - Auth, Config, and Code Generation: Handle OAuth logins, manage server configs, run a persistent daemon, and generate CLI wrappers or TypeScript clients for MCP servers. - Use Case: You find a Linear MCP server on a registry and want to list open issues. Connect ad-hoc by URL, authenticate with OAuth, and call linear.list_issues with a JSON payload, all without writing any client code. ## Quick Start Use the mcporter skill to list the MCP servers configured on this machine and show the available tools for one of them.

Frequently Asked Questions about mcporter

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

FAQPage Schema
How do I call an MCP server tool from the command line?

Use mcporter call with the server and tool name, passing arguments as key=value pairs, function syntax, or a JSON payload via --args. Add --output json for machine-readable results that are easier to parse in scripts.

How do I connect to an MCP server without a config file?

mcporter supports ad-hoc connections: pass --http-url with a server URL for HTTP servers, or --stdio with a launch command for stdio servers. This works for both listing tools and making one-off calls without editing any config.

Does mcporter require installation or Node.js?

mcporter requires Node.js but no permanent installation, since it runs via npx mcporter. You can optionally install it globally with npm install -g mcporter for faster repeated use.

Can mcporter use MCP servers configured in Claude Desktop or Cursor?

Yes, mcporter auto-discovers servers already configured by other MCP clients such as Claude Desktop and Cursor on the same machine. Running mcporter list shows these servers without additional setup.

How do I handle OAuth authentication for an MCP server?

Run mcporter auth with the server name or URL to start the OAuth flow, adding --reset to clear existing credentials. Since the flow may open an interactive browser session, run it in a PTY-enabled terminal when automating.

What can mcporter generate for an MCP server?

mcporter can generate a standalone CLI wrapper with generate-cli, inspect generated CLIs with inspect-cli, and emit TypeScript types or a full client with emit-ts. This helps integrate MCP tools into scripts and applications.