CLI Reference

Complete command-line reference for Selqor MCP Forge. Learn all commands, options, and examples for analyzing specs, generating servers, and managing deployments.

Commands in this guide:
  • dashboard — Launch the local interface
  • generate — Create an MCP server
  • analyze — Analyze a spec without generating
  • benchmark — Compare multiple specs
  • scan — Security scanning

Install from Package Managers

Selqor MCP Forge is available on major package registries. Choose your preferred installation source:

NPM REGISTRY

Install via npm

Get selqor-mcp-forge from npm - the official Node.js package repository

View on npm →
PYPI REGISTRY

Install via pip

Get selqor-mcp-forge from PyPI - the official Python package repository

View on PyPI →

dashboard

Launch the local web interface for managing integrations, reviewing tool plans, and preparing deployments. All data is local to your machine.

selqor-mcp-forge dashboard [options]

Usage

$ selqor-mcp-forge dashboard
# Opens http://127.0.0.1:8787 in your browser

Options

Option Default Description
--port PORT 8787 Server port number
--host HOST 127.0.0.1 Server host/IP address
--open false Auto-open browser on startup
--no-browser false Skip browser launch
--env ENV development Environment (development, production)

Examples

# Basic startup
$ selqor-mcp-forge dashboard

# Use different port (avoid conflicts)
$ selqor-mcp-forge dashboard --port 9000

# Production mode with custom host
$ selqor-mcp-forge dashboard --host 0.0.0.0 --env production
Operations Integration Mgmt

generate

Generate a production-ready MCP server from an OpenAPI or Swagger spec. Outputs TypeScript or Rust code with chosen transport mechanism.

selqor-mcp-forge generate [options]

Usage

$ selqor-mcp-forge generate --spec ./openapi.json --lang typescript

Options

Option Values Description
--spec PATH_OR_URL
required 		File or URL OpenAPI spec location
--lang LANG typescript, rust Target programming language
--transport MODE stdio, http, sse Communication transport
--output DIR ./generated Output directory path
--auth TYPE oauth, api-key, bearer Authentication method
--config FILE Path Configuration file (JSON)
--force boolean Overwrite existing output

Examples

# Generate TypeScript server with stdio transport
$ selqor-mcp-forge generate \
  --spec https://api.github.com/.../openapi.json \
  --lang typescript \
  --transport stdio

# Generate Rust server with HTTP
$ selqor-mcp-forge generate \
  --spec ./stripe-openapi.json \
  --lang rust \
  --transport http \
  --auth api-key
Code Generation Deployment

analyze

Analyze an OpenAPI spec to see how it would be curated into MCP tools. View tool groupings, coverage metrics, and quality scores without generating code.

selqor-mcp-forge analyze [options]

Usage

$ selqor-mcp-forge analyze --spec ./openapi.json

Options

Option Values Description
--spec PATH_OR_URL
required 		File or URL OpenAPI spec to analyze
--output-format FORMAT json, text, html Result format
--save-plan FILE Path Save curation plan to file
--verbose boolean Detailed analysis output

Examples

# Basic analysis with text output
$ selqor-mcp-forge analyze --spec ./github-openapi.json

# Save detailed plan as JSON
$ selqor-mcp-forge analyze \
  --spec https://api.github.com/openapi.json \
  --output-format json \
  --save-plan ./plan.json
API Analysis Tool Planning

benchmark

Compare compression and quality metrics across multiple OpenAPI specs. Identify which APIs compress best and benchmark tool plan efficiency.

selqor-mcp-forge benchmark [options]

Usage

$ selqor-mcp-forge benchmark --specs ./specs/*.json

Options

Option Values Description
--specs GLOB
required 		File pattern Spec files to benchmark (glob pattern)
--compare boolean Show side-by-side comparison
--metrics METRICS csv list Metrics to include (endpoints, tools, ratio, coverage)
--output FILE Path Save results to file (JSON/CSV)

Examples

# Compare all specs in directory
$ selqor-mcp-forge benchmark --specs ./specs/*.json --compare

# Benchmark specific metrics and save results
$ selqor-mcp-forge benchmark \
  --specs ./github.json ./stripe.json ./slack.json \
  --metrics endpoints,tools,compression-ratio \
  --output ./benchmark-results.json
API Comparison Performance Metrics

scan

Security scan for OWASP Agentic Top 10 vulnerabilities, CVEs, and misconfigurations. Generate compliance reports before deployment.

selqor-mcp-forge scan [options]

Usage

$ selqor-mcp-forge scan --spec ./openapi.json

Options

Option Values Description
--spec PATH_OR_URL
required 		File or URL OpenAPI spec or MCP server URL
--report FORMAT json, pdf, html, text Report output format
--severity LEVEL critical, high, medium, low Minimum severity to report
--output FILE Path Save report to file
--fail-on-critical boolean Exit with error if critical found

Examples

# Scan OpenAPI spec and show results
$ selqor-mcp-forge scan --spec ./openapi.json

# Generate PDF report and fail on critical issues
$ selqor-mcp-forge scan \
  --spec ./openapi.json \
  --report pdf \
  --output ./security-report.pdf \
  --fail-on-critical
Security Compliance

Common Patterns

Using with environment variables

$ export API_KEY="your-secret"
$ selqor-mcp-forge generate \
  --spec ./openapi.json \
  --auth api-key

Piping output to files

$ selqor-mcp-forge analyze --spec ./openapi.json --output-format json > analysis.json

Running in CI/CD

# In GitHub Actions, GitLab CI, etc.
$ selqor-mcp-forge scan --spec ./openapi.json --report pdf --output ./report.pdf --fail-on-critical

Next Steps

Installation Guide

Get set up with npm, pip, or source installation.

Learn more →

Common Workflows

5 practical examples using these commands.

See workflows →

Product Overview

Learn about features and capabilities.

Explore →