Sync open source content 🐝 (from f8633cc569270efea1cc338c4d0cf7e981e54ee6)

Author: beezythebot

mcp/optimizing-your-openapi-for-mcp.mdx

@@ -276,7 +276,7 @@ Here's how to use this extension:
     x-speakeasy-mcp:
       name: "driver_fastest_lap_tool"
       description: "Find the fastest lap time a driver has ever recorded at any track"
-      scope: [read, performance-stats]
+      scopes: [read, performance-stats]
 ````
 
 #### Customize tool names and descriptions
@@ -330,18 +330,18 @@ paths:
     get:
       summary: List all drivers
       x-speakeasy-mcp:
-        scope: [read]
+        scopes: [read]
       # ...
     post:
       summary: Create a new driver
       x-speakeasy-mcp:
-        scope: [write]
+        scopes: [write]
       # ...
   "/drivers/{driver_id}":
     delete:
       summary: Delete a driver
       x-speakeasy-mcp:
-        scope: [write, destructive]
+        scopes: [write, destructive]
       # ...
 ```
 
@@ -387,11 +387,11 @@ To apply scopes consistently across many operations, you can use the global `x-s
 x-speakeasy-mcp:
   scope-mapping:
     - pattern: "^get|^list"
-      scope: [read]
+      scopes: [read]
     - pattern: "^create|^update"
-      scope: [write]
+      scopes: [write]
     - pattern: "^delete"
-      scope: [write, destructive]
+      scopes: [write, destructive]
 ```
 
 This automatically applies scopes based on operation name patterns, saving you from manually tagging each endpoint.
@@ -432,7 +432,7 @@ When using MCP, it's essential to provide clear descriptions for each operation.
         Fetch complete details about a specific racing driver including their
         name, team, career statistics, and full history of lap times across all tracks.
         Use this tool when you need comprehensive information about a driver.
-      scope: [read, driver-info]
+      scopes: [read, driver-info]
     parameters:
       - name: driver_id
         in: path