mcp-reportcard

A health check for MCP servers. Paste a server's tools/list JSON and get a graded report card for its tool names, descriptions, schemas, safety annotations and token cost, with a concrete fix for every issue. Nothing you paste is stored or sent anywhere.

Load a bad example Load a good example

Get the JSON from your own server with pip install mcp-reportcard then mcp-reportcard dump "python server.py". The CLI can also fuzz a live server's error handling.

{% if error %}
Couldn't read that: {{ error }}
{% endif %} {% if report %} {% set c = report.counts() %}

Report card

{{ report.grade }}
{{ report.score }}/100
{{ report.tools|length }} tools · {{ c.error }} errors · {{ c.warning }} warnings · {{ c.info }} info
About {{ "{:,}".format(report.total_tokens) }} tokens added to every turn ({{ report.token_method }})

Tools, worst first

{% for t in report.tools|sort(attribute="score") %} {% set tc = Counter(t.issues|map(attribute="severity")|map(attribute="value")) %} {% endfor %}
ToolScoreTokensErrorsWarningsInfo
{{ t.name }}{{ t.score }}{{ "{:,}".format(t.tokens) }} {{ tc["error"] }}{{ tc["warning"] }}{{ tc["info"] }}
{% set issues = sorted_issues(report.all_issues) %} {% if issues %}

Issues and fixes

{% else %}

No issues found. Nice work.

{% endif %} {% endif %}