Skip to content

feat: classify authorization-required errors - #1056

Merged
DaleSeo merged 1 commit into
mainfrom
fix/issue-795-auth-error
Jul 31, 2026
Merged

feat: classify authorization-required errors#1056
DaleSeo merged 1 commit into
mainfrom
fix/issue-795-auth-error

Conversation

@DaleSeo

@DaleSeoDaleSeo commented Jul 27, 2026•
edited
Loading

Copy link
Copy Markdown
Member

Closes#795.

Motivation and Context

OAuth initialization can currently ask the caller to authorize through either AuthError::AuthorizationRequired or StreamableHttpError::AuthRequired. Because ClientInitializeError erases the concrete transport error, callers must downcast it and match both variants even though both require the same action.

This PR classifies those existing errors through their standard source chain and exposes one predicate on ClientInitializeError. The transport-level classifier remains crate-private so this does not introduce a broader error-category API without a demonstrated use case.

How Has This Been Tested?

Add tests

Breaking Changes

None.

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update

Checklist

  • I have read the MCP Documentation
  • My code follows the repository's style guidelines
  • New and existing tests pass locally
  • I have added appropriate error handling
  • I have added or updated documentation as needed

@github-actionsgithub-actionsBot added T-documentation Documentation improvements T-dependencies Dependencies related changes T-test Testing related changes T-config Configuration file changes T-core Core library changes T-service Service layer changes labels Jul 27, 2026
@DaleSeo
DaleSeoforce-pushed the fix/issue-795-auth-error branch 2 times, most recently from bc1d788 to 872c35dCompareJuly 27, 2026 17:52
@DaleSeo
DaleSeoforce-pushed the fix/issue-795-auth-error branch from 872c35d to ec4c0ccCompareJuly 27, 2026 18:18
@DaleSeo
DaleSeo marked this pull request as ready for review July 27, 2026 22:32
@DaleSeo
DaleSeo requested a review from a team as a code ownerJuly 27, 2026 22:32
@DaleSeoDaleSeo self-assigned this Jul 28, 2026
@DaleSeo
DaleSeo merged commit 65f05e9 into mainJul 31, 2026
22 checks passed
@DaleSeo
DaleSeo deleted the fix/issue-795-auth-error branch July 31, 2026 13:00
@github-actionsgithub-actionsBot mentioned this pull request Jul 31, 2026
Merged
howardjohn pushed a commit to agentgateway/agentgateway that referenced this pull request Jul 31, 2026
@filintod
bump rmcp to 3.1.0 (#2788)
33d9d05
Bump to latest stable release
https://github.com/modelcontextprotocol/rust-sdk/releases/tag/rmcp-v3.1.0
```
Added
classify authorization-required errors (modelcontextprotocol/rust-sdk#1056)
add strict stateless protocol metadata validation (modelcontextprotocol/rust-sdk#1091)
SEP-2260 stream-based enforcement of client receive-side request association (modelcontextprotocol/rust-sdk#1055)
Fixed
(model) decode metadata-bearing input-required results affecting mrtr (modelcontextprotocol/rust-sdk#1097)
require metadata for modern HTTP requests (modelcontextprotocol/rust-sdk#1089)
honor supported_protocol_versions when negotiating initialize (modelcontextprotocol/rust-sdk#1093)
Other
document the ping utility with examples (modelcontextprotocol/rust-sdk#1106)
complete Tier 1 feature docs and finalize roadmap (modelcontextprotocol/rust-sdk#1101)
(conformance) meeting requirements for tier 1 (modelcontextprotocol/rust-sdk#1087)
```
Signed-off-by: Filinto Duran <1373693+filintod@users.noreply.github.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@alexhancockalexhancockalexhancock approved these changes

Assignees

@DaleSeoDaleSeo

Labels

T-configConfiguration file changesT-coreCore library changesT-dependenciesDependencies related changesT-documentationDocumentation improvementsT-serviceService layer changesT-testTesting related changes

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

More accessible auth error and avoid multiple types

2 participants

@DaleSeo@alexhancock
, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all 
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
feat: classify authorization-required errors by DaleSeo · Pull Request #1056 · modelcontextprotocol/rust-sdk · GitHub
Skip to content
feat: classify authorization-required errors - #1056
Merged
DaleSeo merged 1 commit into
mainfrom 
fix/issue-795-auth-error
Jul 31, 2026
Merged
feat: classify authorization-required errors#1056
DaleSeo merged 1 commit into
mainfrom 
fix/issue-795-auth-error
Conversation
@DaleSeo
@DaleSeoDaleSeo
commented
Jul 27, 2026•

edited

Loading

Copy link


Copy Markdown

Member
Closes#795.
Motivation and Context
OAuth initialization can currently ask the caller to authorize through either AuthError::AuthorizationRequired or StreamableHttpError::AuthRequired. Because ClientInitializeError erases the concrete transport error, callers must downcast it and match both variants even though both require the same action.
This PR classifies those existing errors through their standard source chain and exposes one predicate on ClientInitializeError. The transport-level classifier remains crate-private so this does not introduce a broader error-category API without a demonstrated use case.
How Has This Been Tested?
Add tests
Breaking Changes
None.
Types of changes
  •  Bug fix (non-breaking change which fixes an issue)
  •  New feature (non-breaking change which adds functionality)
  •  Breaking change (fix or feature that would cause existing functionality to change)
  •  Documentation update
Checklist
  •  I have read the MCP Documentation
  •  My code follows the repository's style guidelines
  •  New and existing tests pass locally
  •  I have added appropriate error handling
  •  I have added or updated documentation as needed
@github-actionsgithub-actionsBot
added

T-documentation
Documentation improvements
T-dependencies
Dependencies related changes
T-test
Testing related changes
T-config
Configuration file changes
T-core
Core library changes
T-service
Service layer changes
labels
Jul 27, 2026
@DaleSeo
DaleSeoforce-pushed
the
fix/issue-795-auth-error
branch
2 times, most recently
from
bc1d788 to
872c35dCompareJuly 27, 2026 17:52
@DaleSeo
DaleSeoforce-pushed
the
fix/issue-795-auth-error
branch
from
872c35d to
ec4c0ccCompareJuly 27, 2026 18:18
@DaleSeo
DaleSeo
marked this pull request as ready for review
July 27, 2026 22:32
@DaleSeo
DaleSeo
requested a review
from a team
as a code ownerJuly 27, 2026 22:32
@DaleSeoDaleSeo
self-assigned this
Jul 28, 2026
@DaleSeo
DaleSeo
merged commit 65f05e9
into
mainJul 31, 2026

22 checks passed

@DaleSeo
DaleSeo
deleted the

fix/issue-795-auth-error

branch
July 31, 2026 13:00
@github-actionsgithub-actionsBot
mentioned this pull request
Jul 31, 2026
 Merged

howardjohn pushed a commit
to agentgateway/agentgateway
that referenced
this pull request
Jul 31, 2026
@filintod
bump rmcp to 3.1.0 (#2788)
33d9d05
Bump to latest stable release
https://github.com/modelcontextprotocol/rust-sdk/releases/tag/rmcp-v3.1.0
```
Added
classify authorization-required errors (modelcontextprotocol/rust-sdk#1056)
add strict stateless protocol metadata validation (modelcontextprotocol/rust-sdk#1091)
SEP-2260 stream-based enforcement of client receive-side request association (modelcontextprotocol/rust-sdk#1055)
Fixed
(model) decode metadata-bearing input-required results affecting mrtr (modelcontextprotocol/rust-sdk#1097)
require metadata for modern HTTP requests (modelcontextprotocol/rust-sdk#1089)
honor supported_protocol_versions when negotiating initialize (modelcontextprotocol/rust-sdk#1093)
Other
document the ping utility with examples (modelcontextprotocol/rust-sdk#1106)
complete Tier 1 feature docs and finalize roadmap (modelcontextprotocol/rust-sdk#1101)
(conformance) meeting requirements for tier 1 (modelcontextprotocol/rust-sdk#1087)
```
Signed-off-by: Filinto Duran <1373693+filintod@users.noreply.github.com>
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers

@alexhancockalexhancockalexhancock approved these changes

Assignees

@DaleSeoDaleSeo

Labels

T-configConfiguration file changesT-coreCore library changesT-dependenciesDependencies related changesT-documentationDocumentation improvementsT-serviceService layer changesT-testTesting related changes

Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

More accessible auth error and avoid multiple types


2 participants

@DaleSeo@alexhancock

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Force GitHub README to respect dark mode
(function() {
var style = document.createElement('style');
style.textContent = '
.markdown-body {
color-scheme: dark light;
}
.markdown-body pre { background: #161b22 !important; }
.markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }
.markdown-body table th, .markdown-body table td { border-color: #30363d !important; }
.markdown-body img { background: #0d1117; }
.markdown-body blockquote { border-left-color: #8b949e; }
.markdown-body hr { border-color: #30363d; }
';
document.head.appendChild(style);
})();
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
feat: classify authorization-required errors by DaleSeo · Pull Request #1056 · modelcontextprotocol/rust-sdk · GitHub
Skip to content
feat: classify authorization-required errors - #1056
Merged
DaleSeo merged 1 commit into
mainfrom 
fix/issue-795-auth-error
Jul 31, 2026
Merged
feat: classify authorization-required errors#1056
DaleSeo merged 1 commit into
mainfrom 
fix/issue-795-auth-error
Conversation
@DaleSeo
@DaleSeoDaleSeo
commented
Jul 27, 2026•

edited

Loading

Copy link


Copy Markdown

Member
Closes#795.
Motivation and Context
OAuth initialization can currently ask the caller to authorize through either AuthError::AuthorizationRequired or StreamableHttpError::AuthRequired. Because ClientInitializeError erases the concrete transport error, callers must downcast it and match both variants even though both require the same action.
This PR classifies those existing errors through their standard source chain and exposes one predicate on ClientInitializeError. The transport-level classifier remains crate-private so this does not introduce a broader error-category API without a demonstrated use case.
How Has This Been Tested?
Add tests
Breaking Changes
None.
Types of changes
  •  Bug fix (non-breaking change which fixes an issue)
  •  New feature (non-breaking change which adds functionality)
  •  Breaking change (fix or feature that would cause existing functionality to change)
  •  Documentation update
Checklist
  •  I have read the MCP Documentation
  •  My code follows the repository's style guidelines
  •  New and existing tests pass locally
  •  I have added appropriate error handling
  •  I have added or updated documentation as needed
@github-actionsgithub-actionsBot
added

T-documentation
Documentation improvements
T-dependencies
Dependencies related changes
T-test
Testing related changes
T-config
Configuration file changes
T-core
Core library changes
T-service
Service layer changes
labels
Jul 27, 2026
@DaleSeo
DaleSeoforce-pushed
the
fix/issue-795-auth-error
branch
2 times, most recently
from
bc1d788 to
872c35dCompareJuly 27, 2026 17:52
@DaleSeo
DaleSeoforce-pushed
the
fix/issue-795-auth-error
branch
from
872c35d to
ec4c0ccCompareJuly 27, 2026 18:18
@DaleSeo
DaleSeo
marked this pull request as ready for review
July 27, 2026 22:32
@DaleSeo
DaleSeo
requested a review
from a team
as a code ownerJuly 27, 2026 22:32
@DaleSeoDaleSeo
self-assigned this
Jul 28, 2026
@DaleSeo
DaleSeo
merged commit 65f05e9
into
mainJul 31, 2026

22 checks passed

@DaleSeo
DaleSeo
deleted the

fix/issue-795-auth-error

branch
July 31, 2026 13:00
@github-actionsgithub-actionsBot
mentioned this pull request
Jul 31, 2026
 Merged

howardjohn pushed a commit
to agentgateway/agentgateway
that referenced
this pull request
Jul 31, 2026
@filintod
bump rmcp to 3.1.0 (#2788)
33d9d05
Bump to latest stable release
https://github.com/modelcontextprotocol/rust-sdk/releases/tag/rmcp-v3.1.0
```
Added
classify authorization-required errors (modelcontextprotocol/rust-sdk#1056)
add strict stateless protocol metadata validation (modelcontextprotocol/rust-sdk#1091)
SEP-2260 stream-based enforcement of client receive-side request association (modelcontextprotocol/rust-sdk#1055)
Fixed
(model) decode metadata-bearing input-required results affecting mrtr (modelcontextprotocol/rust-sdk#1097)
require metadata for modern HTTP requests (modelcontextprotocol/rust-sdk#1089)
honor supported_protocol_versions when negotiating initialize (modelcontextprotocol/rust-sdk#1093)
Other
document the ping utility with examples (modelcontextprotocol/rust-sdk#1106)
complete Tier 1 feature docs and finalize roadmap (modelcontextprotocol/rust-sdk#1101)
(conformance) meeting requirements for tier 1 (modelcontextprotocol/rust-sdk#1087)
```
Signed-off-by: Filinto Duran <1373693+filintod@users.noreply.github.com>
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers

@alexhancockalexhancockalexhancock approved these changes

Assignees

@DaleSeoDaleSeo

Labels

T-configConfiguration file changesT-coreCore library changesT-dependenciesDependencies related changesT-documentationDocumentation improvementsT-serviceService layer changesT-testTesting related changes

Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

More accessible auth error and avoid multiple types


2 participants

@DaleSeo@alexhancock

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Highlight search terms from Google/DuckDuckGo/Bing referrer
(function() {
var ref = document.referrer;
var terms = [];
if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {
var url = new URL(ref);
var q = url.searchParams.get('q') || url.searchParams.get('p');
if (q) {
terms = q.split(/\s+/).filter(function(t) { return t.length > 2; });
}
}
if (terms.length === 0) return;
var style = document.createElement('style');
style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';
document.head.appendChild(style);
function highlight(node) {
if (node.nodeType === 3) { // text node
var text = node.textContent;
var found = false;
terms.forEach(function(term) {
var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi');
if (regex.test(text)) {
found = true;
var frag = document.createDocumentFragment();
var parts = text.split(regex);
parts.forEach(function(part, i) {
if (i % 2 === 0) {
frag.appendChild(document.createTextNode(part));
} else {
var span = document.createElement('span');
span.className = 'userscript-highlight';
span.textContent = part;
frag.appendChild(span);
}
});
node.parentNode.replaceChild(frag, node);
}
});
} else if (node.nodeType === 1 && node.childNodes) { // element
var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];
if (!skipTags.includes(node.tagName)) {
Array.from(node.childNodes).forEach(highlight);
}
}
}
highlight(document.body);
// Re-highlight on dynamic content
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1 || node.nodeType === 3) highlight(node);
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
feat: classify authorization-required errors by DaleSeo · Pull Request #1056 · modelcontextprotocol/rust-sdk · GitHub
Skip to content
feat: classify authorization-required errors - #1056
Merged
DaleSeo merged 1 commit into
mainfrom 
fix/issue-795-auth-error
Jul 31, 2026
Merged
feat: classify authorization-required errors#1056
DaleSeo merged 1 commit into
mainfrom 
fix/issue-795-auth-error
Conversation
@DaleSeo
@DaleSeoDaleSeo
commented
Jul 27, 2026•

edited

Loading

Copy link


Copy Markdown

Member
Closes#795.
Motivation and Context
OAuth initialization can currently ask the caller to authorize through either AuthError::AuthorizationRequired or StreamableHttpError::AuthRequired. Because ClientInitializeError erases the concrete transport error, callers must downcast it and match both variants even though both require the same action.
This PR classifies those existing errors through their standard source chain and exposes one predicate on ClientInitializeError. The transport-level classifier remains crate-private so this does not introduce a broader error-category API without a demonstrated use case.
How Has This Been Tested?
Add tests
Breaking Changes
None.
Types of changes
  •  Bug fix (non-breaking change which fixes an issue)
  •  New feature (non-breaking change which adds functionality)
  •  Breaking change (fix or feature that would cause existing functionality to change)
  •  Documentation update
Checklist
  •  I have read the MCP Documentation
  •  My code follows the repository's style guidelines
  •  New and existing tests pass locally
  •  I have added appropriate error handling
  •  I have added or updated documentation as needed
@github-actionsgithub-actionsBot
added

T-documentation
Documentation improvements
T-dependencies
Dependencies related changes
T-test
Testing related changes
T-config
Configuration file changes
T-core
Core library changes
T-service
Service layer changes
labels
Jul 27, 2026
@DaleSeo
DaleSeoforce-pushed
the
fix/issue-795-auth-error
branch
2 times, most recently
from
bc1d788 to
872c35dCompareJuly 27, 2026 17:52
@DaleSeo
DaleSeoforce-pushed
the
fix/issue-795-auth-error
branch
from
872c35d to
ec4c0ccCompareJuly 27, 2026 18:18
@DaleSeo
DaleSeo
marked this pull request as ready for review
July 27, 2026 22:32
@DaleSeo
DaleSeo
requested a review
from a team
as a code ownerJuly 27, 2026 22:32
@DaleSeoDaleSeo
self-assigned this
Jul 28, 2026
@DaleSeo
DaleSeo
merged commit 65f05e9
into
mainJul 31, 2026

22 checks passed

@DaleSeo
DaleSeo
deleted the

fix/issue-795-auth-error

branch
July 31, 2026 13:00
@github-actionsgithub-actionsBot
mentioned this pull request
Jul 31, 2026
 Merged

howardjohn pushed a commit
to agentgateway/agentgateway
that referenced
this pull request
Jul 31, 2026
@filintod
bump rmcp to 3.1.0 (#2788)
33d9d05
Bump to latest stable release
https://github.com/modelcontextprotocol/rust-sdk/releases/tag/rmcp-v3.1.0
```
Added
classify authorization-required errors (modelcontextprotocol/rust-sdk#1056)
add strict stateless protocol metadata validation (modelcontextprotocol/rust-sdk#1091)
SEP-2260 stream-based enforcement of client receive-side request association (modelcontextprotocol/rust-sdk#1055)
Fixed
(model) decode metadata-bearing input-required results affecting mrtr (modelcontextprotocol/rust-sdk#1097)
require metadata for modern HTTP requests (modelcontextprotocol/rust-sdk#1089)
honor supported_protocol_versions when negotiating initialize (modelcontextprotocol/rust-sdk#1093)
Other
document the ping utility with examples (modelcontextprotocol/rust-sdk#1106)
complete Tier 1 feature docs and finalize roadmap (modelcontextprotocol/rust-sdk#1101)
(conformance) meeting requirements for tier 1 (modelcontextprotocol/rust-sdk#1087)
```
Signed-off-by: Filinto Duran <1373693+filintod@users.noreply.github.com>
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers

@alexhancockalexhancockalexhancock approved these changes

Assignees

@DaleSeoDaleSeo

Labels

T-configConfiguration file changesT-coreCore library changesT-dependenciesDependencies related changesT-documentationDocumentation improvementsT-serviceService layer changesT-testTesting related changes

Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

More accessible auth error and avoid multiple types


2 participants

@DaleSeo@alexhancock

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Strip utm_, fbclid, gclid, etc. from all links on page
(function() {
var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',
'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',
'ref', 'ref_src', 'source', 'medium', 'campaign'];
function cleanUrl(url) {
try {
var u = new URL(url, window.location.origin);
var changed = false;
trackingParams.forEach(function(p) {
if (u.searchParams.has(p)) {
u.searchParams.delete(p);
changed = true;
}
});
return changed ? u.toString() : url;
} catch (e) {
return url;
}
}
function cleanLinks() {
document.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
cleanLinks();
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1) {
if (node.tagName === 'A') cleanLinks();
node.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '
feat: classify authorization-required errors by DaleSeo · Pull Request #1056 · modelcontextprotocol/rust-sdk · GitHub
Skip to content
feat: classify authorization-required errors - #1056
Merged
DaleSeo merged 1 commit into
mainfrom 
fix/issue-795-auth-error
Jul 31, 2026
Merged
feat: classify authorization-required errors#1056
DaleSeo merged 1 commit into
mainfrom 
fix/issue-795-auth-error
Conversation
@DaleSeo
@DaleSeoDaleSeo
commented
Jul 27, 2026•

edited

Loading

Copy link


Copy Markdown

Member
Closes#795.
Motivation and Context
OAuth initialization can currently ask the caller to authorize through either AuthError::AuthorizationRequired or StreamableHttpError::AuthRequired. Because ClientInitializeError erases the concrete transport error, callers must downcast it and match both variants even though both require the same action.
This PR classifies those existing errors through their standard source chain and exposes one predicate on ClientInitializeError. The transport-level classifier remains crate-private so this does not introduce a broader error-category API without a demonstrated use case.
How Has This Been Tested?
Add tests
Breaking Changes
None.
Types of changes
  •  Bug fix (non-breaking change which fixes an issue)
  •  New feature (non-breaking change which adds functionality)
  •  Breaking change (fix or feature that would cause existing functionality to change)
  •  Documentation update
Checklist
  •  I have read the MCP Documentation
  •  My code follows the repository's style guidelines
  •  New and existing tests pass locally
  •  I have added appropriate error handling
  •  I have added or updated documentation as needed
@github-actionsgithub-actionsBot
added

T-documentation
Documentation improvements
T-dependencies
Dependencies related changes
T-test
Testing related changes
T-config
Configuration file changes
T-core
Core library changes
T-service
Service layer changes
labels
Jul 27, 2026
@DaleSeo
DaleSeoforce-pushed
the
fix/issue-795-auth-error
branch
2 times, most recently
from
bc1d788 to
872c35dCompareJuly 27, 2026 17:52
@DaleSeo
DaleSeoforce-pushed
the
fix/issue-795-auth-error
branch
from
872c35d to
ec4c0ccCompareJuly 27, 2026 18:18
@DaleSeo
DaleSeo
marked this pull request as ready for review
July 27, 2026 22:32
@DaleSeo
DaleSeo
requested a review
from a team
as a code ownerJuly 27, 2026 22:32
@DaleSeoDaleSeo
self-assigned this
Jul 28, 2026
@DaleSeo
DaleSeo
merged commit 65f05e9
into
mainJul 31, 2026

22 checks passed

@DaleSeo
DaleSeo
deleted the

fix/issue-795-auth-error

branch
July 31, 2026 13:00
@github-actionsgithub-actionsBot
mentioned this pull request
Jul 31, 2026
 Merged

howardjohn pushed a commit
to agentgateway/agentgateway
that referenced
this pull request
Jul 31, 2026
@filintod
bump rmcp to 3.1.0 (#2788)
33d9d05
Bump to latest stable release
https://github.com/modelcontextprotocol/rust-sdk/releases/tag/rmcp-v3.1.0
```
Added
classify authorization-required errors (modelcontextprotocol/rust-sdk#1056)
add strict stateless protocol metadata validation (modelcontextprotocol/rust-sdk#1091)
SEP-2260 stream-based enforcement of client receive-side request association (modelcontextprotocol/rust-sdk#1055)
Fixed
(model) decode metadata-bearing input-required results affecting mrtr (modelcontextprotocol/rust-sdk#1097)
require metadata for modern HTTP requests (modelcontextprotocol/rust-sdk#1089)
honor supported_protocol_versions when negotiating initialize (modelcontextprotocol/rust-sdk#1093)
Other
document the ping utility with examples (modelcontextprotocol/rust-sdk#1106)
complete Tier 1 feature docs and finalize roadmap (modelcontextprotocol/rust-sdk#1101)
(conformance) meeting requirements for tier 1 (modelcontextprotocol/rust-sdk#1087)
```
Signed-off-by: Filinto Duran <1373693+filintod@users.noreply.github.com>
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers

@alexhancockalexhancockalexhancock approved these changes

Assignees

@DaleSeoDaleSeo

Labels

T-configConfiguration file changesT-coreCore library changesT-dependenciesDependencies related changesT-documentationDocumentation improvementsT-serviceService layer changesT-testTesting related changes

Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

More accessible auth error and avoid multiple types


2 participants

@DaleSeo@alexhancock

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Auto-enable theater mode on YouTube
(function() {
function tryTheater() {
var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]');
if (btn && !btn.classList.contains('activated')) {
btn.click();
}
}
// Try immediately
tryTheater();
// Try after navigation (SPA)
var lastUrl = location.href;
setInterval(function() {
if (location.href !== lastUrl) {
lastUrl = location.href;
setTimeout(tryTheater, 500);
}
}, 1000);
// Also try on player load
var observer = new MutationObserver(tryTheater);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
feat: classify authorization-required errors by DaleSeo · Pull Request #1056 · modelcontextprotocol/rust-sdk · GitHub
Skip to content
feat: classify authorization-required errors - #1056
Merged
DaleSeo merged 1 commit into
mainfrom 
fix/issue-795-auth-error
Jul 31, 2026
Merged
feat: classify authorization-required errors#1056
DaleSeo merged 1 commit into
mainfrom 
fix/issue-795-auth-error
Conversation
@DaleSeo
@DaleSeoDaleSeo
commented
Jul 27, 2026•

edited

Loading

Copy link


Copy Markdown

Member
Closes#795.
Motivation and Context
OAuth initialization can currently ask the caller to authorize through either AuthError::AuthorizationRequired or StreamableHttpError::AuthRequired. Because ClientInitializeError erases the concrete transport error, callers must downcast it and match both variants even though both require the same action.
This PR classifies those existing errors through their standard source chain and exposes one predicate on ClientInitializeError. The transport-level classifier remains crate-private so this does not introduce a broader error-category API without a demonstrated use case.
How Has This Been Tested?
Add tests
Breaking Changes
None.
Types of changes
  •  Bug fix (non-breaking change which fixes an issue)
  •  New feature (non-breaking change which adds functionality)
  •  Breaking change (fix or feature that would cause existing functionality to change)
  •  Documentation update
Checklist
  •  I have read the MCP Documentation
  •  My code follows the repository's style guidelines
  •  New and existing tests pass locally
  •  I have added appropriate error handling
  •  I have added or updated documentation as needed
@github-actionsgithub-actionsBot
added

T-documentation
Documentation improvements
T-dependencies
Dependencies related changes
T-test
Testing related changes
T-config
Configuration file changes
T-core
Core library changes
T-service
Service layer changes
labels
Jul 27, 2026
@DaleSeo
DaleSeoforce-pushed
the
fix/issue-795-auth-error
branch
2 times, most recently
from
bc1d788 to
872c35dCompareJuly 27, 2026 17:52
@DaleSeo
DaleSeoforce-pushed
the
fix/issue-795-auth-error
branch
from
872c35d to
ec4c0ccCompareJuly 27, 2026 18:18
@DaleSeo
DaleSeo
marked this pull request as ready for review
July 27, 2026 22:32
@DaleSeo
DaleSeo
requested a review
from a team
as a code ownerJuly 27, 2026 22:32
@DaleSeoDaleSeo
self-assigned this
Jul 28, 2026
@DaleSeo
DaleSeo
merged commit 65f05e9
into
mainJul 31, 2026

22 checks passed

@DaleSeo
DaleSeo
deleted the

fix/issue-795-auth-error

branch
July 31, 2026 13:00
@github-actionsgithub-actionsBot
mentioned this pull request
Jul 31, 2026
 Merged

howardjohn pushed a commit
to agentgateway/agentgateway
that referenced
this pull request
Jul 31, 2026
@filintod
bump rmcp to 3.1.0 (#2788)
33d9d05
Bump to latest stable release
https://github.com/modelcontextprotocol/rust-sdk/releases/tag/rmcp-v3.1.0
```
Added
classify authorization-required errors (modelcontextprotocol/rust-sdk#1056)
add strict stateless protocol metadata validation (modelcontextprotocol/rust-sdk#1091)
SEP-2260 stream-based enforcement of client receive-side request association (modelcontextprotocol/rust-sdk#1055)
Fixed
(model) decode metadata-bearing input-required results affecting mrtr (modelcontextprotocol/rust-sdk#1097)
require metadata for modern HTTP requests (modelcontextprotocol/rust-sdk#1089)
honor supported_protocol_versions when negotiating initialize (modelcontextprotocol/rust-sdk#1093)
Other
document the ping utility with examples (modelcontextprotocol/rust-sdk#1106)
complete Tier 1 feature docs and finalize roadmap (modelcontextprotocol/rust-sdk#1101)
(conformance) meeting requirements for tier 1 (modelcontextprotocol/rust-sdk#1087)
```
Signed-off-by: Filinto Duran <1373693+filintod@users.noreply.github.com>
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers

@alexhancockalexhancockalexhancock approved these changes

Assignees

@DaleSeoDaleSeo

Labels

T-configConfiguration file changesT-coreCore library changesT-dependenciesDependencies related changesT-documentationDocumentation improvementsT-serviceService layer changesT-testTesting related changes

Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

More accessible auth error and avoid multiple types


2 participants

@DaleSeo@alexhancock

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Remove or un-stick sticky/fixed headers that block content
(function() {
function unstick() {
document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) {
if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {
el.style.position = 'static';
el.style.top = 'auto';
el.style.zIndex = 'auto';
}
});
}
unstick();
var observer = new MutationObserver(unstick);
observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });
})();
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
})();
feat: classify authorization-required errors by DaleSeo · Pull Request #1056 · modelcontextprotocol/rust-sdk · GitHub
Skip to content
feat: classify authorization-required errors - #1056
Merged
DaleSeo merged 1 commit into
mainfrom 
fix/issue-795-auth-error
Jul 31, 2026
Merged
feat: classify authorization-required errors#1056
DaleSeo merged 1 commit into
mainfrom 
fix/issue-795-auth-error
Conversation
@DaleSeo
@DaleSeoDaleSeo
commented
Jul 27, 2026•

edited

Loading

Copy link


Copy Markdown

Member
Closes#795.
Motivation and Context
OAuth initialization can currently ask the caller to authorize through either AuthError::AuthorizationRequired or StreamableHttpError::AuthRequired. Because ClientInitializeError erases the concrete transport error, callers must downcast it and match both variants even though both require the same action.
This PR classifies those existing errors through their standard source chain and exposes one predicate on ClientInitializeError. The transport-level classifier remains crate-private so this does not introduce a broader error-category API without a demonstrated use case.
How Has This Been Tested?
Add tests
Breaking Changes
None.
Types of changes
  •  Bug fix (non-breaking change which fixes an issue)
  •  New feature (non-breaking change which adds functionality)
  •  Breaking change (fix or feature that would cause existing functionality to change)
  •  Documentation update
Checklist
  •  I have read the MCP Documentation
  •  My code follows the repository's style guidelines
  •  New and existing tests pass locally
  •  I have added appropriate error handling
  •  I have added or updated documentation as needed
@github-actionsgithub-actionsBot
added

T-documentation
Documentation improvements
T-dependencies
Dependencies related changes
T-test
Testing related changes
T-config
Configuration file changes
T-core
Core library changes
T-service
Service layer changes
labels
Jul 27, 2026
@DaleSeo
DaleSeoforce-pushed
the
fix/issue-795-auth-error
branch
2 times, most recently
from
bc1d788 to
872c35dCompareJuly 27, 2026 17:52
@DaleSeo
DaleSeoforce-pushed
the
fix/issue-795-auth-error
branch
from
872c35d to
ec4c0ccCompareJuly 27, 2026 18:18
@DaleSeo
DaleSeo
marked this pull request as ready for review
July 27, 2026 22:32
@DaleSeo
DaleSeo
requested a review
from a team
as a code ownerJuly 27, 2026 22:32
@DaleSeoDaleSeo
self-assigned this
Jul 28, 2026
@DaleSeo
DaleSeo
merged commit 65f05e9
into
mainJul 31, 2026

22 checks passed

@DaleSeo
DaleSeo
deleted the

fix/issue-795-auth-error

branch
July 31, 2026 13:00
@github-actionsgithub-actionsBot
mentioned this pull request
Jul 31, 2026
 Merged

howardjohn pushed a commit
to agentgateway/agentgateway
that referenced
this pull request
Jul 31, 2026
@filintod
bump rmcp to 3.1.0 (#2788)
33d9d05
Bump to latest stable release
https://github.com/modelcontextprotocol/rust-sdk/releases/tag/rmcp-v3.1.0
```
Added
classify authorization-required errors (modelcontextprotocol/rust-sdk#1056)
add strict stateless protocol metadata validation (modelcontextprotocol/rust-sdk#1091)
SEP-2260 stream-based enforcement of client receive-side request association (modelcontextprotocol/rust-sdk#1055)
Fixed
(model) decode metadata-bearing input-required results affecting mrtr (modelcontextprotocol/rust-sdk#1097)
require metadata for modern HTTP requests (modelcontextprotocol/rust-sdk#1089)
honor supported_protocol_versions when negotiating initialize (modelcontextprotocol/rust-sdk#1093)
Other
document the ping utility with examples (modelcontextprotocol/rust-sdk#1106)
complete Tier 1 feature docs and finalize roadmap (modelcontextprotocol/rust-sdk#1101)
(conformance) meeting requirements for tier 1 (modelcontextprotocol/rust-sdk#1087)
```
Signed-off-by: Filinto Duran <1373693+filintod@users.noreply.github.com>
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers

@alexhancockalexhancockalexhancock approved these changes

Assignees

@DaleSeoDaleSeo

Labels

T-configConfiguration file changesT-coreCore library changesT-dependenciesDependencies related changesT-documentationDocumentation improvementsT-serviceService layer changesT-testTesting related changes

Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

More accessible auth error and avoid multiple types


2 participants

@DaleSeo@alexhancock