Skip to content

Commit 3b9aa40

Browse files
committed
Add note: URL elictation is new and may change
1 parent 4fde1d2 commit 3b9aa40

File tree

1 file changed

+15
-9
lines changed

1 file changed

+15
-9
lines changed

docs/specification/draft/client/elicitation.mdx

Lines changed: 15 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -322,18 +322,14 @@ Note that complex nested structures, arrays of objects (beyond enums), and other
322322

323323
### URL Mode Elicitation Requests
324324

325-
URL mode elicitation enables servers to direct users to external URLs for out-of-band interactions that must not pass through the MCP client. This is essential for auth flows, payment processing, and other sensitive or secure operations.
326-
327325
<Note>
328-
**Important**: URL mode elicitation is *not* for authorizing the MCP client's
329-
access to the MCP server (that's handled by [MCP
330-
authorization](../basic/authorization)). Instead, it's used when the MCP
331-
server needs to obtain sensitive information or third-party authorization on
332-
behalf of the user. The MCP client's bearer token remains unchanged. The
333-
client's only responsibility is to provide the user with context about the
334-
elicitation URL the server wants them to open.
326+
327+
New feature: URL mode elicitation is newly-introduced in this version of the MCP specification, and its design may evolve in future protocol versions.
328+
335329
</Note>
336330

331+
URL mode elicitation enables servers to direct users to external URLs for out-of-band interactions that must not pass through the MCP client. This is essential for auth flows, payment processing, and other sensitive or secure operations.
332+
337333
URL mode elicitation requests **MUST** specify `mode: "url"`, a `message`, and include these additional parameters:
338334

339335
| Name | Type | Description |
@@ -343,6 +339,16 @@ URL mode elicitation requests **MUST** specify `mode: "url"`, a `message`, and i
343339

344340
The `url` parameter **MUST** contain a valid URL.
345341

342+
<Note>
343+
**Important**: URL mode elicitation is *not* for authorizing the MCP client's
344+
access to the MCP server (that's handled by [MCP
345+
authorization](../basic/authorization)). Instead, it's used when the MCP
346+
server needs to obtain sensitive information or third-party authorization on
347+
behalf of the user. The MCP client's bearer token remains unchanged. The
348+
client's only responsibility is to provide the user with context about the
349+
elicitation URL the server wants them to open.
350+
</Note>
351+
346352
#### Example: Request Sensitive Data
347353

348354
This example shows a URL mode elicitation request directing the user to a secure URL where they can provide sensitive information (an API key, for example).

0 commit comments

Comments
 (0)