@mastra/mcp 1.0.0-beta.0 → 1.0.0-beta.10

package/dist/client/oauth-provider.d.ts

@@ -0,0 +1,230 @@
+/**
+ * OAuth Client Provider Implementation for MCP Client
+ *
+ * Provides a ready-to-use OAuthClientProvider implementation that can be used
+ * with Mastra's MCPClient for connecting to OAuth-protected MCP servers.
+ *
+ * @see https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization
+ */
+import type { OAuthClientProvider, OAuthClientMetadata, OAuthClientInformation, OAuthClientInformationFull, OAuthTokens, AuthorizationServerMetadata } from '../shared/oauth-types.js';
+/**
+ * Storage interface for persisting OAuth data.
+ *
+ * Implement this interface to persist OAuth data across sessions.
+ * For simple in-memory usage, use InMemoryOAuthStorage.
+ */
+export interface OAuthStorage {
+    /**
+     * Store a value by key.
+     */
+    set(key: string, value: string): Promise<void> | void;
+    /**
+     * Retrieve a value by key.
+     */
+    get(key: string): Promise<string | undefined> | string | undefined;
+    /**
+     * Delete a value by key.
+     */
+    delete(key: string): Promise<void> | void;
+}
+/**
+ * Simple in-memory OAuth storage.
+ *
+ * Data is lost when the process exits. For production, implement
+ * OAuthStorage with a persistent store like Redis or a database.
+ */
+export declare class InMemoryOAuthStorage implements OAuthStorage {
+    private data;
+    set(key: string, value: string): void;
+    get(key: string): string | undefined;
+    delete(key: string): void;
+    clear(): void;
+}
+/**
+ * Options for creating a MCPOAuthClientProvider.
+ */
+export interface MCPOAuthClientProviderOptions {
+    /**
+     * The redirect URL for the OAuth callback.
+     * This should be a URL your application controls that can handle
+     * the authorization code callback.
+     *
+     * @example 'http://localhost:3000/oauth/callback'
+     */
+    redirectUrl: string | URL;
+    /**
+     * OAuth client metadata for registration.
+     * If the client is not pre-registered with the authorization server,
+     * this metadata will be used for dynamic client registration.
+     */
+    clientMetadata: OAuthClientMetadata;
+    /**
+     * Pre-registered client information.
+     * If provided, skips dynamic client registration.
+     */
+    clientInformation?: OAuthClientInformation;
+    /**
+     * Storage for persisting OAuth data (tokens, client info, etc.).
+     * Defaults to InMemoryOAuthStorage if not provided.
+     */
+    storage?: OAuthStorage;
+    /**
+     * Callback invoked when the user needs to be redirected to authorize.
+     *
+     * For CLI applications, you might open the URL in a browser.
+     * For web applications, you might redirect the response.
+     *
+     * @param url - The authorization URL to redirect to
+     */
+    onRedirectToAuthorization?: (url: URL) => void | Promise<void>;
+    /**
+     * Generate a random state parameter for OAuth requests.
+     * Defaults to using crypto.randomUUID.
+     */
+    stateGenerator?: () => string | Promise<string>;
+}
+/**
+ * Mastra's OAuth Client Provider implementation.
+ *
+ * This provider handles the OAuth 2.1 flow for connecting to OAuth-protected
+ * MCP servers, including:
+ * - Dynamic client registration (RFC 7591)
+ * - PKCE (Proof Key for Code Exchange)
+ * - Token storage and refresh
+ *
+ * @example
+ * ```typescript
+ * import { MCPClient, MCPOAuthClientProvider, InMemoryOAuthStorage } from '@mastra/mcp';
+ *
+ * // Create the OAuth provider
+ * const oauthProvider = new MCPOAuthClientProvider({
+ *   redirectUrl: 'http://localhost:3000/oauth/callback',
+ *   clientMetadata: {
+ *     redirect_uris: ['http://localhost:3000/oauth/callback'],
+ *     client_name: 'My MCP Client',
+ *     grant_types: ['authorization_code', 'refresh_token'],
+ *     response_types: ['code'],
+ *   },
+ *   onRedirectToAuthorization: (url) => {
+ *     // Open URL in browser for CLI, or redirect response for web
+ *     console.log(`Please visit: ${url}`);
+ *   },
+ * });
+ *
+ * // Create the MCP client with OAuth
+ * const client = new MCPClient({
+ *   servers: {
+ *     'protected-server': {
+ *       url: 'https://mcp.example.com/mcp',
+ *       authProvider: oauthProvider,
+ *     },
+ *   },
+ * });
+ *
+ * await client.connect();
+ * ```
+ */
+export declare class MCPOAuthClientProvider implements OAuthClientProvider {
+    private readonly _redirectUrl;
+    private readonly _clientMetadata;
+    private readonly storage;
+    private readonly onRedirect?;
+    private readonly generateState;
+    private _clientInfo?;
+    constructor(options: MCPOAuthClientProviderOptions);
+    /**
+     * The URL to redirect the user agent to after authorization.
+     */
+    get redirectUrl(): string | URL;
+    /**
+     * Metadata about this OAuth client.
+     */
+    get clientMetadata(): OAuthClientMetadata;
+    /**
+     * Returns a OAuth2 state parameter.
+     */
+    state(): Promise<string>;
+    /**
+     * Loads information about this OAuth client.
+     */
+    clientInformation(): Promise<OAuthClientInformation | undefined>;
+    /**
+     * Saves dynamically registered client information.
+     */
+    saveClientInformation(clientInformation: OAuthClientInformationFull): Promise<void>;
+    /**
+     * Loads existing OAuth tokens.
+     */
+    tokens(): Promise<OAuthTokens | undefined>;
+    /**
+     * Stores new OAuth tokens after successful authorization.
+     */
+    saveTokens(tokens: OAuthTokens): Promise<void>;
+    /**
+     * Invoked to redirect the user agent to the authorization URL.
+     */
+    redirectToAuthorization(authorizationUrl: URL): Promise<void>;
+    /**
+     * Saves a PKCE code verifier before redirecting to authorization.
+     */
+    saveCodeVerifier(codeVerifier: string): Promise<void>;
+    /**
+     * Loads the PKCE code verifier for validating authorization result.
+     */
+    codeVerifier(): Promise<string>;
+    /**
+     * Optional: Custom client authentication for token requests.
+     * Uses default behavior if not implemented.
+     */
+    addClientAuthentication?(_headers: Headers, _params: URLSearchParams, _url: string | URL, _metadata?: AuthorizationServerMetadata): Promise<void>;
+    /**
+     * Invalidate credentials when server indicates they're no longer valid.
+     */
+    invalidateCredentials(scope: 'all' | 'client' | 'tokens' | 'verifier'): Promise<void>;
+    /**
+     * Clear all stored OAuth data.
+     * Useful for logging out or resetting state.
+     */
+    clear(): Promise<void>;
+    /**
+     * Check if the provider has valid (non-expired) tokens.
+     */
+    hasValidTokens(): Promise<boolean>;
+}
+/**
+ * Creates a simple OAuth provider with pre-configured tokens.
+ *
+ * This is useful for testing scenarios where you already have a valid token.
+ * For production, use the full MCPOAuthClientProvider with proper OAuth flow.
+ *
+ * @param accessToken - A valid access token
+ * @param options - Additional configuration options
+ * @returns An OAuthClientProvider that returns the pre-configured token
+ *
+ * @example
+ * ```typescript
+ * const provider = createSimpleTokenProvider('my-access-token', {
+ *   redirectUrl: 'http://localhost:3000/callback',
+ *   clientMetadata: {
+ *     redirect_uris: ['http://localhost:3000/callback'],
+ *     client_name: 'Test Client',
+ *   },
+ * });
+ *
+ * const client = new MCPClient({
+ *   servers: {
+ *     test: { url: 'https://mcp.example.com', authProvider: provider }
+ *   },
+ * });
+ * ```
+ */
+export declare function createSimpleTokenProvider(accessToken: string, options: {
+    redirectUrl: string | URL;
+    clientMetadata: OAuthClientMetadata;
+    clientInformation?: OAuthClientInformation;
+    tokenType?: string;
+    refreshToken?: string;
+    expiresIn?: number;
+    scope?: string;
+}): OAuthClientProvider;
+//# sourceMappingURL=oauth-provider.d.ts.map

