diff --git a/docs/modelcontextprotocol-io/quickstart.mdx b/docs/modelcontextprotocol-io/quickstart.mdx
index 69886898e..83ee6a115 100644
--- a/docs/modelcontextprotocol-io/quickstart.mdx
+++ b/docs/modelcontextprotocol-io/quickstart.mdx
@@ -185,6 +185,10 @@ Open the generated `server.json` file, and you should see contents like:
 }
 ```
 
+<Note>
+  Free-form text fields are validated at publish time. In the current schema, `description` and `title` are limited to 100 characters each, `name` to 200, and version strings to 255. A longer value causes `mcp-publisher publish` to fail with a schema validation error.
+</Note>
+
 Edit the contents as necessary:
 
 ```diff server.json