modelcontextprotocol / modelcontextprotocol/kotlin-sdk
Implement SEP-991: URL-based Client Registration (OAuth Client ID Metadata)
Nobody has claimed this yet.
- Dominant language
- Kotlin
- Stars
- 1.5k
- Forks
- 248
- Avg merge
- 1d 20h
- Merged PRs (30d)
- 23
Description
This is a tracking issue for implementation of SEP-991.
Summary
This SEP proposes adopting OAuth Client ID Metadata Documents as an additional client registration mechanism for MCP. This approach allows OAuth clients to use HTTPS URLs as client identifiers, where the URL points to a JSON document containing client metadata. This addresses the common MCP scenario where servers and clients have no pre-existing relationship, enabling servers to trust clients without pre-coordination while maintaining full control over access policies.
The Kotlin SDK currently does not provide built-in OAuth or authorization functionality - it focuses on the core MCP protocol for communication between clients and servers. OAuth implementation is typically handled at the application level or through integration with external OAuth libraries. This implementation will require adding support for OAuth flows with Client ID Metadata Documents, including: client-side utilities for hosting and serving metadata documents, server-side utilities for fetching and validating metadata from HTTPS URLs, integration with OAuth metadata to advertise support via client_id_metadata_document_supported, and proper validation of redirect URIs against metadata documents. This may be implemented as an optional OAuth extension module for the SDK.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reading SEP-991 and reviewing the Kotlin SDK's existing protocol support, since the issue states that OAuth and authorization are not currently built in. Define the scope of an optional OAuth extension covering metadata hosting, HTTPS fetching and validation, support advertisement, and redirect URI validation; completion requires these capabilities to be integrated and covered by appropriate tests.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- kotlin
- Domain
- authentication, backend-api-design, security
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100