mcporter git:20260205.788be98A

Immutable. This exact content is served forever at /api/v1/blob/20eee0e8f6fca565.

---
name: mcporter
description: Interact with MCP (Model Context Protocol) servers using the mcporter CLI. Use this skill when you need to list available MCP servers, view tool schemas, call MCP tools, manage OAuth authentication, or generate CLI wrappers and TypeScript types for MCP servers.
compatibility: Requires mcporter binary (install via npm install -g mcporter)
metadata:
  homepage: https://mcporter.dev
  author: mcporter
---

# 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
```bash
mcporter call linear.list_issues team=ENG limit:5
```

### Function syntax
```bash
mcporter call "linear.create_issue(title: \"Bug\")"
```

### Full URL
```bash
mcporter call https://api.example.com/mcp.fetch url:https://example.com
```

### Stdio mode (ad-hoc servers)
```bash
mcporter call --stdio "bun run ./server.ts" scrape url=https://example.com
```

### JSON payload
```bash
mcporter call <server.tool> --args '{"limit":5}'
```

## Authentication and Configuration

### OAuth authentication
```bash
mcporter auth <server | url>        # Authenticate with a server
mcporter auth <server> --reset      # Reset authentication
```

### Configuration management
```bash
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

```bash
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
```bash
mcporter generate-cli --server <name>
mcporter generate-cli --command <url>
```

### Inspect generated CLI
```bash
mcporter inspect-cli <path>
mcporter inspect-cli <path> --json  # JSON output
```

### Generate TypeScript types
```bash
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.