mcporter

---

name: mcporter description: Use when you need to access MCP servers without installing them directly in Claude Code. MCPorter provides CLI access to any MCP server via npx, enabling tool discovery, direct calls, and ad-hoc connections. Use for accessing external MCP capabilities like browser automation, API integrations, or any MCP-based tooling.

<mcporter_skill> MCPorter is a CLI and runtime for Model Context Protocol (MCP) servers. It enables access to any MCP server without direct installation, auto-discovers configured servers, and provides ergonomic tool calling from the command line.

<when_to_use> Accessing MCP tools without installing them directly in Claude Code Discovering what MCP servers are available on the user's machine Calling MCP tools via CLI for automation or testing Connecting to ad-hoc MCP endpoints without configuration Inspecting available tools and their schemas from any MCP server </when_to_use>

<core_commands> npx mcporter list

<command name="List tools from a specific server">
  npx mcporter list server_name
</command>

<command name="List tools with full JSON schema">
  npx mcporter list server_name --schema
</command>

<command name="Call a tool (colon syntax)">
  npx mcporter call server_name.tool_name arg1:value1 arg2:value2
</command>

<command name="Call a tool (function syntax)">
  npx mcporter call 'server_name.tool_name(arg1: "value1", arg2: "value2")'
</command>

<command name="Ad-hoc connection to HTTP MCP server">
  npx mcporter list --http-url https://mcp-server-url --name custom_name
</command>

<command name="Ad-hoc connection to stdio MCP server">
  npx mcporter call --stdio "npx -y some-mcp-server@latest" server.tool_name
</command>

</core_commands>

<ad_hoc_mcp_access> Access any MCP server without configuration using stdio or http flags

<pattern name="Run MCP server via npx and call tool">
  npx mcporter call --stdio "npx -y mcp-server-name@latest" server.tool_name arg:value
</pattern>

<pattern name="Discover tools from npx MCP server">
  npx mcporter list --stdio "npx -y mcp-server-name@latest" --name my_server
</pattern>

<pattern name="Connect to remote HTTP MCP endpoint">
  npx mcporter call --http-url https://mcp.example.com/mcp server.tool_name
</pattern>

</ad_hoc_mcp_access>

<daemon_management> For stateful servers that need persistent connections (like Chrome DevTools) npx mcporter daemon status npx mcporter daemon start npx mcporter daemon stop </daemon_management>

<code_generation> npx mcporter generate-cli "npx -y some-mcp-server@latest"

<command name="Generate TypeScript types">
  npx mcporter emit-ts server_name --out types/server.d.ts
</command>

<command name="Generate TypeScript client wrapper">
  npx mcporter emit-ts server_name --mode client --out clients/server.ts
</command>

</code_generation>

<output_handling> Results wrap in CallResult with helper methods Plain text output Markdown formatted output Parsed JSON output Raw content array

<flags>
  <flag name="--json">Output as JSON</flag>
  <flag name="--output json">Alternative JSON output flag</flag>
</flags>

</output_handling>

<common_mcp_servers> npx mcporter call --stdio "npx -y chrome-devtools-mcp@latest" chrome-devtools.tool_name <use_case>Browser automation, screenshots, DOM inspection, console access</use_case>

<server name="firecrawl">
  <use_case>Web crawling and scraping</use_case>
</server>

<server name="linear">
  <use_case>Linear issue tracking integration</use_case>
</server>

</common_mcp_servers>

<issue name="Timeout errors">
  <solution>Set MCPORTER_CALL_TIMEOUT environment variable</solution>
  <solution>Use --timeout flag</solution>
</issue>

<issue name="Debug logging">
  npx mcporter --log-level debug call server.tool
</issue>