Observability

This reference is auto-generated from the registered MCP tool providers in perspectapiworkers. It reflects the tools exposed by the per-site Perspect MCP server.

Connection

Use the per-site MCP endpoint:

https://perspect.com/mcp/{siteName}

Authenticate with OAuth or an MCP API key using Authorization: Bearer sk_mcp_....

Tools

observability_analytics

Title: Site Analytics

Get request analytics for the site. Returns request counts, human/bot split, status codes, top paths, referrers, countries, and response times. Use period='hourly' for a single day breakdown, or period='daily' for multi-day trends.

Required permission: observability.read

Parameters

Parameter	Type	Required	Default	Description
period	string	No	"hourly"	Granularity: 'hourly' for one day, 'daily' for multi-day Allowed: hourly, daily.
date	string	Yes	—	Date in YYYY-MM-DD format. For hourly: the day to query. For daily: the end date.
days	number	No	—	For daily period: number of days back from date (default 7, max 90)

Example call

{
  "tool": "observability_analytics",
  "arguments": {
    "period": "hourly",
    "date": "string"
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}

observability_logs

Title: Runtime Logs

Get console output (console.log, warn, error) and exceptions from the deployed site worker. Useful for debugging runtime issues. Filter by date and optionally by hour or severity level.

Required permission: observability.read

Parameters

Parameter	Type	Required	Default	Description
date	string	Yes	—	Date in YYYY-MM-DD format
hour	string	No	—	Hour (0-23) to narrow results, optional
level	string	No	"all"	Filter by severity: 'all' (default), 'error' (errors + exceptions only), 'warn' (warnings + errors) Allowed: all, error, warn.

Example call

{
  "tool": "observability_logs",
  "arguments": {
    "date": "string",
    "level": "all"
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}

observability_summary

Title: Site Health Summary

Quick health overview for the site: today's request count, error rate, average response time, outcome breakdown, and top errors. Use this as a first check before diving into detailed analytics or traces.

Required permission: observability.read

Parameters

Parameter	Type	Required	Default	Description
date	string	No	—	Date in YYYY-MM-DD format (defaults to today)

Example call

{
  "tool": "observability_summary",
  "arguments": {}
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}

observability_traces

Title: Request Traces

Get per-request execution traces showing the incoming request, subrequests (fetch calls), response status, timing, and any exceptions. Useful for diagnosing slow requests or failures.

Required permission: observability.traces

Parameters

Parameter	Type	Required	Default	Description
date	string	Yes	—	Date in YYYY-MM-DD format
hour	string	No	—	Hour (0-23) to narrow results, optional
traceId	string	No	—	Filter by a specific trace ID
limit	number	No	—	Max traces to return (default 20, max 100)

Example call

{
  "tool": "observability_traces",
  "arguments": {
    "date": "string"
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}

---

This page is generated from the registered MCP tool providers. Do not edit it by hand.