mcporter

steipete/clawdis

List, configure, and call MCP servers/tools via HTTP or stdio with mcporter.

What is mcporter?

mcporter is a CLI tool for discovering, authenticating with, and invoking MCP (Model Context Protocol) servers and their tools. Use it to integrate external services and APIs into your agent workflows, with support for OAuth, configuration management, and both HTTP and stdio transports.

List available MCP servers and their tools with schema inspection
Call MCP tools using selector, function, or JSON syntax
Authenticate with OAuth and manage server credentials
Configure and persist MCP server connections
Run MCP servers over stdio or HTTP transports
Generate CLI wrappers and TypeScript client code from MCP servers

How to install mcporter

npx skills add https://github.com/steipete/clawdis --skill mcporter

Prerequisites

Node.js installed
mcporter CLI tool installed (via `npm install -g mcporter` or the provided installer)

Claude Code

Cursor

Windsurf

Cline

How to use mcporter

1.Run `mcporter list` to discover available MCP servers
2.Run `mcporter list <server> --schema` to inspect tools and their parameters
3.Authenticate with `mcporter auth <server>` if OAuth is required
4.Call a tool using `mcporter call <server.tool> key=value` with your parameters
5.Use `--output json` for machine-readable results in agent scripts
6.Optionally start `mcporter daemon` for persistent server connections

Use cases

Good for

Integrate third-party APIs (e.g., Linear, Slack) into agent workflows by calling their MCP tools
Discover available tools on an MCP server before building agent logic
Set up OAuth authentication for services requiring user credentials
Generate type-safe TypeScript clients from MCP server schemas
Run custom MCP servers over stdio for local development and testing

Who it's for

Developers building agents that need external tool integrations
Teams using MCP servers for API access and automation
Engineers setting up authentication flows for third-party services
Developers generating client code from MCP server definitions

mcporter FAQ

What transport protocols does mcporter support?

mcporter supports both HTTP and stdio transports. Use `--stdio` flag with a command to run servers over stdio, or call HTTP-based servers directly via URL.

How do I authenticate with OAuth-protected MCP servers?

Run `mcporter auth <server>` to initiate OAuth flow. Use `--reset` to clear existing credentials. Config is stored in `./config/mcporter.json` by default.

Can I use mcporter to generate code from MCP servers?

Yes. Use `mcporter generate-cli --server <name>` to create CLI wrappers or `mcporter emit-ts <server>` to generate TypeScript client code.

How do I pass complex arguments to MCP tools?

Use `--args` with a JSON payload: `mcporter call <server.tool> --args '{"limit":5}'`, or use function syntax: `mcporter call "server.tool(param: value)"`

What is the default config location?

Config defaults to `./config/mcporter.json`. Override with `--config <path>` flag on any command.

Full instructions (SKILL.md)

Source of truth, from steipete/clawdis.

name: mcporter description: "List, configure, authenticate, call, and inspect MCP servers/tools with mcporter over HTTP or stdio." homepage: http://mcporter.dev metadata: { "openclaw": { "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