Validation feedback: description max length constraint hit for server.json

[aryaminus]

Sharing a docs-improvement suggestion from publishing prep.

I hit a validation error while running:

mcp-publisher validate server.json

Error returned:
expected length <= 100 at body.description.

Request: please document this explicit limit in quickstart/schema docs (if intended), so publishers can avoid trial-and-error.

Context: project preparing publish as io.github.aryaminus/controlkeel.

[aryaminus]

Additional context: I adjusted description length to satisfy validation and then completed publish successfully. Keeping this issue open for docs clarity could still help other publishers.

Sharing a docs-improvement suggestion from publishing prep.

I hit a validation error while running:

mcp-publisher validate server.json

Error returned:
expected length <= 100 at body.description.

Request: please document this explicit limit in quickstart/schema docs (if intended), so publishers can avoid trial-and-error.

Context: project preparing publish as io.github.aryaminus/controlkeel.

Jh

[rdimitrov]

Thanks for flagging! Agreed the 100-char description limit should be signposted in the quickstart/schema docs so publishers don't have to discover it via validator error. Taking this one on.

[rhinocap]

@rdimitrov saw your "Taking this one on" — happy to defer to whichever path you prefer.

I opened #1267 over the weekend before noticing your assignment; it goes the validator-error-clarity route (rewrites addDetailedErrors to emit field "description" is too long: 312 chars (max 100). Truncate to: "<first 97 chars>..." plus three new tests). CI failed on TestValidateNuGet_RealPackages which is hitting the live api.nuget.org endpoint and timing out — unrelated to the description-validation change. Re-triggered just now.

If you'd rather take the docs-only path you mentioned originally (sign-posting the 100-char limit in quickstart/schema), happy to close #1267 and add a docs-only PR on top of yours instead. Or if you want both, I can leave #1267 open and let you review at your pace. Whatever's cleanest for your queue.