ToolGrade MCP server
Commit Oct 18, 2026Evaluates MCP tool definitions for agent-readiness by providing scores, letter grades, suggested fixes, and estimated token costs.
Also known as miketusa-ctrl/toolgrade
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Oct 18, 2026
- License
- MIT
What is ToolGrade MCP?
ToolGrade evaluates MCP tool definitions for agent-readiness by providing scores, letter grades, suggested fixes, and estimated token costs.
Summary generated from the project's README
About ToolGrade MCP server
Developers building agentic workflows can use ToolGrade to assess how well their Model Context Protocol tool definitions are prepared for AI consumption. By utilizing the grade_tools function, the server evaluates definitions to provide numerical scores, letter grades from A to F, specific suggestions for fixes, and estimates for token costs. This helps ensure that tools are optimized for reliability when used by autonomous agents.
This is a remote MCP server that connects via Streamable HTTP. It is compatible with Cursor and Windsurf using standard HTTP configurations, while Cline requires the streamableHttp type. Claude Desktop users can connect by adding the custom connector URL or by using the mcp-remote bridge for clients that only support local stdio servers. The service is available through a web app and API, offering a free plan for users to test their tool readiness.
What you can do with it
- 1Assess tool qualityAsk the AI to evaluate a specific tool definition to see if it receives a passing letter grade.
- 2Optimize token usageRequest an estimation of the token costs associated with a particular tool definition.
- 3Improve tool definitionsIdentify specific errors in a tool schema by requesting suggested fixes from the agent.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 16, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablemiketusa-ctrl/toolgrade is public and reachablegithub.com/miketusa-ctrl/toolgrade ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-18github.com/miketusa-ctrl/toolgrade ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubToolGrade
Grade MCP tool definitions for agent-readiness: score, A-F grade, fixes, est. token cost.
Live service
- Web app and API: https://toolgrade.mike-tusa.workers.dev/
- Plans: Free, no paid plan (https://toolgrade.mike-tusa.workers.dev/)
- Support: digitalpromohub.support@gmail.com
Use it from an AI assistant (MCP)
ToolGrade is a remote MCP server (Streamable HTTP) at https://toolgrade.mike-tusa.workers.dev/mcp. Tools: grade_tools.
Cursor and Windsurf accept this config:
{
"mcpServers": {
"toolgrade": {
"type": "http",
"url": "https://toolgrade.mike-tusa.workers.dev/mcp"
}
}
}
Cline (MCP Servers > Remote Servers, or cline_mcp_settings.json) needs "type": "streamableHttp":
{
"mcpServers": {
"toolgrade": {
"type": "streamableHttp",
"url": "https://toolgrade.mike-tusa.workers.dev/mcp"
}
}
}
Claude Desktop: open Settings > Connectors, choose "Add custom connector" and paste https://toolgrade.mike-tusa.workers.dev/mcp. Or, for clients that only support local (stdio) servers, use the mcp-remote bridge: npx mcp-remote https://toolgrade.mike-tusa.workers.dev/mcp.
VS Code uses a servers key instead of mcpServers.
The server.json file is the MCP Registry manifest for this server.
Run your own copy
Requires Node.js 22+ and a Cloudflare account.
npm install
npx wrangler@4 dev # local dev server
wrangler.toml is a template: create your own KV namespaces / D1 databases / rate-limit namespaces and replace the <PLACEHOLDER> values before npx wrangler@4 deploy. Any secrets the Worker reads go in wrangler secret put (or .dev.vars locally), never in the repo.
Optional Worker secrets (leave unset if you do not need them): GLAMA_CLAIM (your glama.ai connector claim token, served at /.well-known/glama.json).
License
MIT (c) Digital Promo Hub. See LICENSE.
ToolGrade MCP questions
How do I use ToolGrade with Cline?
Cline requires the server type to be set to 'streamableHttp' in your configuration.
What are the requirements to run my own copy of ToolGrade?
To run your own instance, you need Node.js version 22 or higher and a Cloudflare account.
Does ToolGrade have any paid plans?
No, ToolGrade only offers a free plan.