mcporter

Manage and call MCP servers (list, call, auth, daemon).

⭐430stars🔀44forks📁View on GitHub🕐Updated Dec 21, 2025⬇️2downloads

When & Why to Use This Skill

mcporter is a comprehensive CLI utility designed to simplify the management, testing, and integration of Model Context Protocol (MCP) servers. It allows developers to interact with MCP tools directly via HTTP or stdio, manage authentication, and generate code, serving as an essential bridge for building and debugging AI agent infrastructures.

Use Cases

  • MCP Server Debugging: Use the CLI to list available tools and call them with specific arguments to verify server logic without writing boilerplate code.
  • Automated Workflows: Integrate MCP tool calls into shell scripts or CI/CD pipelines using the daemon mode and JSON output for machine-readable automation.
  • Type-Safe Development: Generate TypeScript types and custom CLI wrappers for existing MCP servers to accelerate the development of agentic applications.
  • Centralized Auth Management: Handle complex OAuth flows and configuration edits for multiple MCP servers through a unified command-line interface.
namemcporter
descriptionUse 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.
homepagehttp://mcporter.dev
metadata{"clawdbot":{"emoji":"📦","requires":{"bins":["mcporter"]},"install":[{"id":"node","kind":"node","package":"mcporter","bins":["mcporter"],"label":"Install mcporter (node)"}]}}

mcporter

Use mcporter to work with MCP servers directly.

Quick start

  • mcporter list
  • mcporter list <server> --schema
  • mcporter call <server.tool> key=value

Call tools

  • Selector: 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: mcporter call --stdio "bun run ./server.ts" scrape url=https://example.com
  • JSON payload: mcporter call <server.tool> --args '{"limit":5}'

Auth + config

  • OAuth: mcporter auth <server | url> [--reset]
  • Config: mcporter config list|get|add|remove|import|login|logout

Daemon

  • mcporter daemon start|status|stop|restart

Codegen

  • CLI: mcporter generate-cli --server <name> or --command <url>
  • Inspect: mcporter inspect-cli <path> [--json]
  • TS: mcporter emit-ts <server> --mode client|types

Notes

  • Config default: ./config/mcporter.json (override with --config).
  • Prefer --output json for machine-readable results.