mcporter

name: mcporter description: Interact with MCP (Model Context Protocol) servers using the mcporter CLI. Use this skill when you need to list available MCP servers, view tool schemas, call MCP tools, manage OAuth authentication, or generate CLI wrappers and TypeScript types for MCP servers. compatibility: Requires mcporter binary (install via npm install -g mcporter) metadata: homepage: https://mcporter.dev author: mcporter

Use the mcporter CLI to interact with MCP servers directly via HTTP or stdio.

Quick Start

List available servers: mcporter list
View tools for a server: mcporter list <server> --schema
Call a tool: mcporter call <server.tool> key=value

Calling Tools

Multiple syntaxes are supported for calling MCP tools:

Selector syntax

mcporter call linear.list_issues team=ENG limit:5

Function syntax

mcporter call "linear.create_issue(title: \"Bug\")"

Full URL

mcporter call https://api.example.com/mcp.fetch url:https://example.com

Stdio mode (ad-hoc servers)

mcporter call --stdio "bun run ./server.ts" scrape url=https://example.com

JSON payload

mcporter call <server.tool> --args '{"limit":5}'

Authentication and Configuration

OAuth authentication

mcporter auth <server | url>        # Authenticate with a server
mcporter auth <server> --reset      # Reset authentication

Configuration management

mcporter config list                # List all configured servers
mcporter config get <key>           # Get a config value
mcporter config add <server>        # Add a server
mcporter config remove <server>     # Remove a server
mcporter config import <file>       # Import configuration
mcporter config login               # Login to mcporter cloud
mcporter config logout              # Logout from mcporter cloud

Daemon Management

mcporter daemon start               # Start the daemon
mcporter daemon status              # Check daemon status
mcporter daemon stop                # Stop the daemon
mcporter daemon restart             # Restart the daemon

Code Generation

Generate CLI wrapper

mcporter generate-cli --server <name>
mcporter generate-cli --command <url>

Inspect generated CLI

mcporter inspect-cli <path>
mcporter inspect-cli <path> --json  # JSON output

Generate TypeScript types

mcporter emit-ts <server> --mode client   # Generate client code
mcporter emit-ts <server> --mode types    # Generate type definitions

Tips

Configuration file defaults to ./config/mcporter.json. Override with --config <path>.
Use --output json for machine-readable output when parsing results programmatically.
When calling tools, both key=value and key:value syntaxes work for arguments.