name: mcporter

description: 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.

version: 1.0.0

author: community

license: MIT

metadata:

hermes:

tags: [MCP, Tools, API, Integrations, Interop]

homepage: https://mcporter.dev

prerequisites:

commands: [npx]

mcporter

Use mcporter to discover, call, and manage MCP (Model Context Protocol) servers and tools directly from the terminal.

Prerequisites

Requires Node.js:

`bash

No install needed (runs via npx)

npx mcporter list

Or install globally

npm install -g mcporter

`

Quick Start

`bash

List MCP servers already configured on this machine

mcporter list

List tools for a specific server with schema details

mcporter list --schema

Call a tool

mcporter call key=value

`

Discovering MCP Servers

mcporter 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:

`bash

Connect to any MCP server by URL (no config needed)

mcporter list --http-url https://some-mcp-server.com --name my_server

Or run a stdio server on the fly

mcporter list --stdio "npx -y @modelcontextprotocol/server-filesystem" --name fs

`

Calling Tools

`bash

Key=value syntax

mcporter call linear.list_issues team=ENG limit:5

Function syntax

mcporter call "linear.create_issue(title: \"Bug fix needed\")"

Ad-hoc HTTP server (no config needed)

mcporter call https://api.example.com/mcp.fetch url=https://example.com

Ad-hoc stdio server

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

JSON payload

mcporter call --args '{"limit": 5}'

Machine-readable output (recommended for Hermes)

mcporter call key=value --output json

`

Auth and Config

`bash

OAuth login for a server

mcporter auth [--reset]

Manage config

mcporter config list

mcporter config get

mcporter config add

mcporter config remove

mcporter config import

`

Config file location: ./config/mcporter.json (override with --config).

Daemon

For persistent server connections:

`bash

mcporter daemon start

mcporter daemon status

mcporter daemon stop

mcporter daemon restart

`

Code Generation

`bash

Generate a CLI wrapper for an MCP server

mcporter generate-cli --server

mcporter generate-cli --command

Inspect a generated CLI

mcporter inspect-cli [--json]

Generate TypeScript types/client

mcporter emit-ts --mode client

mcporter emit-ts --mode types

`

Notes

• - Use --output json for structured output that's easier to parse
• - Ad-hoc servers (HTTP URL or --stdio command) work without any config — useful for one-off calls
• - OAuth auth may require interactive browser flow — use terminal(command="mcporter auth ", pty=true) if needed