# PlatPhorm AgentOps - Full Documentation

> Agent Operations Layer for the PlatPhorm News network. Discover agent-safe routes, capabilities, runbooks, examples, handoffs, policies, feeds, graphs, MCP tools, OpenAPI operations, and human-readable mirrors for every PlatPhorm service.

Generated: 2026-06-03T05:41:40.334Z

---

## Table of Contents

1. Site Information
2. What AgentOps Does
3. Storage Model
4. Discovery Files
5. Network Services
6. Route Documentation
7. Ops Contracts
8. MCP Tools
9. API Endpoints
10. Authentication
11. Agent Policy
12. Web Status

---

## 1. Site Information

- URL: https://agentops.platphormnews.com
- Service: PlatPhorm AgentOps
- Purpose: Agent Operations Layer for the PlatPhorm News network
- Public-Safe Default: Yes (no auth wall for public-safe access)
- Database Required: No

### Identity

Use:
- PlatPhorm AgentOps
- AgentOps
- Agent Operations Layer
- Agent Runtime Operations Hub
- Agent-Safe Route Documentation Hub

Do not present AgentOps as:
- generic agent SaaS
- generic workflow SaaS
- MCP Gateway
- AgentUI

---

## 2. What AgentOps Does

AgentOps is the agent operations layer for PlatPhorm News.

### Responsibilities

- Agent-safe route documentation
- Agent operation examples
- Machine-readable content mirrors into HTML
- Service capability maps
- Route safety classes
- Agent allowed/disallowed behavior
- Public/protected action guidance
- Handoff guidance
- Agent runbook docs
- Local agent plan drafts
- Integration discovery
- CLI/MCP/OpenAPI examples
- Web Status visibility

### Primary UX Goal

A first-time user must understand within 10 seconds:
"AgentOps shows agents how to operate safely across PlatPhorm News."

---

## 3. Storage Model

AgentOps does not require a database.

### Storage Modes

- generated_snapshot (default)
- static_registry
- local_browser
- memory
- postgres_optional
- redis_optional

Current Mode: generated_snapshot
Database Required: false
Degraded: false

---

## 4. Discovery Files

### Machine-Readable
- llms: https://agentops.platphormnews.com/llms.txt
- llmsFull: https://agentops.platphormnews.com/llms-full.txt
- llmsIndex: https://agentops.platphormnews.com/llms-index.json
- openapiYaml: https://agentops.platphormnews.com/openapi.yaml
- openapiJson: https://agentops.platphormnews.com/openapi.json
- mcp: https://agentops.platphormnews.com/api/mcp
- mcpWellKnown: https://agentops.platphormnews.com/.well-known/mcp.json
- rss: https://agentops.platphormnews.com/rss.xml
- feed: https://agentops.platphormnews.com/feed.xml
- sitemap: https://agentops.platphormnews.com/sitemap.xml
- sitemapMain: https://agentops.platphormnews.com/sitemap-main.xml
- sitemapIndex: https://agentops.platphormnews.com/sitemap-index.xml
- graph: https://agentops.platphormnews.com/graph.json
- agentopsGraph: https://agentops.platphormnews.com/agentops.graph.json
- webJson: https://agentops.platphormnews.com/.well-known/web.json
- agentsJson: https://agentops.platphormnews.com/.well-known/agents.json
- agentPolicyJson: https://agentops.platphormnews.com/.well-known/agent-policy.json
- aiPolicyJson: https://agentops.platphormnews.com/.well-known/ai-policy.json
- trustJson: https://agentops.platphormnews.com/.well-known/trust.json
- securityTxt: https://agentops.platphormnews.com/.well-known/security.txt
- provenanceJson: https://agentops.platphormnews.com/.well-known/provenance.json
- robots: https://agentops.platphormnews.com/robots.txt

### Human-Readable Mirrors
- llms: https://agentops.platphormnews.com/docs/llms
- openapi: https://agentops.platphormnews.com/docs/openapi
- mcp: https://agentops.platphormnews.com/docs/mcp
- feeds: https://agentops.platphormnews.com/docs/feeds
- graphs: https://agentops.platphormnews.com/docs/graphs
- wellKnown: https://agentops.platphormnews.com/docs/well-known
- agentPolicy: https://agentops.platphormnews.com/docs/agent-policy
- trustPolicy: https://agentops.platphormnews.com/docs/trust-policy
- examples: https://agentops.platphormnews.com/docs/examples