package/dist/client/oauth-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-provider.d.ts","sourceRoot":"","sources":["../../src/client/oauth-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,WAAW,EACX,2BAA2B,EAC5B,MAAM,0BAA0B,CAAC;AAElC;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEtD;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC;IAEnE;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3C;AAED;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,IAAI,CAA6B;IAEzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIrC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIpC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB,KAAK,IAAI,IAAI;CAGd;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC;IAE1B;;;;OAIG;IACH,cAAc,EAAE,mBAAmB,CAAC;IAEpC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IAE3C;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IAEvB;;;;;;;OAOG;IACH,yBAAyB,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/D;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACjD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAChE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsB;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAqC;IACjE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiC;IAE/D,OAAO,CAAC,WAAW,CAAC,CAAyB;gBAEjC,OAAO,EAAE,6BAA6B;IASlD;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,GAAG,GAAG,CAE9B;IAED;;OAEG;IACH,IAAI,cAAc,IAAI,mBAAmB,CAExC;IAED;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAI9B;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;IAmBtE;;OAEG;IACG,qBAAqB,CAAC,iBAAiB,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzF;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAYhD;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD;;OAEG;IACG,uBAAuB,CAAC,gBAAgB,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IASnE;;OAEG;IACG,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAQrC;;;OAGG;IACG,uBAAuB,CAAC,CAC5B,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,MAAM,GAAG,GAAG,EAClB,SAAS,CAAC,EAAE,2BAA2B,GACtC,OAAO,CAAC,IAAI,CAAC;IAIhB;;OAEG;IACG,qBAAqB,CACzB,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAC9C,OAAO,CAAC,IAAI,CAAC;IAqBhB;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;CAYzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;IACP,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC;IAC1B,cAAc,EAAE,mBAAmB,CAAC;IACpC,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,mBAAmB,CAsBrB"}

