Skip to content

Context7 Platform -- Up-to-date docs for AI agents

CTX7-2724: Raise the description limit to 500 and explain the review (#3331)

Enes Gules1a0b92c38512
diff --git a/docs/howto/claiming-libraries.mdx b/docs/howto/claiming-libraries.mdx
index 4b0c654f..bfd02be2 100644
--- a/docs/howto/claiming-libraries.mdx
+++ b/docs/howto/claiming-libraries.mdx
@@ -138,9 +138,9 @@ These fields are available for all library types.
| Field | Description | Limits |
| ----------------- | --------------------------------------------------------------------------------------------------------- | ------------------ |
| **Project Title** | Library name shown on Context7 and given to coding agents. Replaces the generated name. | Max 100 characters |
-| **Description** | Brief description of your library's purpose, shown on Context7 and given to coding agents. | Max 200 characters |
+| **Description** | Brief description of your library's purpose, shown on Context7 and given to coding agents. | Max 500 characters |
-Context7 checks a new title or description before it saves it. If the text gives instructions to AI agents instead of describing the library, the save fails with a reason and the current text stays.
+Context7 checks a new title or description before it saves it. If the text gives instructions to AI agents, or is a slogan or promotional offer instead of a description of the library, the save fails with a reason and the current text stays.
### Source Settings
diff --git a/docs/library-owners.mdx b/docs/library-owners.mdx
index 80bcffe5..563b8282 100644
--- a/docs/library-owners.mdx
+++ b/docs/library-owners.mdx
@@ -59,10 +59,12 @@ Here's an example `context7.json` file with all available options:
- **`projectTitle`** (string, max 100 characters): The library name shown on Context7 and given to coding agents. It replaces the generated name.
-- **`description`** (string, max 200 characters): A short description of what your library does, shown on Context7 and given to coding agents. It replaces the generated description.
+- **`description`** (string, max 500 characters): A short description of what your library does, shown on Context7 and given to coding agents. It replaces the generated description.
<Note>
- Context7 checks a new `projectTitle` or `description` before it uses it, and applies the change on the next refresh. Describe the library itself: text that gives instructions to AI agents is not accepted, and the current name and description stay.
+ Context7 checks a new `projectTitle` or `description` before it uses it, and applies the change on the next refresh. Describe what the library is and does: instructions to AI agents, slogans, and promotional offers are not accepted, and the current name and description stay.
+
+ If you remove `projectTitle` or `description` from `context7.json`, the last accepted value stays.
</Note>
- **`branch`** (string): The name of the git branch to parse. If not provided, the default branch will be used.
diff --git a/packages/mcp/schema/context7.json b/packages/mcp/schema/context7.json
index 606c4f21..adcbac4b 100644
--- a/packages/mcp/schema/context7.json
+++ b/packages/mcp/schema/context7.json
@@ -7,16 +7,16 @@
"properties": {
"projectTitle": {
"type": "string",
- "description": "The display name for your project in Context7. This overrides the default repository name.",
+ "description": "The library name shown on Context7 and given to coding agents. It replaces the generated name after Context7 accepts it; if it is not accepted, the current name stays.",
"minLength": 1,
"maxLength": 100,
"examples": ["Upstash Ratelimit", "Next.js", "React Query"]
},
"description": {
"type": "string",
- "description": "A brief description of what your library does. This helps coding agents understand the purpose of your project.",
+ "description": "A brief description of what your library does, shown on Context7 and given to coding agents. It replaces the generated description after Context7 accepts it; if it is not accepted, the current description stays.",
"minLength": 10,
- "maxLength": 200,
+ "maxLength": 500,
"examples": [
"Ratelimiting library based on Upstash Redis",
"The React Framework for Production",