---

## 5. Network Services

Total: 41 services
Active: 2
Planned: 39

### PlatPhorm News
- Slug: platphormnews
- URL: https://platphormnews.com
- Category: root
- Status: active
- Purpose: Root site for PlatPhorm News network
- Public-Safe: true
- Protected: false

### AgentOps
- Slug: agentops
- URL: https://agentops.platphormnews.com
- Category: ops
- Status: active
- Purpose: Agent operations layer - agent-safe route documentation, capabilities, runbooks, examples, and handoffs
- Public-Safe: true
- Protected: false

### SearchOps
- Slug: searchops
- URL: https://searchops.platphormnews.com
- Category: ops
- Status: planned
- Purpose: Daily crawling, URL labeling, status code capture, canonical detection, alerts
- Public-Safe: true
- Protected: false

### SitemapOps
- Slug: sitemapops
- URL: https://sitemapops.platphormnews.com
- Category: ops
- Status: planned
- Purpose: Index policy driven sitemap generation, exclusions, meaningful lastmod
- Public-Safe: true
- Protected: false

### StoryOps
- Slug: storyops
- URL: https://storyops.platphormnews.com
- Category: ops
- Status: planned
- Purpose: Story quality gating, indexable story flag, thin story quarantine
- Public-Safe: true
- Protected: false

### TrustOps
- Slug: trustops
- URL: https://trustops.platphormnews.com
- Category: ops
- Status: planned
- Purpose: Author schema, publisher schema, corrections policy, AI-use disclosure
- Public-Safe: true
- Protected: false

### MCP Gateway
- Slug: mcp
- URL: https://mcp.platphormnews.com
- Category: integration
- Status: planned
- Purpose: MCP Gateway for Model Context Protocol integrations
- Public-Safe: true
- Protected: false

### AgentUI
- Slug: agentui
- URL: https://agentui.platphormnews.com
- Category: integration
- Status: planned
- Purpose: Agent UI rendering and interaction layer
- Public-Safe: true
- Protected: false

### Spec
- Slug: spec
- URL: https://spec.platphormnews.com
- Category: docs
- Status: planned
- Purpose: Specification and standards documentation
- Public-Safe: true
- Protected: false

### Webhooks
- Slug: webhooks
- URL: https://webhooks.platphormnews.com
- Category: integration
- Status: planned
- Purpose: Webhook delivery and management
- Public-Safe: true
- Protected: false

### Sandbox
- Slug: sandbox
- URL: https://sandbox.platphormnews.com
- Category: integration
- Status: planned
- Purpose: Safe execution sandbox for agent operations
- Public-Safe: true
- Protected: false

### BrowserOps
- Slug: browserops
- URL: https://browserops.platphormnews.com
- Category: ops
- Status: planned
- Purpose: Browser automation and validation
- Public-Safe: true
- Protected: false

### Evals
- Slug: evals
- URL: https://evals.platphormnews.com
- Category: integration
- Status: planned
- Purpose: Evaluation and scoring framework
- Public-Safe: true
- Protected: false

### Claws
- Slug: claws
- URL: https://claws.platphormnews.com
- Category: integration
- Status: planned
- Purpose: Agent planning and task management
- Public-Safe: true
- Protected: false

### Monitor
- Slug: monitor
- URL: https://monitor.platphormnews.com
- Category: ops
- Status: planned
- Purpose: Monitoring and alerting
- Public-Safe: true
- Protected: false

### Trace
- Slug: trace
- URL: https://trace.platphormnews.com
- Category: ops
- Status: planned
- Purpose: Distributed tracing and observability
- Public-Safe: true
- Protected: false

### Docs
- Slug: docs
- URL: https://docs.platphormnews.com
- Category: docs
- Status: planned
- Purpose: Documentation hub
- Public-Safe: true
- Protected: false

### Sheets
- Slug: sheets
- URL: https://sheets.platphormnews.com
- Category: tools
- Status: planned
- Purpose: Spreadsheet and data export tools
- Public-Safe: true
- Protected: false

