mcporter

Lists, configures, authenticates, and calls MCP servers and tools from the terminal.

1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/kaminocorp/hermes-alpha-hunter --skill mcporter-kaminocorp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mcporter
Source: https://github.com/kaminocorp/hermes-alpha-hunter/tree/main/skills/mcp/mcporter
Command: npx skills add https://github.com/kaminocorp/hermes-alpha-hunter --skill mcporter-kaminocorp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Connecting to and invoking MCP (Model Context Protocol) servers normally requires writing client code or editing config files by hand. This Skill lets you discover, authenticate, and call MCP tools directly from the terminal using the mcporter CLI, including ad-hoc servers with no prior configuration. ## Core Features & Use Cases - Server Discovery & Listing: Auto-discovers MCP servers configured by other clients (Claude Desktop, Cursor) and lists tools with full schema details. - Direct Tool Invocation: Call any MCP tool with key=value, function, or JSON argument syntax over HTTP or stdio, with machine-readable JSON output. - Auth, Config & Code Generation: Handles OAuth login flows, manages server configuration, runs a persistent daemon, and generates CLI wrappers or TypeScript clients for MCP servers. - Use Case: You find a Linear MCP server on a registry and want to file an issue from your terminal. Connect ad-hoc, authenticate with OAuth, and call linear.create_issue in one command without writing any client code. ## Quick Start Ask the agent to list the available MCP servers and their tools using mcporter, then call a specific tool with the arguments you need.

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 structured, machine-readable results.

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

mcporter supports ad-hoc connections: pass --http-url with a server URL or --stdio with a launch command like npx -y @modelcontextprotocol/server-filesystem. No persistent configuration is required for one-off calls.

Does mcporter work with servers configured in Claude Desktop or Cursor?▼

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

How do I authenticate with an MCP server that requires OAuth?▼

Run mcporter auth followed by the server name or URL to start the OAuth login flow. Since it may open an interactive browser flow, run it in a PTY-enabled terminal if invoking it programmatically.

Can mcporter generate a TypeScript client for an MCP server?▼

Yes, mcporter emit-ts generates TypeScript types or a full client for a given server using --mode types or --mode client. It can also generate standalone CLI wrappers via mcporter generate-cli.

What are the prerequisites for running mcporter?▼

mcporter requires Node.js and runs via npx with no installation, or can be installed globally with npm install -g mcporter. No other runtime dependencies are needed.