mcpField
M
mcporter

mcporter

github.com/buildrtechAgent workflows54 installs
Repository

About mcporter

mcporter is a CLI for interacting with MCP servers over HTTP or stdio. It lets developers inspect server tools, call them, manage configuration and authentication, and generate CLI wrappers or TypeScript output.

Key features

  1. 01List servers and inspect tool schemas
  2. 02Call tools over HTTP or stdio
  3. 03Manage server configuration and OAuth
  4. 04Start and control the daemon
  5. 05Generate CLI wrappers and TypeScript

Use cases

  1. 01Inspect tools available from configured servers
  2. 02Invoke MCP tools from the command line
  3. 03Add or import server configuration
  4. 04Generate typed client code

MCP support

mcporter connects to MCP servers over HTTP or stdio, lists their tools and schemas, and invokes tools. It also manages server configuration and authentication.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/buildrtech/dotagents --skill mcporter

After installing, type/mcporterin Claude Code to confirm it loaded.

Details

From the project README

mcporter

Use the mcporter CLI to interact with MCP servers directly via HTTP or stdio.

Quick Start

  1. List available servers: mcporter list
  2. View tools for a server: mcporter list <server> --schema
  3. Call a tool: mcporter call <server.tool> key=value

Calling Tools

Multiple syntaxes are supported for calling MCP tools:

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

Authentication and Configuration

OAuth authentication
mcporter auth <server | url>        # Authenticate with a server
mcporter auth <server> --reset      # Reset authentication
Configuration management
mcporter config list                # List all configured servers
mcporter config get <key>           # Get a config value
mcporter config add <server>        # Add a server
mcporter config remove <server>     # Remove a server
mcporter config import <file>       # Import configuration
mcporter config login               # Login to mcporter cloud
mcporter config logout              # Logout from mcporter cloud

Daemon Management

mcporter daemon start               # Start the daemon
mcporter daemon status              # Check daemon status
mcporter daemon stop                # Stop the daemon
mcporter daemon restart             # Restart the daemon

Code Generation

Generate CLI wrapper
mcporter generate-cli --server <name>
mcporter generate-cli --command <url>
Inspect generated CLI
mcporter inspect-cli <path>
mcporter inspect-cli <path> --json  # JSON output
Generate TypeScript types
mcporter emit-ts <server> --mode client   # Generate client code
mcporter emit-ts <server> --mode types    # Generate type definitions

Tips

  • Configuration file defaults to ./config/mcporter.json. Override with --config <path>.
  • Use --output json for machine-readable output when parsing results programmatically.
  • When calling tools, both key=value and key:value syntaxes work for arguments.

Comments

Markdown supported