package/dist/client/types.d.ts

@@ -0,0 +1,237 @@
+import type { RequestContext } from '@mastra/core/di';
+import type { SSEClientTransportOptions } from '@modelcontextprotocol/sdk/client/sse.js';
+import type { StreamableHTTPClientTransportOptions } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import type { FetchLike } from '@modelcontextprotocol/sdk/shared/transport.js';
+import type { ClientCapabilities, ElicitRequest, ElicitResult, LoggingLevel, ProgressNotification } from '@modelcontextprotocol/sdk/types.js';
+export type { LoggingLevel } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Log message structure for MCP client logging.
+ */
+export interface LogMessage {
+    /** Logging level (debug, info, warning, error, etc.) */
+    level: LoggingLevel;
+    /** Log message content */
+    message: string;
+    /** Timestamp when the log was created */
+    timestamp: Date;
+    /** Name of the MCP server that generated the log */
+    serverName: string;
+    /** Optional additional details */
+    details?: Record<string, any>;
+    requestContext?: RequestContext | null;
+}
+/**
+ * Handler function for processing log messages from MCP servers.
+ */
+export type LogHandler = (logMessage: LogMessage) => void;
+/**
+ * Handler function for processing elicitation requests from MCP servers.
+ *
+ * @param request - The elicitation request parameters including message and schema
+ * @returns Promise resolving to the user's response (accept/decline/cancel with optional content)
+ */
+export type ElicitationHandler = (request: ElicitRequest['params']) => Promise<ElicitResult>;
+/**
+ * Handler function for processing progress notifications from MCP servers.
+ *
+ * @param params - The progress notification parameters including message and status
+ */
+export type ProgressHandler = (params: ProgressNotification['params']) => void;
+/**
+ * Represents a filesystem root that the client exposes to MCP servers.
+ *
+ * Per MCP spec (https://modelcontextprotocol.io/specification/2025-11-25/client/roots):
+ * Roots define the boundaries of where servers can operate within the filesystem,
+ * allowing them to understand which directories and files they have access to.
+ *
+ * @example
+ * ```typescript
+ * const root: Root = {
+ *   uri: 'file:///home/user/projects/myproject',
+ *   name: 'My Project'
+ * };
+ * ```
+ */
+export interface Root {
+    /** Unique identifier for the root. Must be a file:// URI. */
+    uri: string;
+    /** Optional human-readable name for display purposes. */
+    name?: string;
+}
+/**
+ * Base options common to all MCP server definitions.
+ */
+export type BaseServerOptions = {
+    /** Optional handler for server log messages */
+    logger?: LogHandler;
+    /** Optional timeout in milliseconds for server operations */
+    timeout?: number;
+    /** Optional client capabilities to advertise to the server */
+    capabilities?: ClientCapabilities;
+    /** Whether to enable server log forwarding (default: true) */
+    enableServerLogs?: boolean;
+    /** Whether to enable progress tracking (default: false) */
+    enableProgressTracking?: boolean;
+    /**
+     * List of filesystem roots to expose to the MCP server.
+     *
+     * Per MCP spec (https://modelcontextprotocol.io/specification/2025-11-25/client/roots):
+     * Roots define the boundaries of where servers can operate within the filesystem.
+     *
+     * When configured, the client will:
+     * 1. Automatically advertise the `roots` capability to the server
+     * 2. Respond to `roots/list` requests with these roots
+     * 3. Send `notifications/roots/list_changed` when roots are updated via `setRoots()`
+     *
+     * @example
+     * ```typescript
+     * {
+     *   command: 'npx',
+     *   args: ['-y', '@modelcontextprotocol/server-filesystem', '/tmp'],
+     *   roots: [
+     *     { uri: 'file:///tmp', name: 'Temp Directory' }
+     *   ]
+     * }
+     * ```
+     */
+    roots?: Root[];
+};
+/**
+ * Configuration for MCP servers using stdio (subprocess) transport.
+ *
+ * Used when the MCP server is spawned as a subprocess that communicates via stdin/stdout.
+ */
+export type StdioServerDefinition = BaseServerOptions & {
+    /** Command to execute (e.g., 'node', 'python', 'npx') */
+    command: string;
+    /** Optional arguments to pass to the command */
+    args?: string[];
+    /** Optional environment variables for the subprocess */
+    env?: Record<string, string>;
+    url?: never;
+    requestInit?: never;
+    eventSourceInit?: never;
+    authProvider?: never;
+    reconnectionOptions?: never;
+    sessionId?: never;
+    connectTimeout?: never;
+    fetch?: never;
+};
+/**
+ * Configuration for MCP servers using HTTP-based transport (Streamable HTTP or SSE fallback).
+ *
+ * Used when connecting to remote MCP servers over HTTP. The client will attempt Streamable HTTP
+ * transport first and fall back to SSE if that fails.
+ *
+ * When `fetch` is provided, all other HTTP-related options (`requestInit`, `eventSourceInit`, `authProvider`)
+ * become optional, as the custom fetch function can handle authentication and request customization.
+ */
+export type HttpServerDefinition = BaseServerOptions & {
+    /** URL of the MCP server endpoint */
+    url: URL;
+    command?: never;
+    args?: never;
+    env?: never;
+    /**
+     * Custom fetch implementation used for all network requests.
+     *
+     * When provided, this function will be used for all HTTP requests, allowing you to:
+     * - Add dynamic authentication headers (e.g., refreshing bearer tokens)
+     * - Customize request behavior per-request
+     * - Intercept and modify requests/responses
+     *
+     * When `fetch` is provided, `requestInit`, `eventSourceInit`, and `authProvider` become optional,
+     * as you can handle these concerns within your custom fetch function.
+     *
+     * @example
+     * ```typescript
+     * {
+     *   url: new URL('https://api.example.com/mcp'),
+     *   fetch: async (url, init) => {
+     *     const token = await getAuthToken(); // Your token refresh logic
+     *     return fetch(url, {
+     *       ...init,
+     *       headers: {
+     *         ...init?.headers,
+     *         Authorization: `Bearer ${token}`,
+     *       },
+     *     });
+     *   },
+     * }
+     * ```
+     */
+    fetch?: FetchLike;
+    /** Optional request configuration for HTTP requests (optional when `fetch` is provided) */
+    requestInit?: StreamableHTTPClientTransportOptions['requestInit'];
+    /** Optional configuration for SSE fallback (required when using custom headers with SSE, optional when `fetch` is provided) */
+    eventSourceInit?: SSEClientTransportOptions['eventSourceInit'];
+    /** Optional authentication provider for HTTP requests (optional when `fetch` is provided) */
+    authProvider?: StreamableHTTPClientTransportOptions['authProvider'];
+    /** Optional reconnection configuration for Streamable HTTP */
+    reconnectionOptions?: StreamableHTTPClientTransportOptions['reconnectionOptions'];
+    /** Optional session ID for Streamable HTTP */
+    sessionId?: StreamableHTTPClientTransportOptions['sessionId'];
+    /** Optional timeout in milliseconds for the connection phase (default: 3000ms).
+     * This timeout allows the system to switch MCP streaming protocols during the setup phase.
+     * The default is set to 3s because the long default timeout would be extremely slow for SSE backwards compat (60s).
+     */
+    connectTimeout?: number;
+};
+/**
+ * Configuration for connecting to an MCP server.
+ *
+ * Either stdio-based (subprocess) or HTTP-based (remote server). The transport type is
+ * automatically detected based on whether `command` or `url` is provided.
+ *
+ * @example
+ * ```typescript
+ * // Stdio server
+ * const stdioServer: MastraMCPServerDefinition = {
+ *   command: 'npx',
+ *   args: ['tsx', 'server.ts'],
+ *   env: { API_KEY: 'secret' }
+ * };
+ *
+ * // HTTP server with static headers
+ * const httpServer: MastraMCPServerDefinition = {
+ *   url: new URL('http://localhost:8080/mcp'),
+ *   requestInit: {
+ *     headers: { Authorization: 'Bearer token' }
+ *   }
+ * };
+ *
+ * // HTTP server with custom fetch for dynamic auth
+ * const httpServerWithFetch: MastraMCPServerDefinition = {
+ *   url: new URL('http://localhost:8080/mcp'),
+ *   fetch: async (url, init) => {
+ *     const token = await getAuthToken(); // Refresh token on each request
+ *     return fetch(url, {
+ *       ...init,
+ *       headers: {
+ *         ...init?.headers,
+ *         Authorization: `Bearer ${token}`,
+ *       },
+ *     });
+ *   },
+ * };
+ * ```
+ */
+export type MastraMCPServerDefinition = StdioServerDefinition | HttpServerDefinition;
+/**
+ * Options for creating an internal MCP client instance.
+ *
+ * @internal
+ */
+export type InternalMastraMCPClientOptions = {
+    /** Name identifier for this client */
+    name: string;
+    /** Server connection configuration */
+    server: MastraMCPServerDefinition;
+    /** Optional client capabilities to advertise to the server */
+    capabilities?: ClientCapabilities;
+    /** Optional client version */
+    version?: string;
+    /** Optional timeout in milliseconds */
+    timeout?: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"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"}

