Merge pull request modelcontextprotocol#1634 from modelcontextprotocol/docs/add-pagination-resource-templates

maxisbey · web-flow · commit 819c89c6821e · 2026-01-27T04:23:36.000Z
docs: add pagination support to resource templates listing
diff --git a/docs/specification/2024-11-05/server/resources.mdx b/docs/specification/2024-11-05/server/resources.mdx
@@ -163,14 +163,19 @@ To retrieve resource contents, clients send a `resources/read` request:
 Resource templates allow servers to expose parameterized resources using
 [URI templates](https://datatracker.ietf.org/doc/html/rfc6570). Arguments may be
 auto-completed through [the completion API](/specification/2024-11-05/server/utilities/completion).
+This operation supports
+[pagination](/specification/2024-11-05/server/utilities/pagination).
 
 **Request:**
 
 ```json
 {
   "jsonrpc": "2.0",
   "id": 3,
-  "method": "resources/templates/list"
+  "method": "resources/templates/list",
+  "params": {
+    "cursor": "optional-cursor-value"
+  }
 }
 ```
 
@@ -188,7 +193,8 @@ auto-completed through [the completion API](/specification/2024-11-05/server/uti
         "description": "Access files in the project directory",
         "mimeType": "application/octet-stream"
       }
-    ]
+    ],
+    "nextCursor": "next-page-cursor"
   }
 }
 ```
diff --git a/docs/specification/2025-03-26/server/resources.mdx b/docs/specification/2025-03-26/server/resources.mdx
@@ -160,14 +160,18 @@ To retrieve resource contents, clients send a `resources/read` request:
 Resource templates allow servers to expose parameterized resources using
 [URI templates](https://datatracker.ietf.org/doc/html/rfc6570). Arguments may be
 auto-completed through [the completion API](/specification/2025-03-26/server/utilities/completion).
+This operation supports [pagination](/specification/2025-03-26/server/utilities/pagination).
 
 **Request:**
 
 ```json
 {
   "jsonrpc": "2.0",
   "id": 3,
-  "method": "resources/templates/list"
+  "method": "resources/templates/list",
+  "params": {
+    "cursor": "optional-cursor-value"
+  }
 }
 ```
 
@@ -185,7 +189,8 @@ auto-completed through [the completion API](/specification/2025-03-26/server/uti
         "description": "Access files in the project directory",
         "mimeType": "application/octet-stream"
       }
-    ]
+    ],
+    "nextCursor": "next-page-cursor"
   }
 }
 ```
diff --git a/docs/specification/2025-06-18/server/resources.mdx b/docs/specification/2025-06-18/server/resources.mdx
@@ -163,14 +163,18 @@ To retrieve resource contents, clients send a `resources/read` request:
 Resource templates allow servers to expose parameterized resources using
 [URI templates](https://datatracker.ietf.org/doc/html/rfc6570). Arguments may be
 auto-completed through [the completion API](/specification/2025-06-18/server/utilities/completion).
+This operation supports [pagination](/specification/2025-06-18/server/utilities/pagination).
 
 **Request:**
 
 ```json
 {
   "jsonrpc": "2.0",
   "id": 3,
-  "method": "resources/templates/list"
+  "method": "resources/templates/list",
+  "params": {
+    "cursor": "optional-cursor-value"
+  }
 }
 ```
 
@@ -189,7 +193,8 @@ auto-completed through [the completion API](/specification/2025-06-18/server/uti
         "description": "Access files in the project directory",
         "mimeType": "application/octet-stream"
       }
-    ]
+    ],
+    "nextCursor": "next-page-cursor"
   }
 }
 ```
diff --git a/docs/specification/draft/server/resources.mdx b/docs/specification/draft/server/resources.mdx
@@ -172,14 +172,18 @@ Alternatively, if the scheme of `uri` is `https://`, clients may fetch the resou
 Resource templates allow servers to expose parameterized resources using
 [URI templates](https://datatracker.ietf.org/doc/html/rfc6570). Arguments may be
 auto-completed through [the completion API](/specification/draft/server/utilities/completion).
+This operation supports [pagination](/specification/draft/server/utilities/pagination).
 
 **Request:**
 
 ```json
 {
   "jsonrpc": "2.0",
   "id": 3,
-  "method": "resources/templates/list"
+  "method": "resources/templates/list",
+  "params": {
+    "cursor": "optional-cursor-value"
+  }
 }
 ```
 
@@ -205,7 +209,8 @@ auto-completed through [the completion API](/specification/draft/server/utilitie
           }
         ]
       }
