chore(internal): codegen related update

Author: stainless-app[bot]

packages/mcp-server/README.md

@@ -51,17 +51,18 @@ For clients with a configuration JSON, it might look something like this:
 
 ### Cursor
 
-      If you use Cursor, you can install the MCP server by using the button below. You will need to set your environment variables
-      in Cursor's `mcp.json`, which can be found in Cursor Settings > Tools & MCP > New MCP Server.
+If you use Cursor, you can install the MCP server by using the button below. You will need to set your environment variables
+in Cursor's `mcp.json`, which can be found in Cursor Settings > Tools & MCP > New MCP Server.
 
-      [![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=@stainless-api/sdk-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBzdGFpbmxlc3MtYXBpL3Nkay1tY3AiXSwiZW52Ijp7IlNUQUlOTEVTU19BUElfS0VZIjoiU2V0IHlvdXIgU1RBSU5MRVNTX0FQSV9LRVkgaGVyZS4iLCJTVEFJTkxFU1NfUFJPSkVDVCI6IlNldCB5b3VyIFNUQUlOTEVTU19QUk9KRUNUIGhlcmUuIn19)
+[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=@stainless-api/sdk-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBzdGFpbmxlc3MtYXBpL3Nkay1tY3AiXSwiZW52Ijp7IlNUQUlOTEVTU19BUElfS0VZIjoiU2V0IHlvdXIgU1RBSU5MRVNTX0FQSV9LRVkgaGVyZS4iLCJTVEFJTkxFU1NfUFJPSkVDVCI6IlNldCB5b3VyIFNUQUlOTEVTU19QUk9KRUNUIGhlcmUuIn19)
 
 ## Exposing endpoints to your MCP Client
 
-There are two ways to expose endpoints as tools in the MCP server:
+There are three ways to expose endpoints as tools in the MCP server:
 
 1. Exposing one tool per endpoint, and filtering as necessary
 2. Exposing a set of tools to dynamically discover and invoke endpoints from the API
+3. Exposing a docs search tool and a code execution tool, allowing the client to write code to be executed against the TypeScript client
 
 ### Filtering endpoints and tools
 
@@ -96,6 +97,18 @@ All of these command-line options can be repeated, combined together, and have c
 
 Use `--list` to see the list of available tools, or see below.
 
+### Code execution
+
+If you specify `--tools=code` to the MCP server, it will expose just two tools:
+
+- `search_docs` - Searches the API documentation and returns a list of markdown results
+- `execute` - Runs code against the TypeScript client
+
+This allows the LLM to implement more complex logic by chaining together many API calls without loading
+intermediary results into its context window.
+
+The code execution itself happens in a Deno sandbox that has network access only to the base URL for the API.
+
 ### Specifying the MCP Client
 
 Different clients have varying abilities to handle arbitrary tools and schemas.