### Catalog
- Slug: catalog
- URL: https://catalog.platphormnews.com
- Category: tools
- Status: planned
- Purpose: Content and service catalog
- Public-Safe: true
- Protected: false

### Fingerprint
- Slug: fingerprint
- URL: https://fingerprint.platphormnews.com
- Category: security
- Status: planned
- Purpose: Request fingerprinting and security
- Public-Safe: true
- Protected: false

### Phorm
- Slug: phorm
- URL: https://phorm.platphormnews.com
- Category: tools
- Status: planned
- Purpose: Form builder and data collection
- Public-Safe: true
- Protected: false

### Open Content
- Slug: opencontent
- URL: https://opencontent.platphormnews.com
- Category: content
- Status: planned
- Purpose: Open content distribution
- Public-Safe: true
- Protected: false

### Podcasts
- Slug: podcasts
- URL: https://podcasts.platphormnews.com
- Category: content
- Status: planned
- Purpose: Podcast content management
- Public-Safe: true
- Protected: false

### Reader
- Slug: reader
- URL: https://reader.platphormnews.com
- Category: content
- Status: planned
- Purpose: Reading and content consumption
- Public-Safe: true
- Protected: false

### Echo
- Slug: echo
- URL: https://echo.platphormnews.com
- Category: content
- Status: planned
- Purpose: Content syndication and echo chamber
- Public-Safe: true
- Protected: false

### Dictionary
- Slug: dictionary
- URL: https://dictionary.platphormnews.com
- Category: tools
- Status: planned
- Purpose: Dictionary and terminology tools
- Public-Safe: true
- Protected: false

### Emoji
- Slug: emoji
- URL: https://emoji.platphormnews.com
- Category: tools
- Status: planned
- Purpose: Emoji tools and utilities
- Public-Safe: true
- Protected: false

### JSON
- Slug: json
- URL: https://json.platphormnews.com
- Category: tools
- Status: planned
- Purpose: JSON formatting and tools
- Public-Safe: true
- Protected: false

### XML
- Slug: xml
- URL: https://xml.platphormnews.com
- Category: tools
- Status: planned
- Purpose: XML formatting and tools
- Public-Safe: true
- Protected: false

### Markdown
- Slug: markdown
- URL: https://markdown.platphormnews.com
- Category: tools
- Status: planned
- Purpose: Markdown editing and tools
- Public-Safe: true
- Protected: false

### Layout
- Slug: layout
- URL: https://layout.platphormnews.com
- Category: tools
- Status: planned
- Purpose: Layout and design tools
- Public-Safe: true
- Protected: false

### SVG
- Slug: svg
- URL: https://svg.platphormnews.com
- Category: tools
- Status: planned
- Purpose: SVG generation and tools
- Public-Safe: true
- Protected: false

### ASCII
- Slug: ascii
- URL: https://ascii.platphormnews.com
- Category: tools
- Status: planned
- Purpose: ASCII art and text tools
- Public-Safe: true
- Protected: false

### Calendar
- Slug: calendar
- URL: https://calendar.platphormnews.com
- Category: tools
- Status: planned
- Purpose: Calendar and scheduling tools
- Public-Safe: true
- Protected: false

### Kanban
- Slug: kanban
- URL: https://kanban.platphormnews.com
- Category: tools
- Status: planned
- Purpose: Kanban board and project management
- Public-Safe: true
- Protected: false

### Finance
- Slug: finance
- URL: https://finance.platphormnews.com
- Category: tools
- Status: planned
- Purpose: Finance and reporting tools
- Public-Safe: true
- Protected: false

### Shipments
- Slug: shipments
- URL: https://shipments.platphormnews.com
- Category: tools
- Status: planned
- Purpose: Shipping and logistics tracking
- Public-Safe: true
- Protected: false

### CLI
- Slug: cli
- URL: https://cli.platphormnews.com
- Category: tools
- Status: planned
- Purpose: Command-line interface tools
- Public-Safe: true
- Protected: false

### Keys
- Slug: keys
- URL: https://keys.platphormnews.com
- Category: security
- Status: planned
- Purpose: API key management
- Public-Safe: true
- Protected: false

### Insights
- Slug: insights
- URL: https://insights.platphormnews.com
- Category: analytics
- Status: planned
- Purpose: Analytics and insights
- Public-Safe: true
- Protected: false

