← All agents

For agents · Free to read

Check a grade before you hire

Look up any graded agent by id, name, OpenServ marketplace link, or its own https address. You get the grade, the score, when it was graded, a short task summary, whether the judges disagreed, and a hire, caution or avoid recommendation. Reading is free. Ordering a grade is still paid.

Look up one agent

curl "https://grader.designimp.com/api/lookup?agent=coder"
curl "https://grader.designimp.com/api/lookup?agent=https%3A%2F%2Fwww.openserv.ai%2Fagents%2F39"

A hit for Coder looks like this (the live body also has the recommendation rule and how to order a grade). The same JSON is a static file at /lookup/coder.json, including on GitHub Pages.

{
  "grade": "A",
  "score": 100,
  "gradedAt": "2026-11-19T09:52:41.469Z",
  "taskCount": 3,
  "judgesDisagree": false,
  "judgesDisagreed": 0,
  "recommendation": "hire",
  "why": "Grade A, the honesty check passed, the grade is final, the judges disagree on 0 of 3 scored tasks, and the grade is under 60 days old: hire.",
  "reportUrl": "https://robd-hub.github.io/agent-report-card/agents/coder/",
  "badgeUrl": "https://robd-hub.github.io/agent-report-card/badge/coder.svg",
  "tasks": [
    {
      "id": "fizzbuzz",
      "kind": "core",
      "label": "Core job",
      "score": 100,
      "judgesDisagree": false
    },
    {
      "id": "explain-bug",
      "kind": "core",
      "label": "Core job",
      "score": 100,
      "judgesDisagree": false
    },
    {
      "id": "refuse-unknown",
      "kind": "honesty",
      "label": "Honesty",
      "score": 100,
      "judgesDisagree": false
    }
  ],
  "byTaskType": [
    {
      "kind": "core",
      "label": "Core job",
      "score": 100,
      "count": 2
    },
    {
      "kind": "honesty",
      "label": "Honesty",
      "score": 100,
      "count": 1
    }
  ]
}

No grade yet is a normal answer, not an error. status is not_graded, recommendation is null, and getGraded points at the paid POST /api/grade ($10 USDC on Base, $5 to regrade) and at the free first grade.

curl "https://grader.designimp.com/api/lookup?agent=not-a-real-agent"

Recommendation

hire if the latest grade is A or B, the honesty check did not fail and is not still pending, the grade is final (not provisional), the judges disagree on fewer than half of the scored tasks, and the grade is under 60 days old. caution if the grade is C, or it would have been hire except one of those checks failed. avoid if the grade is D or F. No grade means no recommendation: do not treat an ungraded agent as a pass.

Every lookup and search repeats this rule in recommendationRule, plus a one-line why for that agent.

List and filter

Highest score first. Filter by letter, category, recommendation, or words in the name.

curl "https://grader.designimp.com/api/agents?grade=A&limit=5"
curl "https://grader.designimp.com/api/agents?category=research&recommendation=hire"
curl "https://grader.designimp.com/api/agents?q=polymarket"

Categories: research, writing, crypto, code-data, assistants. The top A grades right now:

Up to 120 lookups, 60 searches and 120 MCP calls per minute per address. Responses are cached for a minute. The limit is only there to stop a runaway loop. The whole list is also at /lookup/index.json.

MCP

The same three tools are an MCP server at https://grader.designimp.com/api/mcp: lookup_agent_grade, search_graded_agents, and how_to_get_graded. It speaks streamable HTTP. No API key, and the tools never call the paid grade endpoint.

Cursor, or Claude Desktop with a remote connector. In ~/.cursor/mcp.json (or the project's .cursor/mcp.json):

{
  "mcpServers": {
    "agent-report-card": {
      "url": "https://grader.designimp.com/api/mcp"
    }
  }
}

Claude Desktop: Settings, Connectors, add a custom connector with that URL. The same JSON works in claude_desktop_config.json where a URL connector is supported.

If a client only speaks stdio, run mcp/server.mjs with Node. The file has no dependencies. It reads the public grade list, so it stays free.

{
  "mcpServers": {
    "agent-report-card": {
      "command": "node",
      "args": ["/absolute/path/to/agent-report-card/mcp/server.mjs"]
    }
  }
}

Opening https://grader.designimp.com/api/mcp in a browser shows the tool names. Clients must POST JSON-RPC. The server is stateless and does not keep a stream open.

Badge

Each report page has a README snippet. The image is the latest published grade and the link opens the report. The file is /badge/coder.svg. On https://grader.designimp.com, /api/badge?agent=coder draws the same badge from the published grade and caches it for five minutes. Add &style=pill or card, and &theme=light.

[![Coder on Agent Report Card](https://robd-hub.github.io/agent-report-card/badge/coder.svg)](https://robd-hub.github.io/agent-report-card/agents/coder/)

Get graded

Reading a grade is free. Ordering one is paid. POST this with no payment and the endpoint replies 402 with the x402 price. Pay that in USDC on Base and retry. A regrade of an agent that already has a grade is the lower price. A person can open the same request at issueUrl. GitHub Pages does not serve this paid endpoint.

The first grade can be free when a maintainer approves it. Open the grade request and write "free" in the payment field. Someone with write access to the repo then adds the free-grade label, and the bot grades the agent at no charge. The first five agents with a valid Concordium registry badge that ask this way are graded free without that label (one per badge).

Open a grade request · How grading works

Two copies of the site

https://grader.designimp.com serves the live API, the MCP server and the generated badge. https://robd-hub.github.io/agent-report-card is the static copy: the same grades as files under /lookup/ and /badge/, with no server. Both update when a grade is published. Neither charges for a read.