Fix guides · check compat.name_spec

MCP tool names: allowed characters and length

Tool names should be 1–128 characters of A–Z, a–z, 0–9, underscore, hyphen and dot.

2 of 15,341 reachable MCP servers (0%) have this issue today.

Why it matters

Spaces, slashes and other characters break clients that build function names from tool names; some reject the tool outright, so it never reaches the model.

Before

"name": "search docs"   "name": "repo/list"

After

"name": "search_docs"   "name": "repo_list"

Check your server

Paste your endpoint at /check, or run it in CI:

pipx run glimind check https://your-server.example.com/mcp --min-grade B

Related

Feedback
Help us improve