-    ]
+    ],
+    "nextCursor": "next-page-cursor"
   }
 }
 ```

Original file line number	Diff line number	Diff line change
@@ -163,14 +163,19 @@ To retrieve resource contents, clients send a `resources/read` request:
`163`	`163`	`Resource templates allow servers to expose parameterized resources using`
`164`	`164`	`[URI templates](https://datatracker.ietf.org/doc/html/rfc6570). Arguments may be`
`165`	`165`	`auto-completed through [the completion API](/specification/2024-11-05/server/utilities/completion).`
	`166`	`+This operation supports`
	`167`	`+[pagination](/specification/2024-11-05/server/utilities/pagination).`
`166`	`168`
`167`	`169`	`Request:`
`168`	`170`
`169`	`171`	```json
`170`	`172`	`{`
`171`	`173`	`"jsonrpc": "2.0",`
`172`	`174`	`"id": 3,`
`173`		`- "method": "resources/templates/list"`
	`175`	`+ "method": "resources/templates/list",`
	`176`	`+ "params": {`
	`177`	`+ "cursor": "optional-cursor-value"`
	`178`	`+ }`
`174`	`179`	`}`
`175`	`180`	```
`176`	`181`
`@@ -188,7 +193,8 @@ auto-completed through [the completion API](/specification/2024-11-05/server/uti`
`188`	`193`	`"description": "Access files in the project directory",`
`189`	`194`	`"mimeType": "application/octet-stream"`
`190`	`195`	`}`
`191`		`- ]`
	`196`	`+ ],`
	`197`	`+ "nextCursor": "next-page-cursor"`
`192`	`198`	`}`
`193`	`199`	`}`
`194`	`200`	```
Original file line number	Diff line number	Diff line change
@@ -160,14 +160,18 @@ To retrieve resource contents, clients send a `resources/read` request:
`160`	`160`	`Resource templates allow servers to expose parameterized resources using`
`161`	`161`	`[URI templates](https://datatracker.ietf.org/doc/html/rfc6570). Arguments may be`
`162`	`162`	`auto-completed through [the completion API](/specification/2025-03-26/server/utilities/completion).`
	`163`	`+This operation supports [pagination](/specification/2025-03-26/server/utilities/pagination).`
`163`	`164`
`164`	`165`	`Request:`
`165`	`166`
`166`	`167`	```json
`167`	`168`	`{`
`168`	`169`	`"jsonrpc": "2.0",`
`169`	`170`	`"id": 3,`
`170`		`- "method": "resources/templates/list"`
	`171`	`+ "method": "resources/templates/list",`
	`172`	`+ "params": {`
	`173`	`+ "cursor": "optional-cursor-value"`
	`174`	`+ }`
`171`	`175`	`}`
`172`	`176`	```
`173`	`177`
`@@ -185,7 +189,8 @@ auto-completed through [the completion API](/specification/2025-03-26/server/uti`
`185`	`189`	`"description": "Access files in the project directory",`
`186`	`190`	`"mimeType": "application/octet-stream"`
`187`	`191`	`}`
`188`		`- ]`
	`192`	`+ ],`
	`193`	`+ "nextCursor": "next-page-cursor"`
`189`	`194`	`}`
`190`	`195`	`}`
`191`	`196`	```
Original file line number	Diff line number	Diff line change
@@ -163,14 +163,18 @@ To retrieve resource contents, clients send a `resources/read` request:
`163`	`163`	`Resource templates allow servers to expose parameterized resources using`
`164`	`164`	`[URI templates](https://datatracker.ietf.org/doc/html/rfc6570). Arguments may be`
`165`	`165`	`auto-completed through [the completion API](/specification/2025-06-18/server/utilities/completion).`
	`166`	`+This operation supports [pagination](/specification/2025-06-18/server/utilities/pagination).`
`166`	`167`
`167`	`168`	`Request:`
`168`	`169`
`169`	`170`	```json
`170`	`171`	`{`
`171`	`172`	`"jsonrpc": "2.0",`
`172`	`173`	`"id": 3,`
`173`		`- "method": "resources/templates/list"`
	`174`	`+ "method": "resources/templates/list",`
	`175`	`+ "params": {`
	`176`	`+ "cursor": "optional-cursor-value"`
	`177`	`+ }`
`174`	`178`	`}`
`175`	`179`	```
`176`	`180`
`@@ -189,7 +193,8 @@ auto-completed through [the completion API](/specification/2025-06-18/server/uti`
`189`	`193`	`"description": "Access files in the project directory",`
`190`	`194`	`"mimeType": "application/octet-stream"`
`191`	`195`	`}`
`192`		`- ]`
	`196`	`+ ],`
	`197`	`+ "nextCursor": "next-page-cursor"`
`193`	`198`	`}`
`194`	`199`	`}`
`195`	`200`	```
Original file line number	Diff line number	Diff line change
@@ -172,14 +172,18 @@ Alternatively, if the scheme of `uri` is `https://`, clients may fetch the resou
`172`	`172`	`Resource templates allow servers to expose parameterized resources using`
`173`	`173`	`[URI templates](https://datatracker.ietf.org/doc/html/rfc6570). Arguments may be`
`174`	`174`	`auto-completed through [the completion API](/specification/draft/server/utilities/completion).`
	`175`	`+This operation supports [pagination](/specification/draft/server/utilities/pagination).`
`175`	`176`
`176`	`177`	`Request:`
`177`	`178`
`178`	`179`	```json
`179`	`180`	`{`
`180`	`181`	`"jsonrpc": "2.0",`
`181`	`182`	`"id": 3,`
`182`		`- "method": "resources/templates/list"`
	`183`	`+ "method": "resources/templates/list",`
	`184`	`+ "params": {`
	`185`	`+ "cursor": "optional-cursor-value"`
	`186`	`+ }`
`183`	`187`	`}`
`184`	`188`	```
`185`	`189`
`@@ -205,7 +209,8 @@ auto-completed through [the completion API](/specification/draft/server/utilitie`
`205`	`209`	`}`
`206`	`210`	`]`
`207`	`211`	`}`
`208`		`- ]`
	`212`	`+ ],`
	`213`	`+ "nextCursor": "next-page-cursor"`
`209`	`214`	`}`
`210`	`215`	`}`
`211`	`216`	```