package/dist/docs/README.md

@@ -0,0 +1,33 @@
+# @mastra/mcp Documentation
+
+> Embedded documentation for coding agents
+
+## Quick Start
+
+```bash
+# Read the skill overview
+cat docs/SKILL.md
+
+# Get the source map
+cat docs/SOURCE_MAP.json
+
+# Read topic documentation
+cat docs/<topic>/01-overview.md
+```
+
+## Structure
+
+```
+docs/
+├── SKILL.md           # Entry point
+├── README.md          # This file
+├── SOURCE_MAP.json    # Export index
+├── mcp/ (2 files)
+├── tools/ (3 files)
+├── tools-mcp/ (1 files)
+```
+
+## Version
+
+Package: @mastra/mcp
+Version: 1.0.0-beta.10

package/dist/docs/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: mastra-mcp-docs
+description: Documentation for @mastra/mcp. Includes links to type definitions and readable implementation code in dist/.
+---
+
+# @mastra/mcp Documentation
+
+> **Version**: 1.0.0-beta.10
+> **Package**: @mastra/mcp
+
+## Quick Navigation
+
+Use SOURCE_MAP.json to find any export:
+
+```bash
+cat docs/SOURCE_MAP.json
+```
+
+Each export maps to:
+- **types**: `.d.ts` file with JSDoc and API signatures
+- **implementation**: `.js` chunk file with readable source
+- **docs**: Conceptual documentation in `docs/`
+
+## Top Exports
+
+  - UnauthorizedError: dist/index.d.ts
+  - auth: dist/index.d.ts
+  - buildDiscoveryUrls: dist/index.d.ts
+  - discoverAuthorizationServerMetadata: dist/index.d.ts
+  - discoverOAuthMetadata: dist/index.d.ts
+  - discoverOAuthProtectedResourceMetadata: dist/index.d.ts
+  - exchangeAuthorization: dist/index.d.ts
+  - extractResourceMetadataUrl: dist/index.d.ts
+  - parseErrorResponse: dist/index.d.ts
+  - refreshAuthorization: dist/index.d.ts
+  - registerClient: dist/index.d.ts
+  - selectResourceURL: dist/index.d.ts
+  - startAuthorization: dist/index.d.ts
+
+See SOURCE_MAP.json for the complete list.
+
+## Available Topics
+
+- [Mcp](mcp/) - 2 file(s)
+- [Tools](tools/) - 3 file(s)
+- [Tools mcp](tools-mcp/) - 1 file(s)

package/dist/docs/SOURCE_MAP.json

@@ -0,0 +1,59 @@
+{
+  "version": "1.0.0-beta.10",
+  "package": "@mastra/mcp",
+  "exports": {
+    "UnauthorizedError": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/auth.js"
+    },
+    "auth": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/auth.js"
+    },
+    "buildDiscoveryUrls": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/auth.js"
+    },
+    "discoverAuthorizationServerMetadata": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/auth.js"
+    },
+    "discoverOAuthMetadata": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/auth.js"
+    },
+    "discoverOAuthProtectedResourceMetadata": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/auth.js"
+    },
+    "exchangeAuthorization": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/auth.js"
+    },
+    "extractResourceMetadataUrl": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/auth.js"
+    },
+    "parseErrorResponse": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/auth.js"
+    },
+    "refreshAuthorization": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/auth.js"
+    },
+    "registerClient": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/auth.js"
+    },
+    "selectResourceURL": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/auth.js"
+    },
+    "startAuthorization": {
+      "types": "dist/index.d.ts",
+      "implementation": "dist/auth.js"
+    }
+  },
+  "modules": {}
+}