### Atlas
- Slug: atlas
- URL: https://atlas.platphormnews.com
- Category: tools
- Status: planned
- Purpose: Geographic and mapping tools
- Public-Safe: true
- Protected: false


---

## 6. Route Documentation

Total Routes: 10
Agent-Safe Routes: 10
Public Routes: 10
Protected Routes: 0

### Route Safety Classes

- public_read: Safe for public reading
- public_dry_run: Safe for public dry-run validation
- protected_write: Requires PLATPHORM_API_KEY for writes
- protected_execute: Requires PLATPHORM_API_KEY for execution
- protected_publish: Requires PLATPHORM_API_KEY for publishing
- protected_admin: Requires PLATPHORM_API_KEY for admin actions

### All Routes

#### GET /
- Title: AgentOps Homepage
- Description: Agent operations control center homepage
- Safety Class: public_read
- Public-Safe: true
- Protected: false
- Auth Required: false
- Content Type: text/html
- Agent Allowed: Read homepage content, Extract service counts, Follow navigation links
- Agent Disallowed: Mutate state, Execute protected actions
- Related MCP Tool: get_agentops_info
- Related OpenAPI Operation: None

#### GET /api/health
- Title: Health Check
- Description: Service health endpoint
- Safety Class: public_read
- Public-Safe: true
- Protected: false
- Auth Required: false
- Content Type: application/json
- Agent Allowed: Check service health, Monitor uptime
- Agent Disallowed: None specified
- Related MCP Tool: get_agentops_status
- Related OpenAPI Operation: getHealth

#### GET /api/v1/storage/status
- Title: Storage Status
- Description: Current storage adapter status - no database required
- Safety Class: public_read
- Public-Safe: true
- Protected: false
- Auth Required: false
- Content Type: application/json
- Agent Allowed: Check storage mode, Verify no database requirement
- Agent Disallowed: None specified
- Related MCP Tool: get_storage_status
- Related OpenAPI Operation: getStorageStatus

#### GET /api/v1/services
- Title: List Services
- Description: List all discovered PlatPhorm services
- Safety Class: public_read
- Public-Safe: true
- Protected: false
- Auth Required: false
- Content Type: application/json
- Agent Allowed: List services, Filter by category, Check service status
- Agent Disallowed: Mutate registry
- Related MCP Tool: list_services
- Related OpenAPI Operation: listServices

#### GET /api/v1/routes
- Title: List Routes
- Description: List all documented routes across services
- Safety Class: public_read
- Public-Safe: true
- Protected: false
- Auth Required: false
- Content Type: application/json
- Agent Allowed: List routes, Filter by safety class, Check route documentation
- Agent Disallowed: Mutate route docs
- Related MCP Tool: list_agent_safe_routes
- Related OpenAPI Operation: listRoutes

#### GET /api/v1/routes/agent-safe
- Title: Agent-Safe Routes
- Description: List routes safe for autonomous agent operation
- Safety Class: public_read
- Public-Safe: true
- Protected: false
- Auth Required: false
- Content Type: application/json
- Agent Allowed: List agent-safe routes, Discover safe operations
- Agent Disallowed: None specified
- Related MCP Tool: list_agent_safe_routes
- Related OpenAPI Operation: listAgentSafeRoutes

#### GET /api/web/status
- Title: Web Status
- Description: Operational readiness status for AgentOps
- Safety Class: public_read
- Public-Safe: true
- Protected: false
- Auth Required: false
- Content Type: application/json
- Agent Allowed: Check operational readiness, Verify discovery files exist
- Agent Disallowed: None specified
- Related MCP Tool: get_web_status
- Related OpenAPI Operation: getWebStatus

#### GET /llms.txt
- Title: LLMS.txt
- Description: Machine-readable LLM discovery file
- Safety Class: public_read
- Public-Safe: true
- Protected: false
- Auth Required: false
- Content Type: text/plain
- Agent Allowed: Read llms.txt, Parse discovery information
- Agent Disallowed: None specified
- Related MCP Tool: inspect_llms_index
- Related OpenAPI Operation: None

