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
bashmcporter call linear.list_issues team=ENG limit:5
Function syntax
bashmcporter call "linear.create_issue(title: \"Bug\")"
Full URL
bashmcporter call https://api.example.com/mcp.fetch url:https://example.com
Stdio mode (ad-hoc servers)
bashmcporter call --stdio "bun run ./server.ts" scrape url=https://example.com
JSON payload
bashmcporter call <server.tool> --args '{"limit":5}'
Authentication and Configuration
OAuth authentication
bashmcporter auth <server | url> # Authenticate with a server mcporter auth <server> --reset # Reset authentication
Configuration management
bashmcporter 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
bashmcporter 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
bashmcporter generate-cli --server <name> mcporter generate-cli --command <url>
Inspect generated CLI
bashmcporter inspect-cli <path> mcporter inspect-cli <path> --json # JSON output
Generate TypeScript types
bashmcporter 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 jsonfor machine-readable output when parsing results programmatically. - When calling tools, both
key=valueandkey:valuesyntaxes work for arguments.

