# ToolGrade

> ToolGrade is a free MCP server for developer tools. Grade MCP tool definitions for agent-readiness, with an A to F score and fixes. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Website:** https://toolgrade.mike-tusa.workers.dev
- **MCP Registry name:** dev.workers.mike-tusa.toolgrade/toolgrade
- **Categories:** developer tools
- **Listing updated:** 2026-11-16

## About

The checker looks at a server the way an AI agent does: from the tools/list response. You paste the full response, its result or just the tools array, and it returns a 0 to 100 score, a letter grade, a score for each tool, and findings with concrete fixes. It never connects to the server being graded, and submitted definitions are parsed in memory and discarded.

Findings cover missing or weak descriptions, untyped parameters, strings without maxLength, missing required or additionalProperties, absent annotations such as readOnlyHint, bad or duplicate names, and outputSchema and enum problems. It also estimates the token cost of the definitions, using compact-JSON characters divided by four, so the figure is rough.

The same grader is a remote MCP server with one read-only tool, grade_tools, so a coding agent can grade the server it is building. A JSON API is also available.

## Features

- **Agent-readiness score:** Rates tool definitions from 0 to 100 with an A to F grade.
- **Per-tool findings:** Lists specific fixes such as missing types, maxLength and annotations.
- **Token cost estimate:** Estimates how many tokens the definitions will use.
- **JSON API:** POST a tools/list JSON file to the grading endpoint.
- **Optional free key:** A no-signup key raises the limit to about 100 grades a month.

## Good for

- Check an MCP server's tool schemas before publishing
- Let a coding agent grade the server it is building
- Find tools with vague descriptions or untyped parameters
- Estimate how much context your tool list consumes

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http toolgrade https://toolgrade.mike-tusa.workers.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://toolgrade.mike-tusa.workers.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "toolgrade": {
      "url": "https://toolgrade.mike-tusa.workers.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "toolgrade": {
      "serverUrl": "https://toolgrade.mike-tusa.workers.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `grade_tools`: Grades a set of MCP tool definitions and returns a score, grade, findings and token estimate.

## FAQ

### Does it store my tool definitions?

No. They are parsed in memory and discarded when the response is sent.

### Does it contact my server?

No. It only parses what you paste or send.

### What are the rate limits?

About 20 grades per minute per IP from a shared daily pool; a free key gives about 100 a month.

### Is the token count exact?

No. It is an estimate and real counts vary by model and client.

### Is ToolGrade free?

Yes. ToolGrade is free to use.

### How do I add ToolGrade to Claude Code?

Run this command in your terminal: claude mcp add --transport http toolgrade https://toolgrade.mike-tusa.workers.dev/mcp

### What are the best alternatives to ToolGrade?

The closest alternatives to ToolGrade are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/toolgrade
