{“content”:”---\nname: mcporter\ndescription: Use the mcporter CLI to list, configure, auth, and call MCP servers/tools directly (HTTP or stdio), including ad-hoc servers, config edits, and CLI/type generation.\nversion: 1.0.0\nauthor: community\nlicense: MIT\nmetadata:\n hermes:\n tags: [MCP, Tools, API, Integrations, Interop]\n homepage: https://mcporter.dev\nprerequisites:\n commands: [npx]\n---\n\n# mcporter\n\nUse mcporter to discover, call, and manage MCP (Model Context Protocol) servers and tools directly from the terminal.\n\n## Prerequisites\n\nRequires Node.js:\nbash\n# No install needed (runs via npx)\nnpx mcporter list\n\n# Or install globally\nnpm install -g mcporter\n\n\n## Quick Start\n\nbash\n# List MCP servers already configured on this machine\nmcporter list\n\n# List tools for a specific server with schema details\nmcporter list <server> --schema\n\n# Call a tool\nmcporter call <server.tool> key=value\n\n\n## Discovering MCP Servers\n\nmcporter auto-discovers servers configured by other MCP clients (Claude Desktop, Cursor, etc.) on the machine. To find new servers to use, browse registries like mcpfinder.dev or mcp.so, then connect ad-hoc:\n\nbash\n# Connect to any MCP server by URL (no config needed)\nmcporter list --http-url https://some-mcp-server.com --name my_server\n\n# Or run a stdio server on the fly\nmcporter list --stdio \"npx -y @modelcontextprotocol/server-filesystem\" --name fs\n\n\n## Calling Tools\n\nbash\n# Key=value syntax\nmcporter call linear.list_issues team=ENG limit:5\n\n# Function syntax\nmcporter call \"linear.create_issue(title: \\\"Bug fix needed\\\")\"\n\n# Ad-hoc HTTP server (no config needed)\nmcporter call https://api.example.com/mcp.fetch url=https://example.com\n\n# Ad-hoc stdio server\nmcporter call --stdio \"bun run ./server.ts\" scrape url=https://example.com\n\n# JSON payload\nmcporter call <server.tool> --args '{\"limit\": 5}'\n\n# Machine-readable output (recommended for Hermes)\nmcporter call <server.tool> key=value --output json\n\n\n## Auth and Config\n\nbash\n# OAuth login for a server\nmcporter auth <server | url> [--reset]\n\n# Manage config\nmcporter config list\nmcporter config get <key>\nmcporter config add <server>\nmcporter config remove <server>\nmcporter config import <path>\n\n\nConfig file location: ./config/mcporter.json (override with --config).\n\n## Daemon\n\nFor persistent server connections:\nbash\nmcporter daemon start\nmcporter daemon status\nmcporter daemon stop\nmcporter daemon restart\n\n\n## Code Generation\n\nbash\n# Generate a CLI wrapper for an MCP server\nmcporter generate-cli --server <name>\nmcporter generate-cli --command <url>\n\n# Inspect a generated CLI\nmcporter inspect-cli <path> [--json]\n\n# Generate TypeScript types/client\nmcporter emit-ts <server> --mode client\nmcporter emit-ts <server> --mode types\n\n\n## Notes\n\n- Use --output json for structured output that’s easier to parse\n- Ad-hoc servers (HTTP URL or --stdio command) work without any config — useful for one-off calls\n- OAuth auth may require interactive browser flow — use terminal(command=\"mcporter auth <server>\", pty=true) if needed\n”}