ToolGrade

为智能体就绪性评估MCP工具定义。粘贴tools/list JSON或工具数组,即可获得0-100分评分、A-F等级、带具体修复建议的规则发现结果,以及预估token成本。纯解析处理:绝不抓取URL或存储您的工具定义。提供免费层级。

托管 MCP 服务器

npx add-mcp 'https://toolgrade.mike-tusa.workers.dev/mcp'

可安装到 Claude Code、Codex、Cursor 等客户端

文档

ToolGrade

Grade your MCP server's tool definitions the way an AI agent sees them. Paste the JSON from a tools/list call (the full response, its result, or just the array of tools). ToolGrade returns a 0-100 agent-readiness score, an A-F grade, a score per tool, and findings with concrete fixes: missing or weak descriptions, untyped parameters, strings without maxLength, missing required / additionalProperties, missing annotations such as readOnlyHint, bad or duplicate names, outputSchema and enum problems. It also gives an estimated token cost of the definitions. It only parses what you paste: it never connects to your server, and your tool definitions are never stored.

JSON API

curl -s -X POST 'https://toolgrade.mike-tusa.workers.dev/api/grade' \
  -H 'content-type: application/json' --data-binary @tools-list.json

No key needed: about 20 grades per minute per IP from a shared daily pool. Token figures are estimates (Estimate only: compact-JSON characters divided by 4. Real token counts vary by model, tokenizer and how each client serializes tool definitions.) OpenAPI 3.1 spec

Free API key

No sign-up and no email. A key gives you about 100 grades per month of your own, outside the shared pool. Send it as Authorization: Bearer <key> or X-Api-Key: <key> (MCP clients: add it as a header). The key is shown once; we keep only a hash of it, so it can't be recovered.

Get a free key

For AI agents (MCP)

ToolGrade is also a remote Model Context Protocol (MCP) server with one read-only tool, grade_tools, so a coding agent can grade the server it is building. Useful for anyone building MCP servers for AI agents and assistants, for example Muse, Claude, ChatGPT or Cursor. Most MCP clients accept this config; some use a different format (for example, VS Code uses a servers key). Clients with a settings screen just need the URL https://toolgrade.mike-tusa.workers.dev/mcp.

{ "mcpServers": { "toolgrade": { "type": "http", "url": "https://toolgrade.mike-tusa.workers.dev/mcp" } } }

With a free key, add "headers": { "Authorization": "Bearer <key>" } to the server entry (exact field name depends on the client). Machine-readable docs: llms.txt · OpenAPI 3.1 spec · MCP server card. Checks follow the MCP tools specification plus common client limits. ToolGrade is not affiliated with Meta, Anthropic, OpenAI, Cursor or any other AI or MCP client vendor, and is not endorsed or sponsored by them.