Registry / developers

Public API

The whole registry is available as JSON — no authentication, no key, read-only. Build directories, recommendations, or agent skills on top of it. If you ship something, a star and a link back to the registry is appreciated but not required.

GET/api/agents

The full directory with rating summaries, ordered by stars.

curl "https://your-host/api/agents?q=protein&category=chem-drug&limit=20"

Parameter	Type	Effect
q	string	Substring match over name, repo, description and tags.
category	string	Category slug (see the response meta or /agents).
status	string	active · stale · stable · archived · gone · no-repo.
limit	int	Cap results, 1–500 (default 500).

GET/api/agents/{slug}

One agent by slug: record fields, provenance, and its rating summary.

curl "https://your-host/api/agents/agentlaboratory"

GET/api/agents/{slug}/reviews

Public reviews for one agent, newest first, with reviewer identity and vote counts.

curl "https://your-host/api/agents/agentlaboratory/reviews"

POST/api/agents/{slug}/reviews

Submit a review (general or verified-run). Requires GitHub sign-in; verified-run submissions must carry an evidence URL and five ratings. See the review policy.

Response shape

{
  "meta": {
    "total_agents": 168, "returned": 20, "total_reviews": 12,
    "api_version": "1.1", "docs": "/developers"
  },
  "agents": [
    {
      "slug": "agentlaboratory",
      "name": "AgentLaboratory",
      "repo": "SamuelSchmidgall/AgentLaboratory",
      "category": "autonomous-research",
      "stars": 5846,
      "pushed_at": "2025-08-20T21:46:43.000Z",
      "status": "stale",
      "retired_reason": null, "retired_stars": null,
      "paper_meta": { "venue": "Findings of EMNLP 2025", "year": "2025.06" },
      "reviews": 2,
      "rating": { "count": 2, "overall": 4.0, "usefulness": 4.5, "...": "..." }
    }
  ]
}

For LLMs and coding agents

The registry also publishes /llms.txt — a plain-text index of every agent, grouped by category, following the llms.txt convention. It is the cheapest way to give a model the whole directory in one request. Ready-made skills that wrap this API (search, recommend, compare) ship in the repository under skills/.

Read-only and CORS-enabled (GET). No rate limiting is applied today; cache responses on your side. Fields may gain new keys, existing keys keep their meaning.