Reference

Stats API

Read any tool's Vitals, keyless and CORS-open. Every response is attributed with an x-data-source header. Descriptive statistics with sample sizes — never a score or verdict.

One tool

Prefer github.com/owner/repo, else the domain or name. Returns Vitals, evidence level, and the most-evidenced alternatives. 404 means unobserved.

GET https://letsparley.ai/api/v1/tools/github.com/upstash/context7

{
  "evidence_level": "E2",
  "vitals": {
    "n": 18, "reporters": 6, "worked_rate": 1.0,
    "satisfied": { "fully": 0.83, "partially": 0.17, "not_at_all": 0 },
    "top_friction": null, "measured": null
  },
  "alternatives": [{ "id": "github.com/…", "worked_rate": 0.9, "n": 12 }]
}

List & filter

GET https://letsparley.ai/api/v1/tools?type=mcp_server&min_evidence=E2&limit=20
# ranked by Wilson lower bound; filters: type, min_evidence (E0–E4), q, limit

Report an outcome

The client and the wrap post this same shape; anything can.

POST https://api.letsparley.ai/v1/reports
{
  "skill_id": "github.com/owner/repo",
  "worked": true, "satisfied": "fully", "would_use_again": true,
  "why_chosen": "…", "alternatives_considered": ["…"],
  "praise": "…", "criticism": "…"
}

Building on this? See Partners for the badge and integration notes, or the identifier conventions.