---
name: dicklesworthstone/mcporter
source: https://app.decimal.ai/s/dicklesworthstone-mcporter@1/SKILL.md
source_sha256: d22b1a2cb12b
---

# 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.