site_statsOwner only. Lookup count (how often agents and visitors looked the domain up), score breakdown, recent notifications, the badge embed, and the last 30 score snapshots.
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes | A domain name such as example.com (no scheme, no path). | |
| api_key | Yes | The owner API key issued by verify_domain (awm_key_...). |
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Changes observed during successful MCP inspections.
Output schema / anyOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "authority": {
- "type": [
- "integer",
- "null"
- ]
- },
- "badge": {
- "additionalProperties": false,
- "properties": {
- "html": {
- "type": "string"
- },
- "markdown": {
- "type": "string"
- },
- "svg": {
- "type": "string"
- }
- },
- "required": [
- "svg",
- "html",
- "markdown"
- ],
- "type": "object"
- },
- "breakdown": {
- "additionalProperties": false,
- "properties": {
- "freshness": {
- "type": [
- "integer",
- "null"
- ]
- },
- "quality": {
- "type": [
- "integer",
- "null"
- ]
- },
- "reach": {
- "type": [
- "integer",
- "null"
- ]
- },
- "trust": {
- "type": [
- "integer",
- "null"
- ]
- }
- },
- "required": [
- "reach",
- "trust",
- "quality",
- "freshness"
- ],
- "type": "object"
- },
- "checks": {
- "additionalProperties": false,
- "properties": {
- "homepage_ok": {
- "type": [
- "boolean",
- "null"
- ]
- },
- "links_checked": {
- "type": [
- "integer",
- "null"
- ]
- },
- "links_ok": {
- "type": [
- "integer",
- "null"
- ]
- }
- },
- "required": [
- "homepage_ok",
- "links_checked",
- "links_ok"
- ],
- "type": "object"
- },
- "domain": {
- "type": "string"
- },
- "history": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "authority": {
- "type": [
- "integer",
- "null"
- ]
- },
- "checked_at": {
- "type": [
- "string",
- "null"
- ]
- },
- "freshness": {
- "type": [
- "integer",
- "null"
- ]
- },
- "quality": {
- "type": [
- "integer",
- "null"
- ]
- },
- "reach": {
- "type": [
- "integer",
- "null"
- ]
- },
- "trust": {
- "type": [
- "integer",
- "null"
- ]
- }
- },
- "required": [
- "checked_at",
- "authority",
- "reach",
- "trust",
- "quality",
- "freshness"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "last_checked": {
- "type": [
- "string",
- "null"
- ]
- },
- "lookups": {
- "type": "integer"
- },
- "notifications": {
- "additionalProperties": false,
- "properties": {
- "notify_email": {
- "type": [
- "string",
- "null"
- ]
- },
- "recent": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "channel": {
- "type": "string"
- },
- "detail": {
- "type": [
- "string",
- "null"
- ]
- },
- "event": {
- "type": "string"
- },
- "ok": {
- "type": "boolean"
- },
- "sent_at": {
- "type": [
- "string",
- "null"
- ]
- },
- "watch_id": {
- "type": "integer"
- }
- },
- "required": [
- "event",
- "channel",
- "ok",
- "detail",
- "sent_at"
- ],
- "type": "object"
- },
- "type": "array"
- },
- "webhook_url": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "required": [
- "webhook_url",
- "notify_email",
- "recent"
- ],
- "type": "object"
- },
- "tier": {
- "enum": [
- "featured",
- "listed",
- "unlisted",
- "rejected",
- null
- ],
- "type": [
- "string",
- "null"
- ]
- },
- "verified_at": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "required": [
- "domain",
- "verified_at",
- "lookups",
- "tier",
- "authority",
- "breakdown",
- "checks",
- "last_checked",
- "badge",
- "notifications",
- "history"
- ],
- "type": "object"
- },
- {
- "additionalProperties": true,
- "properties": {
- "detail": {
- "type": "string"
- },
- "domain": {
- "type": "string"
- },
- "error": {
- "type": "string"
- },
- "hint": {
- "type": "string"
- },
- "retry_after_seconds": {
- "type": "integer"
- }
- },
- "required": [
- "error"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "authority": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "badge": {
+ "additionalProperties": false,
+ "properties": {
+ "html": {
+ "type": "string"
+ },
+ "markdown": {
+ "type": "string"
+ },
+ "svg": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "svg",
+ "html",
+ "markdown"
+ ],
+ "type": "object"
+ },
+ "breakdown": {
+ "additionalProperties": false,
+ "properties": {
+ "freshness": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "quality": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "reach": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "trust": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "reach",
+ "trust",
+ "quality",
+ "freshness"
+ ],
+ "type": "object"
+ },
+ "checks": {
+ "additionalProperties": false,
+ "properties": {
+ "homepage_ok": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "links_checked": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "links_ok": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "homepage_ok",
+ "links_checked",
+ "links_ok"
+ ],
+ "type": "object"
+ },
+ "domain": {
+ "type": "string"
+ },
+ "history": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "authority": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "checked_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "freshness": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "quality": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "reach": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "trust": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "checked_at",
+ "authority",
+ "reach",
+ "trust",
+ "quality",
+ "freshness"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "last_checked": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "lookups": {
+ "type": "integer"
+ },
+ "lookups_note": {
+ "type": "string"
+ },
+ "notifications": {
+ "additionalProperties": false,
+ "properties": {
+ "notify_email": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "recent": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "channel": {
+ "type": "string"
+ },
+ "detail": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "event": {
+ "type": "string"
+ },
+ "ok": {
+ "type": "boolean"
+ },
+ "sent_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "watch_id": {
+ "type": "integer"
+ }
+ },
+ "required": [
+ "event",
+ "channel",
+ "ok",
+ "detail",
+ "sent_at"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "webhook_url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "webhook_url",
+ "notify_email",
+ "recent"
+ ],
+ "type": "object"
+ },
+ "tier": {
+ "enum": [
+ "featured",
+ "listed",
+ "unlisted",
+ "rejected",
+ null
+ ],
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "usage": {
+ "additionalProperties": false,
+ "properties": {
+ "active_days": {
+ "type": "integer"
+ },
+ "daily": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "count": {
+ "type": "integer"
+ },
+ "day": {
+ "type": "string"
+ },
+ "event": {
+ "type": "string"
+ },
+ "surface": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "day",
+ "event",
+ "surface",
+ "count"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "documentation_selections": {
+ "type": "integer"
+ },
+ "events": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "active_days": {
+ "type": "integer"
+ },
+ "count": {
+ "type": "integer"
+ },
+ "event": {
+ "type": "string"
+ },
+ "surface": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "event",
+ "surface",
+ "count",
+ "active_days"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "from": {
+ "type": "string"
+ },
+ "limitations": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "measurement_started_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "profile_views": {
+ "type": "integer"
+ },
+ "referrals": {
+ "type": "integer"
+ },
+ "requests": {
+ "additionalProperties": false,
+ "properties": {
+ "mcp": {
+ "type": "integer"
+ },
+ "rest": {
+ "type": "integer"
+ },
+ "web": {
+ "type": "integer"
+ }
+ },
+ "required": [
+ "web",
+ "rest",
+ "mcp"
+ ],
+ "type": "object"
+ },
+ "through": {
+ "type": "string"
+ },
+ "window_days": {
+ "type": "integer"
+ }
+ },
+ "required": [
+ "measurement_started_at",
+ "window_days",
+ "from",
+ "through",
+ "active_days",
+ "requests",
+ "profile_views",
+ "documentation_selections",
+ "referrals",
+ "events",
+ "daily",
+ "limitations"
+ ],
+ "type": "object"
+ },
+ "verified_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "domain",
+ "verified_at",
+ "lookups",
+ "tier",
+ "authority",
+ "breakdown",
+ "checks",
+ "last_checked",
+ "badge",
+ "notifications",
+ "history"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": true,
+ "properties": {
+ "detail": {
+ "type": "string"
+ },
+ "domain": {
+ "type": "string"
+ },
+ "error": {
+ "type": "string"
+ },
+ "hint": {
+ "type": "string"
+ },
+ "retry_after_seconds": {
+ "type": "integer"
+ }
+ },
+ "required": [
+ "error"
+ ],
+ "type": "object"
+ }
+]Input schema / properties / api_key / maxLengthAdded value: +200Input schema / properties / api_key / minLengthAdded value: +1Input schema / properties / domain / maxLengthAdded value: +253Input schema / properties / domain / minLengthAdded value: +1Output schema / (root)Previous value: -nullNew value: +{
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "authority": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "badge": {
+ "additionalProperties": false,
+ "properties": {
+ "html": {
+ "type": "string"
+ },
+ "markdown": {
+ "type": "string"
+ },
+ "svg": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "svg",
+ "html",
+ "markdown"
+ ],
+ "type": "object"
+ },
+ "breakdown": {
+ "additionalProperties": false,
+ "properties": {
+ "freshness": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "quality": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "reach": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "trust": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "reach",
+ "trust",
+ "quality",
+ "freshness"
+ ],
+ "type": "object"
+ },
+ "checks": {
+ "additionalProperties": false,
+ "properties": {
+ "homepage_ok": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "links_checked": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "links_ok": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "homepage_ok",
+ "links_checked",
+ "links_ok"
+ ],
+ "type": "object"
+ },
+ "domain": {
+ "type": "string"
+ },
+ "history": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "authority": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "checked_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "freshness": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "quality": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "reach": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "trust": {
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "checked_at",
+ "authority",
+ "reach",
+ "trust",
+ "quality",
+ "freshness"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "last_checked": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "lookups": {
+ "type": "integer"
+ },
+ "notifications": {
+ "additionalProperties": false,
+ "properties": {
+ "notify_email": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "recent": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "channel": {
+ "type": "string"
+ },
+ "detail": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "event": {
+ "type": "string"
+ },
+ "ok": {
+ "type": "boolean"
+ },
+ "sent_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "watch_id": {
+ "type": "integer"
+ }
+ },
+ "required": [
+ "event",
+ "channel",
+ "ok",
+ "detail",
+ "sent_at"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "webhook_url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "webhook_url",
+ "notify_email",
+ "recent"
+ ],
+ "type": "object"
+ },
+ "tier": {
+ "enum": [
+ "featured",
+ "listed",
+ "unlisted",
+ "rejected",
+ null
+ ],
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "verified_at": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "domain",
+ "verified_at",
+ "lookups",
+ "tier",
+ "authority",
+ "breakdown",
+ "checks",
+ "last_checked",
+ "badge",
+ "notifications",
+ "history"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": true,
+ "properties": {
+ "detail": {
+ "type": "string"
+ },
+ "domain": {
+ "type": "string"
+ },
+ "error": {
+ "type": "string"
+ },
+ "hint": {
+ "type": "string"
+ },
+ "retry_after_seconds": {
+ "type": "integer"
+ }
+ },
+ "required": [
+ "error"
+ ],
+ "type": "object"
+ }
+ ],
+ "type": "object"
+}Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, idempotentHint and destructiveHint=false, so the safety profile is covered. The description adds a genuine authorization constraint ('Owner only'), which is exactly the kind of context annotations cannot express. It does not mention rate limits or refresh cadence.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two compact sentences with zero filler; the access constraint is front-loaded before the content list. The trailing enumeration is list-like but every item is meaningful for deciding whether to call it.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a read-only, idempotent tool with full schema coverage and an output schema, the definition covers access gating and payload scope sufficiently. An agent knows who can call it and roughly what comes back; only pagination/volume limits are unaddressed.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% and both parameters (domain, api_key) are fully documented in the schema, including the domain format and that the key comes from verify_domain. The description adds no parameter-level detail, so the baseline of 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a concrete resource — per-domain statistics — and enumerates exactly what is returned (lookup counts, score breakdown, notifications, badge embed, 30 snapshots). Combined with 'Owner only,' this separates it from public lookup_domain and directory-wide directory_stats, though it never uses an explicit verb like 'retrieve'.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The 'Owner only' framing implies you invoke this for a domain you own, and the api_key parameter reinforces that. However, no alternative tool is named and there is no explicit when-not-to-use guidance (e.g., use lookup_domain for public data).
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.