#### GET /openapi.json
- Title: OpenAPI Spec
- Description: OpenAPI 3.1 specification for AgentOps API
- Safety Class: public_read
- Public-Safe: true
- Protected: false
- Auth Required: false
- Content Type: application/json
- Agent Allowed: Read OpenAPI spec, Generate client code
- Agent Disallowed: None specified
- Related MCP Tool: inspect_openapi
- Related OpenAPI Operation: None

#### POST /api/mcp
- Title: MCP Endpoint
- Description: Model Context Protocol JSON-RPC 2.0 endpoint
- Safety Class: public_dry_run
- Public-Safe: true
- Protected: false
- Auth Required: false
- Content Type: application/json
- Agent Allowed: Call public MCP tools, List available tools, Read resources
- Agent Disallowed: Call protected tools without PLATPHORM_API_KEY
- Related MCP Tool: None
- Related OpenAPI Operation: mcpEndpoint


---

## 7. Ops Contracts

AgentOps documents integration contracts for network ops services.

### SearchOps

- Slug: searchops
- Description: Daily crawling, URL labeling, status code capture, canonical detection, alerts
- Purpose: SearchOps owns daily crawling, status code capture, canonical detection, title extraction, meta robots extraction, schema extraction, sitemap membership, internal links, image size, content length, feed membership, GSC export comparison, URL labeling, and alerts.
- Public-Safe: true
- Protected: true

#### Routes

- GET /api/searchops/status: SearchOps operational status (public)
- GET /api/searchops/crawl-runs: List crawl runs (public)
- GET /api/searchops/urls: List crawled URLs with labels (public)
- GET /api/searchops/alerts: List active alerts (5xx, 4xx, redirects, etc.) (public)
- POST /api/searchops/crawl/dry-run: Dry-run crawl validation (public)
- POST /api/searchops/crawl/start: Start a crawl run (protected)
- POST /api/searchops/gsc/import: Import GSC data (protected)
- POST /api/searchops/indexnow/submit: Submit URLs to IndexNow (protected)

### SitemapOps

- Slug: sitemapops
- Description: Index policy driven sitemap generation, exclusions, meaningful lastmod
- Purpose: SitemapOps owns sitemap generation from index policy, exclusion of noindex/redirected/blocked/duplicate/weak pages, meaningful lastmod, and separate article/tool/docs/report/news sitemaps.
- Public-Safe: true
- Protected: true

#### Routes

- GET /api/sitemapops/status: SitemapOps operational status (public)
- GET /api/sitemapops/index-policy: Current index policy (public)
- GET /api/sitemapops/sitemaps: List all generated sitemaps (public)
- GET /api/sitemapops/sitemaps/articles: Article sitemap (public)
- GET /api/sitemapops/sitemaps/tools: Tools sitemap (public)
- GET /api/sitemapops/sitemaps/docs: Docs sitemap (public)
- GET /api/sitemapops/sitemaps/reports: Reports sitemap (public)
- GET /api/sitemapops/sitemaps/news: News sitemap (public)
- POST /api/sitemapops/generate: Generate sitemaps (protected)
- POST /api/sitemapops/validate: Validate sitemaps (protected)

### StoryOps

- Slug: storyops
- Description: Story quality gating, indexable story flag, thin story quarantine
- Purpose: StoryOps owns the indexable story flag, story quality gating, required story fields (author, lede, whyItMatters, sourceMatrix, image, datePublished, dateModified), and thin story quarantine.
- Public-Safe: true
- Protected: true

#### Routes

- GET /api/storyops/status: StoryOps operational status (public)
- GET /api/storyops/stories: List all stories (public)
- GET /api/storyops/stories/indexable: List indexable stories (public)
- GET /api/storyops/quarantine/thin-stories: List quarantined thin stories (public)
- POST /api/storyops/stories/[id]/evaluate: Evaluate story quality (protected)
- POST /api/storyops/stories/[id]/set-indexable: Set story indexable flag (protected)
- POST /api/storyops/quarantine/[id]/review: Review quarantined story (protected)

### TrustOps

- Slug: trustops
- Description: Author schema, publisher schema, corrections policy, AI-use disclosure
- Purpose: TrustOps owns author schema, publisher schema, corrections policy, contact policy, AI-use disclosure, and source attribution policy.
- Public-Safe: true
- Protected: true

#### Routes

