API · MCP · Schema v1.0

Query a domain's participation state.

The same structural signal that powers the audit — reachability, legibility, authority, and the derived participation state — callable over REST and MCP. Bands only. No fabricated scores.

Authentication

Get an API key

Sign in to generate an API key. Your tier and monthly limit follow your plan.

Sign in to get a key →

Pass it as a bearer token: Authorization: Bearer ak_live_…

REST

Classify a domain

curl https://aater.ai/api/v1/classify/stripe.com \ -H "Authorization: Bearer ak_live_…"

Response — schema-locked v1.0:

{ "schema_version": "1.0", "domain": "stripe.com", "participation_state": "authoritative", "reachability": "pass", "legibility": "structured", "authority": "strong", "primary_constraint": null, "classified_at": "2026-06-02T12:00:00Z", "report_url": "https://aater.ai/score/stripe.com" }

participation_state is one of absent · marginal · capturable · emerging · authoritative. Results are cached aggressively; a fresh audit runs only when a domain has never been classified.

Limits

Rate limits

Tier
Plan
Monthly
Burst
Free
Classify
25 requests
60 / min
Observe
Observe
500 requests
60 / min
Certify
Certify
1,500 requests
60 / min

Exceeding the monthly quota returns 429 quota_exceeded.X-RateLimit-Remaining is returned on every call.

MCP

For AI agents

Agents can query participation state before they cite, recommend, or extract from a domain. Add the server to any MCP-compatible client:

{ "mcpServers": { "aater-ai": { "url": "https://aater.ai/api/mcp" } } }

Tools: classify_domain · get_participation_state · install_pulse · get_agent_participation · get_url_heatmap.