mcporter

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

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill mcporter-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mcporter
Source: https://github.com/loteiron/ZeusAgent/tree/main/optional-skills/mcp/mcporter
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill mcporter-loteiron

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working with MCP (Model Context Protocol) servers normally requires a full MCP client application. This Skill lets you discover configured servers, inspect their tool schemas, authenticate via OAuth, and invoke tools directly from the terminal without writing client code. ## Core Features & Use Cases - Server Discovery and Listing: Auto-discovers MCP servers configured by other clients like Claude Desktop or Cursor, and lists tools with full schema details. - Direct Tool Invocation: Call any MCP tool using key=value, function, or JSON argument syntax, with structured JSON output for easy parsing. - Ad-hoc Connections and Auth: Connect to servers by HTTP URL or stdio command without config files, and manage OAuth logins and persistent daemon connections. - Use Case: You want to file a bug in Linear from the command line. Run mcporter to list the Linear server's tools, then call linear.create_issue with a title argument and get the result as JSON. ## Quick Start Ask the agent to list the available MCP servers on this machine and 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 to list MCP servers configured on my machine?▼

Run mcporter list to auto-discover servers configured by other MCP clients such as Claude Desktop or Cursor. Use mcporter list <server> --schema to see a specific server's tools with full schema details.

Can I use mcporter without a config file?▼

Yes, mcporter supports ad-hoc connections. Pass --http-url to reach a remote MCP server or --stdio with a command to run a local server on the fly, with no persistent configuration required.

Does mcporter support OAuth authentication for MCP servers?▼

Yes, run mcporter auth <server | url> to start an OAuth login flow, with an optional --reset flag. The browser-based flow may need an interactive terminal, so use a pty-enabled terminal command when automating.

What are the prerequisites for running mcporter?▼

mcporter requires Node.js and runs via npx with no installation needed. You can also install it globally with npm install -g mcporter for repeated use.