# MCP Trace Observatory - Complete Documentation

## Introduction
MCP Trace Observatory is an AI-First observability platform for Model Context Protocol (MCP) agents. It provides real-time trace visualization, AI-powered analysis, and network monitoring for the Platphorm News federation.

## Architecture

### Frontend (LC3RS Design System)
- Built with Next.js 16 App Router
- LC3RS: LCARS evolved for Year 20226
- Quantum-era components with glow effects
- Responsive across all devices
- WCAG 2.2 AA accessible

### Backend
- Edge runtime for global low latency
- Neon PostgreSQL for trace storage
- Real-time WebSocket updates
- MCP protocol support (2024-11-05)

### Integrations
- Grok AI for trace analysis
- Atlas sensor for cosmic signatures
- Vercel Analytics + Bot tracking
- All 9 Platphorm News MCP servers

## MCP Protocol Implementation

### Endpoint
POST https://trace.platphormnews.com/api/mcp

### Initialize
```json
{
  "jsonrpc": "2.0",
  "method": "initialize",
  "id": 1
}
```

### List Tools
```json
{
  "jsonrpc": "2.0",
  "method": "tools/list",
  "id": 2
}
```

### Call Tool
```json
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list_traces",
    "arguments": { "limit": 10 }
  },
  "id": 3
}
```

## Tools Reference

### list_traces
List recent AI agent traces with optional filtering.

Parameters:
- limit (number): Max traces to return (default: 20, max: 100)
- status (string): Filter by status - running, completed, error, timeout
- agent (string): Filter by agent name
- minHealth (number): Minimum AI health score (0-100)

### get_trace
Get detailed information about a specific trace.

Parameters:
- traceId (string, required): The trace ID to fetch

### get_network_status
Get the current status of the Platphorm News MCP network.

Parameters: None

### get_trace_stats
Get aggregate statistics about traces.

Parameters:
- timeRange (string): Time range - 1h, 24h, 7d, 30d

### search_traces
Full-text search across trace names, descriptions, and agent names.

Parameters:
- query (string, required): Search query
- limit (number): Max results (default: 10)

### get_atlas_sensor
Get cosmic signature data from the Atlas sensor.

Parameters: None

## Resources

### trace://live
Real-time feed of incoming traces. Updates every second with new trace data.

### trace://network/health
Current health status of all Platphorm News MCP servers. Includes uptime, response times, and error rates.

### trace://stats/daily
Aggregated trace statistics for the past 24 hours. Includes counts, averages, and trends.

## Prompts

### analyze_trace
Generate AI-powered analysis of a trace including health score, performance insights, and recommendations.

Arguments:
- traceId (required): The trace ID to analyze

### explain_error
Explain an error in a trace in plain English, suitable for beginners who have never seen an MCP trace before.

Arguments:
- traceId (required): The trace ID with the error

### network_report
Generate a summary report of the Platphorm News MCP network status including all active servers, health metrics, and any issues.

Arguments: None

## Platphorm News Network

### MCP Servers (9)
1. platphormnews-mcp (https://mcp.platphormnews.com/api/mcp) - Primary hub
2. json-mcp (https://json.platphormnews.com/api/mcp) - JSON tools
3. desa-mcp (https://desa.platphormnews.com/api/mcp) - Analytics
4. atlas-mcp (https://atlas.platphormnews.com/api/mcp) - Geographic data
5. monitor-mcp (https://monitor.platphormnews.com/api/mcp) - Health monitoring
6. ascii-mcp (https://ascii.platphormnews.com/api/mcp) - ASCII conversion
7. quake-mcp (https://quake.platphormnews.com/api/mcp) - Gaming stats
8. calendar-mcp (https://calendar.platphormnews.com/api/mcp) - Events
9. ph3ar-mcp (https://mcp.ph3ar.com/api/mcp) - Security intelligence

### Network Stats
- Total Sites: 84+
- MCP-Enabled: 12
- Total Tools: 71
- Resources: 16
- Prompts: 23

## API Endpoints

### Health Check
GET /api/health
Returns server health, uptime, and capabilities.

### API Documentation
GET /api/docs
Returns OpenAPI-style documentation.

### Network Info
GET /api/v1/network
Returns network info, servers, and sites.

### Traces
GET /api/v1/traces
List and search traces.

### AI Analysis
POST /api/v1/ai/analyze
Grok-powered trace analysis.

## Discovery Files
- /llms.txt - This file (summary)
- /llms-full.txt - Complete documentation
- /robots.txt - Crawler directives
- /sitemap.xml - Site structure
- /rss.xml - RSS feed
- /feed.xml - Atom feed
- /ethics.txt - Ethics charter
- /standards.txt - Technical standards
- /principles.txt - AI principles

## Open Source
Licensed under MIT. Contributions welcome.
Repository: https://github.com/mbarbine/platphorm-trace

## Mission
"You bring people together" - The Platphorm Trace Lord unifies observability 
across the entire AI ecosystem, making debugging transparent and accessible 
for both humans and AI agents.

## Contact
Owner: Michael Barbine
Organization: Platphorm News
Website: https://platphormnews.com
X/Twitter: https://x.com/platphormnews
Coinbase: 0x30589F2e1B8E9a48BBb2c66Ac012FE7ED2A7eB85