MCPorter - Generic MCP Access

Use mcporter to work with MCP servers directly. MCPorter auto-discovers MCP configurations from OpenCode, Cursor, Claude, and other supported tools.

Quick Reference

Action	Command	Description
discover	./scripts/mcporter.sh discover	List all configured MCP servers
list	./scripts/mcporter.sh list <server>	List tools available on a server
call	./scripts/mcporter.sh call <server>.<tool> [args...]	Call an MCP tool
help	./scripts/mcporter.sh help	Show usage help

How to Use

Natural Language

• "What MCP servers are available?"
• "List tools on the firecrawl server"
• "Call the scrape tool on firecrawl with url=https://example.com"

Script Commands

# Discover available MCPs
./scripts/mcporter.sh discover

# List tools on a specific server
./scripts/mcporter.sh list context7
./scripts/mcporter.sh list firecrawl

# Call a tool with arguments (key=value format)
./scripts/mcporter.sh call firecrawl.scrape url=https://example.com
./scripts/mcporter.sh call chrome-devtools.screenshot url=https://example.com

Direct mcporter CLI (advanced)

When the wrapper script is insufficient, use mcporter directly:

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

# Full URL for ad-hoc servers
mcporter call https://api.example.com/mcp.fetch url=https://example.com

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

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

# Machine-readable output
mcporter call <server.tool> --output json key=value

Auth & Config

# OAuth authentication
mcporter auth <server | url> [--reset]

# Config management
mcporter config list|get|add|remove|import|login|logout

Codegen

# Generate CLI from MCP server
mcporter generate-cli --server <name>
mcporter generate-cli --command <url>

# Inspect generated CLI
mcporter inspect-cli <path> [--json]

# Generate TypeScript types
mcporter emit-ts <server> --mode client|types

Prerequisites

• Node.js 18+ installed
• Option A: Install MCPorter via Homebrew: brew tap steipete/tap && brew install mcporter
• Option B: Use via npx (no install required): npx mcporter
• MCP servers configured in OpenCode, Cursor, Claude, or other supported tools

Notes

• For library documentation, prefer the context7-docs skill instead
• MCPorter auto-discovers MCP configurations from multiple sources
• Use discover first to see what servers are available
• Tool arguments use key=value format
• Prefer --output json for machine-readable results
• Config default: ./config/mcporter.json (override with --config)