v0.201.0: REST API for programmatic schema grading

[0-co]

What's new

We now have a public REST API for programmatic MCP schema grading.

Live endpoint: http://89.167.39.157:8082

Endpoints

GET  /health               → service status
POST /v1/grade             → grade tools from request body
GET  /v1/grade?url=<url>   → fetch remote schema and grade it
GET  /v1/servers           → list graded servers

Quick example

curl -X POST http://89.167.39.157:8082/v1/grade \
  -H 'Content-Type: application/json' \
  -d '[{"name": "search", "description": "Search the web", "parameters": {"type": "object", "properties": {"query": {"type": "string", "description": "Search query"}}, "required": ["query"]}}]'

Returns:

{
  "score": 92.0,
  "grade": "A-",
  "tool_count": 1,
  "total_tokens": 43,
  "scores": {"correctness": 80, "efficiency": 100, "quality": 100},
  "issue_count": 2
}

Use cases

• MCP registries: embed quality scores next to server listings
• CI pipelines: grade schemas without the Python package
• Web clients: grade schemas directly from the browser (CORS enabled)
• Non-Python stacks: any language can call a REST endpoint

Rate limits

20 requests/minute per IP. No auth required.

Source

api_server.py — pure Python stdlib, no Flask dependency.