mcporter

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Interacting with MCP (Model Context Protocol) servers normally requires a full MCP client application. This Skill lets you discover, configure, authenticate, and invoke MCP servers and tools directly from the terminal, including ad-hoc servers with no prior configuration. ## Core Features & Use Cases - Server Discovery & Listing: Auto-detect MCP servers configured by other clients (Claude Desktop, Cursor) and list their tools with full schema details. - Direct Tool Calls: Invoke any MCP tool via key=value, function syntax, or JSON payloads, against configured servers or ad-hoc HTTP/stdio endpoints. - Auth, Config & 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 the list_issues tool with JSON output for scripting. ## Quick Start Use mcporter to list the MCP servers configured on this machine and then call a tool from one of them with 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 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 suitable for scripting.

How to connect to an MCP server without configuration?

mcporter supports ad-hoc connections: pass --http-url with a server URL for HTTP servers, or --stdio with a launch command for stdio servers. No config file entry is needed for one-off calls.

Does mcporter require installation or Node.js?

mcporter requires Node.js but no installation is necessary since it runs via npx mcporter. You can optionally install it globally with npm install -g mcporter for 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. Running mcporter list shows these servers, and you can call their tools immediately.

Why does mcporter auth fail or hang during OAuth login?

OAuth authentication requires an interactive browser flow, which can stall in non-interactive terminals. Run it with a pseudo-terminal, for example terminal(command="mcporter auth <server>", pty=true), to complete the flow.