mcporter

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

Quick Start

1. List available servers: mcporter list
2. View tools for a server: mcporter list <server> --schema
3. 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.