# PlatPhorm AgentUI

Human and agent interface layer, MCP tool UI renderer, workflow artifact builder, schema-to-form preview, OpenAPI operation renderer, webhook form renderer, Phorm preview handoff, Layout/ASCII output viewer, delegation packet creator, and platphormctl workflow validation for PlatPhormNews.

## Overview

AgentUI turns machine-readable tools, APIs, MCP schemas, prompts, resources, workflows, evals, sandbox outputs, browser journeys, monitor checks, trace evidence, docs reports, sheets matrices, webhook payloads, Layout packets, ASCII outputs, and generated interface plans into usable forms, workflows, dashboards, approvals, reports, and shareable artifacts.

It is not the MCP gateway, API gateway, Evals, Sandbox, BrowserOps, Claws, Docs, Monitor, or Phorm. Those are integrations.

## Quick Links

- Documentation: https://agentui.platphormnews.com/api/docs
- OpenAPI YAML: https://agentui.platphormnews.com/openapi.yaml
- OpenAPI JSON: https://agentui.platphormnews.com/openapi.json
- AsyncAPI YAML: https://agentui.platphormnews.com/asyncapi.yaml
- MCP Endpoint: https://agentui.platphormnews.com/api/mcp
- Web4 Status: https://agentui.platphormnews.com/api/web4/status
- Route Evidence: https://agentui.platphormnews.com/api/web4/route-evidence
- Web4 Manifest: https://agentui.platphormnews.com/.well-known/web4.json
- Provenance Index: https://agentui.platphormnews.com/.well-known/provenance.json
- Fingerprints: https://agentui.platphormnews.com/api/web4/fingerprints
- Health Check: https://agentui.platphormnews.com/api/health
- v1 Health: https://agentui.platphormnews.com/api/v1/health
- RSS Feed: https://agentui.platphormnews.com/rss.xml
- Builder: https://agentui.platphormnews.com/builder
- Templates: https://agentui.platphormnews.com/templates
- Integrations: https://agentui.platphormnews.com/integrations
- CLI: https://agentui.platphormnews.com/clients/cli
- IDE: https://agentui.platphormnews.com/clients/ide
- Storage Status: https://agentui.platphormnews.com/api/v1/storage/status (append ?probe=true for public-safe DB accessibility and table-count evidence)

## Current Inventory

- Public workflows: 0
- Total registry workflows: 37
- Persisted runs: 9
- Workflow templates: 46
- Local AgentUI MCP tools: 87
- Discovered network MCP tools: 140
- Metrics source: live
- Storage mode: server_protected
- Server persistence: available
- Storage note: server persistence available

## API Endpoints

- GET  /api/v1/workflows
- POST /api/v1/workflows (protected)
- GET  /api/v1/runs
- GET  /api/v1/runs/{id}
- GET  /api/v1/runs/{id}/steps
- GET  /api/v1/runs/{id}/steps/{stepId}
- GET  /api/v1/runs/{id}/blocks/{blockId}
- GET  /api/v1/templates
- GET  /api/v1/artifacts
- GET  /api/v1/artifacts/{id}/view
- POST /api/v1/artifacts
- GET  /api/v1/storage/status
- GET  /api/v1/storage/status?probe=true
- GET  /api/v1/storage/modes
- POST /api/v1/render/mcp-tool
- POST /api/v1/render/openapi-operation
- POST /api/v1/render/json-schema
- POST /api/v1/render/webhook-schema
- POST /api/v1/render/artifact
- POST /api/v1/validate/form-input
- GET  /api/v1/delegations
- POST /api/v1/delegate/{service}
- POST /api/v1/workflows/{id}/blocks/{blockId}/dry-run
- POST /api/v1/workflows/{id}/blocks/{blockId}/run
- GET  /api/v1/integrations
- GET  /api/v1/cli/examples
- GET  /api/v1/agent-policy
- GET  /api/v1/approvals
- GET/POST /api/mcp (JSON-RPC 2.0)
- GET  /api/web4/status
- GET  /api/web4/scorecard
- GET  /api/web4/fingerprints
- GET  /api/web4/route-evidence
- GET  /api/provenance/lookup
- GET  /api/provenance/verify
- GET  /.well-known/web4.json
- GET  /.well-known/provenance.json

## Protected Actions

Protected actions require PLATPHORM_API_KEY:
- Authorization: Bearer $PLATPHORM_API_KEY
- X-PlatPhorm-API-Key: $PLATPHORM_API_KEY

Public read-only routes include landing/docs/templates/gallery/changelog/discovery/health/feed/sitemap and MCP introspection.

Server-side persistence, mutation, run, approval, publish, target-service execution, registry mutation, and private report export actions are protected. Local drafts, generated snapshots, exports, share packets, validation, and public-safe renderer previews remain public.

Delegation dry-runs return preview_ready handoff envelopes and do not call remote protected systems. Live protected delegation requests require PLATPHORM_API_KEY and return protected_required when auth is missing. Result references stay null until the target service confirms completion.

## Block Input / Output View

The builder view pane exposes selected-block input, output, output type, artifacts, evidence, result reference, trace id, public/protected state, and degraded reason for a selected run. Returned ASCII is displayed as exact monospace text. Docs publishing shows a returned URL only when Docs confirms a slug, URL, or document reference. Layout preview, score, and export packets are shown only from confirmed Layout responses or marked degraded.

## Optional Model Assistance

PLATPHORM_API_KEY remains the only platform protected-action key. Vercel AI Gateway / PLATPHORM_AI / SEARCH_URL are optional server-side configuration for labeled model-assisted drafts, summaries, labels, and search context. They do not replace confirmed block output, target-service execution, or persistence truth.

## Web4 And Provenance

AgentUI Web4 means rendered interfaces, workflows, approvals, artifacts, dry-runs, delegation packets, evidence panels, and result views are discoverable, inspectable, trace-linked, machine-readable, human-verifiable, provenance-ready, and safe to hand off.

Public-safe fingerprints cover templates, manifests, policies, integration registry, OpenAPI, AsyncAPI, MCP manifest, and route evidence. Raw JA4, raw x-vercel-ja4-digest, visitor, browser, device, behavioral, request-header, private workflow, protected tool, private approval, and private artifact fingerprints are excluded from public provenance.

## CLI

- Docs: https://cli.platphormnews.com
- Example: platphormctl site inspect agentui --best-effort

## Contact

Support: support@platphormnews.com