mcp-superleap-oauth-dcr

Authenticate Superleap MCP servers using OAuth 2.1 with PKCE and dynamic client registration.

Updated May 7, 2026
One-click install
npx skills add https://github.com/superleapai/superleap-mcp-hermes-skill --skill mcp-superleap-oauth-dcr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-superleap-oauth-dcr
Source: https://github.com/superleapai/superleap-mcp-hermes-skill/tree/main
Command: npx skills add https://github.com/superleapai/superleap-mcp-hermes-skill --skill mcp-superleap-oauth-dcr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you connect to Superleap remote MCP servers that cannot use a static bearer token and instead require OAuth 2.1, protected-resource discovery, dynamic client registration, PKCE, and refresh-token handling.

Core Features & Use Cases

  • OAuth Discovery: Finds the protected-resource and authorization-server metadata needed to start the login flow correctly.
  • Dynamic Client Registration: Registers a public client at runtime so the MCP client can obtain a client_id without preprovisioned credentials.
  • PKCE Authorization Flow: Guides the browser-based authorization code exchange with state validation and secure token storage.
  • Token Refresh and Retry: Refreshes expired access tokens and retries failed MCP requests without restarting the full flow.
  • Superleap Tenant Handling: Uses the MCP resource path to derive the correct tenant subdomain for Superleap endpoints.

Quick Start

Use this Skill to connect my Superleap MCP server by discovering its OAuth metadata, registering the client, completing the PKCE login, storing the tokens securely, and retrying the MCP request with the refreshed access token.

Frequently Asked Questions about mcp-superleap-oauth-dcr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect to a remote MCP server requiring OAuth 2.1 and dynamic client registration?

To connect to a remote MCP server requiring OAuth 2.1 and dynamic client registration, you must discover protected-resource metadata, register a public client at runtime, and complete a PKCE authorization flow to obtain tokens.

What is dynamic client registration used for in MCP authentication?

Dynamic client registration in MCP authentication is used to register a public client at runtime, allowing the MCP client to obtain a client_id without needing preprovisioned credentials or static bearer tokens.

How do I refresh expired access tokens for a Superleap MCP server?

You refresh expired access tokens for a Superleap MCP server by using the stored refresh token to request a new access token, then retrying the failed MCP requests without restarting the full authorization flow.

Does this OAuth flow handle tenant subdomain selection for mcp.superleap.com deployments?

Yes, the OAuth flow handles tenant subdomain selection for mcp.superleap.com deployments by using the MCP resource path to derive the correct tenant subdomain for the Superleap endpoints.

Why does my MCP request fail with a WWW-Authenticate header on a protected resource?

An MCP request fails with a WWW-Authenticate header on a protected resource because the server requires OAuth 2.1 authentication, meaning you must validate the metadata, complete PKCE login, and exchange codes for valid tokens.

Can I use a static bearer token instead of OAuth PKCE for Superleap MCP?

No, you cannot use a static bearer token if the Superleap MCP server requires OAuth 2.1; you must use dynamic client registration, PKCE login, and token refresh handling to authenticate successfully.