Platphorm Network
API v1

API Documentation

Everything you need to integrate MCP Trace into your agents and tools. Simple REST API with no authentication required for basic usage.

Check API HealthLLM Reference

Quick Start

Send your first trace in seconds. No signup or API key required.

curl -X POST https://trace.platphormnews.com/api/v1/traces \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My first trace",
    "agentName": "my-agent",
    "startTime": "'$(date -u +"%Y-%m-%dT%H:%M:%SZ")'",
    "status": "completed",
    "spans": [
      {
        "name": "tools/call search",
        "startTime": "'$(date -u +"%Y-%m-%dT%H:%M:%SZ")'",
        "durationMs": 1234,
        "genAiToolName": "search",
        "status": "ok"
      }
    ]
  }'

API Endpoints

POST/api/v1/traces
Ingest Trace
Submit a new trace with spans
GET/api/v1/traces
List Traces
Browse and filter public traces
GET/api/v1/traces/{id}
Get Trace
Retrieve full trace with spans
POST/api/v1/traces/{id}/spans
Append Spans
Add spans to a running trace
POST/api/v1/traces/{id}/analyze
Analyze Trace
Run AI analysis on a trace
POST/api/v1/traces/{id}/fork
Fork Trace
Create a what-if scenario
GET/api/v1/traces/compare
Compare Traces
Side-by-side trace comparison
GET/api/v1/traces/{id}/export
Export Trace
Download as JSON, Markdown, or OTel

Rate Limits

2,000/min
Premium
With API key
1,000/min
Network
*.platphormnews.com
500/min
Recognized
Returning visitors
60/min
Public
Anonymous access

Security

Authentication
Optional but recommended for production
# With API key (higher rate limits)
curl -H "X-API-Key: your_api_key" \
  https://trace.platphormnews.com/api/v1/traces
Trusted Domains
Automatic elevated trust for known domains
  • Network*.platphormnews.com
  • Platform*.vercel.app, *.vercel.com
  • Developmentlocalhost:*

Ready to start observing?

No signup required. Start sending traces immediately.

View Live TracesComplete Reference