llms.txt Content
# Chiark
> Cross-protocol quality index for AI agent services. Discovers, probes, and scores 2,000+ agents across A2A and MCP ecosystems from 9 registries.
Chiark measures the operational reliability of deployed AI agent endpoints — availability, protocol conformance, and performance — through automated three-tier probing every 30 minutes. It is the independent quality layer for agent-to-agent routing.
Live at https://chiark.ai
## API
The REST API is at `https://chiark.ai/api/v1`. All responses are JSON. No authentication required.
- [API Documentation](https://chiark.ai/docs): Interactive OpenAPI/Swagger docs
- [OpenAPI Spec](https://chiark.ai/openapi.json): Machine-readable API schema
- [Full API Reference](https://chiark.ai/llms-full.txt): Complete endpoint documentation
### Discover Agents (recommended for routing)
Find agents matching quality constraints, optionally filtered by task description:
```
GET /api/v1/discover?task=web+scraping&min_uptime=0.9&protocol=mcp&page_size=3
GET /api/v1/discover?min_score=80&protocol=mcp (constraint-only, no task required)
GET /api/v1/discover?payment_enabled=true (all payment-enabled agents)
```
Response:
```json
{
"agents": [
{
"id": "uuid",
"name": "Agent Name",
"operational_score": 87,
"max_score": 100,
"uptime_30d": 0.99,
"p95_latency_ms": 245,
"conformance": "pass",
"protocol": "mcp",
"endpoint_url": "https://...",
"categories": ["Developer Tools"]
}
],
"total": 42
}
```
### Check Agent Status
```
GET /api/v1/agents/{id}/status
```
Response:
```json
{
"agent_id": "uuid",
"status": "operational",
"is_alive": true,
"http_status": 200,
"response_time_ms": 145.2,
"tls_valid": true,
"probe_tier": 3,
"timestamp": "2026-03-26T12:00:00Z"
}
```
Status values: `operational`, `degraded`, `reachable`, `offline`, `auth_required`, `unknown`
### Get Agent Capabilities
```
GET /api/v1/agents/{id}/capab
OpenAPI Spec (preview)
{"openapi":"3.1.0","info":{"title":"Chiark API","description":"Quality & routing index for AI agent services. Find reliable agents, check real-time status, and get quality-aware routing recommendations across A2A and MCP ecosystems.","version":"1.0.0"},"paths":{"/api/v1/agents":{"get":{"tags":["agents"],"summary":"List Agents","description":"List all tracked agents with their latest scores.","operationId":"list_agents_api_v1_agents_get","parameters":[{"name":"limit","in":"query","required":false