DEV Community

HM Cheng
HM Cheng

Posted on

How to Take Your MCP Server from Grade C to Grade B

#mcp #ai #tutorial #opensource

Your MCP server works. But does anyone know it exists?

We scored 39,762 MCP servers. 54% scored Grade C — solid code quality, zero community adoption. They're invisible to the AI agents that need them.

Here's how to go from invisible to discovered.

What Your Grade Actually Means

Our scoring uses an additive model:

Composite Grade = Quality Score (0-100)
                + Community Bonus (0-60)
                + Trust Bonus (0-30)
Enter fullscreen mode Exit fullscreen mode
Grade Score What it means
B+ 86+ Very good — close to elite
B 76-85 Good — your target
C+ 66-75 OK — getting there
C 46-65 Average — this is 54% of all tools
D 21-45 Needs work
F 0-20 Critical

If you're at C, you're not failing. You just haven't been discovered yet.

Step 1: Fix Your Quality Score (Quick Wins)

Quality Score is 5 dimensions. Here are the fastest fixes:

Token Efficiency (25%)

Every token in your tool definition counts against the agent's context window.

  • Bad: 500+ tokens
  • OK: 200-350 tokens
  • Good: 100-200 tokens
  • Elite: ≤50 tokens

Fix: Cut redundant parameters. Shorten descriptions. Use concise naming. Most tools can save 40-80 tokens in 15 minutes.

Schema Correctness (25%)

Agents need machine-readable schemas.

Fix: Add a type field. Define properties. Include required fields. A well-structured schema can add 30+ points to your quality score instantly.

Description Quality (20%)

Write for AI agents AND humans. AI agents need clarity. Humans need to understand what your tool does at a glance. A good description serves both.

❌ Bad (confuses everyone):
   "PDF tool"

✅ Good (clear to both agents and humans):
   "Extracts text and tables from PDF files. Supports multi-page documents.
    Returns structured JSON with page numbers."

✅ Better (humans can instantly understand, agents can parse):
   "Extracts text and tables from PDF files. Example: extract_tables('report.pdf')
    → [{page: 1, rows: [[...]]}]. Supports multi-page documents."
Enter fullscreen mode Exit fullscreen mode

A human scanning GitHub repos decides in 3 seconds whether to try your tool. An AI agent scanning tool definitions decides in 3 milliseconds. Serve both.

Step 2: Get Discovered (Community Bonus)

This is where most C-grade tools fall short.

Stars Bonus How to get them
1-9 +3 Share on MCP Discord, Reddit r/MCP, dev.to
10-49 +6 Write a blog post about your tool
50-99 +10 Get listed on MCP.so, PulseMCP, Smithery
100-499 +14 Present at a meetup, get featured in a newsletter
500+ +18 Become a known name in the MCP ecosystem

The jump from 0 to 10 stars gives you +3 Community Bonus — often enough to push from C to B.

Activity Bonus

Push updates at least every 30 days. An active repository earns up to 20 bonus points. An abandoned one gets 0.

Step 3: Let Your Badge Do the Work

Embed your grade badge on your README:

[![Grade](https://agent-tool-intel-production.up.railway.app/badge/YOUR_ORG%2FYOUR_REPO)](https://agent-tool-intel-production.up.railway.app)
Enter fullscreen mode Exit fullscreen mode

Every visitor to your repo sees your grade. If it's a B, they trust your tool more. If it's a C, they know you're solid but undiscovered. Either way, the badge brings traffic back to the platform — where other builders discover it.

One Builder's Path

We saw one tool go from Grade C (54 points, 0 stars, 2-week-old repo) to Grade B (78 points, 12 stars, active) in 4 days:

  1. Day 1: Fixed schema — Quality jumped from 55 to 72
  2. Day 2: Shared on MCP Discord — got 5 stars
  3. Day 3: Wrote a dev.to post about the tool — got 7 more stars
  4. Day 4: Grade updated to B

12 stars. 4 days. One grade jump. No magic.

Check Your Grade Now

https://agent-tool-intel-production.up.railway.app

Paste your GitHub repo URL. See your score. Start improving.

Agent Tool Intelligence is open source (MIT). GitHub · Methodology

Tags: #mcp #ai #agents #opensource #tutorial

Top comments (0)