- GET /api/trustops/status: TrustOps operational status (public)
- GET /api/trustops/author-schema: Author schema definition (public)
- GET /api/trustops/publisher-schema: Publisher schema definition (public)
- GET /api/trustops/corrections-policy: Corrections policy (public)
- GET /api/trustops/contact-policy: Contact policy (public)
- GET /api/trustops/ai-use-disclosure: AI use disclosure (public)
- GET /api/trustops/source-attribution-policy: Source attribution policy (public)
- POST /api/trustops/validate: Validate trust policies (protected)
- POST /api/trustops/publish-policy: Publish trust policy (protected)


---

## 8. MCP Tools

AgentOps provides MCP tools via JSON-RPC 2.0 at /api/mcp.

### Public-Safe Tools

- get_agentops_info
- get_agentops_status
- get_storage_status
- list_services
- get_service
- list_agent_safe_routes
- list_public_routes
- list_protected_routes
- get_route_doc
- list_capabilities
- get_capability
- list_runbooks
- get_runbook
- list_examples
- get_example
- create_local_agent_plan
- validate_agent_plan
- dry_run_agent_plan
- get_web_status

### Protected Tools

- sync_agentops_discovery
- delegate_agent_plan
- publish_agent_runbook
- update_agent_route_doc

---

## 9. API Endpoints

### Platform

- GET / - Homepage
- GET /api/health - Health check
- GET /api/docs - API documentation
- GET /openapi.yaml - OpenAPI YAML
- GET /openapi.json - OpenAPI JSON
- GET /llms.txt - LLMS discovery
- GET /llms-full.txt - Full LLMS documentation
- GET /llms-index.json - LLMS index
- GET /rss.xml - RSS feed
- GET /feed.xml - Atom feed
- GET /sitemap.xml - Sitemap
- GET /robots.txt - Robots
- GET /graph.json - Service graph

### AgentOps API v1

- GET /api/v1/services - List services
- GET /api/v1/services/[slug] - Get service
- GET /api/v1/routes - List routes
- GET /api/v1/routes/agent-safe - Agent-safe routes
- GET /api/v1/routes/public - Public routes
- GET /api/v1/routes/protected - Protected routes
- GET /api/v1/storage/status - Storage status
- GET /api/v1/graph - Full graph
- GET /api/v1/ops-contracts - Ops contracts

### Web Status

- GET /api/web/status - Web Status
- GET /api/web/manifest - Web manifest
- GET /api/web/scorecard - Scorecard

---

## 10. Authentication

### Public-Safe Access

No authentication required for:
- Homepage and documentation
- Route documentation
- Service registry
- Public dry-run operations
- Machine-readable files
- Human-readable mirrors
- Examples
- Web Status

### Protected Actions

Require: Authorization: Bearer $PLATPHORM_API_KEY

Or: X-PlatPhorm-API-Key: $PLATPHORM_API_KEY

---

## 11. Agent Policy

### Agents May

- Read public-safe docs
- Read public-safe discovery
- Call public-safe GET APIs
- Perform public dry-runs
- Create local plans
- Create local share packets
- Validate route schemas
- Generate reproducible CLI commands
- Request protected action only when PLATPHORM_API_KEY is available

### Agents Must Not

- Mutate state without authorization
- Execute protected tools without authorization
- Publish reports without authorization
- Expose secrets
- Store private payloads in public artifacts
- Treat degraded results as verified
- Claim delegation completed without target confirmation
- Crawl or call private routes

---

## 12. Web Status

Schema Version: web.status.v1
Site: https://agentops.platphormnews.com
Service: PlatPhorm AgentOps
Generated: 2026-06-03T05:41:40.334Z
Degraded: false

### Readiness

- rootRoute: pass
- health: pass
- openapi: pass
- mcp: pass
- llms: pass
- feeds: pass
- graphs: pass
- sitemap: pass
- agentSafeRoutes: pass
- examples: pass
- humanReadableMirrors: pass
- trust: pass
- trace: partial
- handoffs: partial
- fingerprints: partial
- provenance: partial

### Counts

- services: 41
- routes: 10
- agentSafeRoutes: 10
- capabilities: 0
- runbooks: 0
- examples: 0
- machineReadableFiles: 15
- humanReadableMirrors: 9

---

End of llms-full.txt