The command-line control plane for PlatPhormNews.
platphormctl discovers, inspects, tests, validates, traces, and orchestrates every service across the PlatPhormNews ecosystem — from your terminal.
Discover first. Validate second. Exercise third. Trace everything. Report honestly.
Also available as: phormctl · pctl
Everything the network needs.
One CLI. Every capability. Built for humans, agents, CI/CD, and LLM workflows.
Network discovery
Fetch the live network graph, discover all PlatPhormNews sites, inspect health and status across the entire ecosystem.
platphormctl network discoverSite inspection
Inspect OpenAPI specs, MCP manifests, llms.txt, sitemap, RSS, robots.txt, and agent policies for any site.
platphormctl site inspect <site>MCP tool calls
Initialize MCP servers, list tools, call public-safe operations, validate inputs/outputs, emit W3C traces.
platphormctl mcp call <site> <tool>Policy evaluation
Fetch .well-known agent and AI policy files. Evaluate allow/deny decisions for any user-agent, path, and method.
platphormctl policy evaluate <site>API diffing
List OpenAPI operations, call endpoints, validate responses against schemas, and diff API surfaces across sites.
platphormctl api diff <siteA> <siteB>Harness workflows
Run end-to-end tool-to-tool harness scenarios: discovery-full, mcp-factory, content-pipeline, and more.
platphormctl harness run discovery-fullLLM-assisted ops
Ask questions with network or report context. Summarize, repair manifests, or draft harness workflows — provider-neutral.
platphormctl llm ask --context networkReports & observability
Generate Markdown, JSON, and HTML reports. Structured logs with request_id, tenant_id, latency, and trace correlation.
platphormctl report generate <runId>Built for the terminal.
Human-readable output with --json, --ndjson, and --yaml flags for pipelines. Every command is scriptable.
$ platphormctl network discover✔ Fetched network graph → platphormnews.com/api/network/graph✔ Discovered 38 sites · 6 edges · cached locally$ platphormctl network status --json{ "healthy": 34, "degraded": 2, "unavailable": 1, "unknown": 1 }$ platphormctl mcp smoke mcp.platphormnews.com✔ initialize · 200 · 48ms✔ tools/list · 12 tools · public: 10 protected: 2✔ smoke PASSED$ platphormctl harness run discovery-full --trace⟳ trace-id: 4bf92f3577b34da6a3ce929d0e0e4736✔ step 1/9 network-graph · ok✔ step 2/9 site-discovery · ok✔ step 3/9 health · ok (34 healthy)✔ run completed · report saved to .platphormctl/reports/$
Command reference.
Organised into command groups. Every command supports --json, --trace, --dry-run, and more.
- pctl networkdiscover
- pctl networkstatus
- pctl networkgraph
- pctl networkvalidate
- pctl networkreport
- pctl siteinspect
- pctl sitehealth
- pctl sitediscovery
- pctl siteopenapi
- pctl sitesitemap
- pctl siterss
- pctl sitellms
- pctl mcpinitialize
- pctl mcptools
- pctl mcpresources
- pctl mcpprompts
- pctl mcpcall
- pctl mcpsmoke
- pctl mcpnetwork-smoke
- pctl apilist
- pctl apicall
- pctl apismoke
- pctl apidiff
- pctl policyinspect
- pctl policyplatforms
- pctl policyevaluate
- pctl policynetwork
- pctl tracestart
- pctl tracerun
- pctl traceinspect
- pctl traceheaders
- pctl harnesslist
- pctl harnessrun <scenario>
- pctl llmproviders
- pctl llmask
- pctl llmsummarize-report
- pctl llmrepair-manifest
- pctl llmgenerate-workflow
- pctl doctor(default)
- pctl doctorsecrets
- pctl doctornetwork
- pctl reportgenerate
- pctl reportexport
- pctl reportopen
- pctl catalogsync
- pctl catalogcapability
- pctl catalogfrom-run
- pctl specvalidate
- pctl specrun
Built for everyone on the network.
Developers
Inspect and call APIs, validate schemas, diff OpenAPI surfaces.
Agents & LLMs
Machine-readable JSON/NDJSON output. Safe-by-default public tool calls.
CI/CD
Smoke tests, health gates, compliance checks. Deterministic exit codes.
Operators
Network-wide status, trace correlation, report generation.
Security & Compliance
Policy evaluation, secret redaction, SSRF guards, audit logs.
MCP clients
Initialize, list tools, call operations — full MCP JSON-RPC lifecycle.
Start controlling the network.
Install in seconds. No database required. Works offline with local cache. Public-safe by default — configure PLATPHORM_API_KEY for protected operations.
--jsonMachine-readable output--traceW3C trace propagation--dry-runSafe preview mode--ciCI/CD friendly--redactSecret redaction