docs: update MCP guide, add tool-filter example, and remove unrelated changeset

Author: vrtnis

.changeset/heavy-yaks-mate.md

@@ -10,6 +10,7 @@ import hostedStreamExample from '../../../../../examples/docs/mcp/hostedStream.t
 import hostedHITLExample from '../../../../../examples/docs/mcp/hostedHITL.ts?raw';
 import streamableHttpExample from '../../../../../examples/docs/mcp/streamableHttp.ts?raw';
 import stdioExample from '../../../../../examples/docs/mcp/stdio.ts?raw';
+import toolFilterExample from '../../../../../examples/docs/mcp/tool-filter.ts?raw';
 
 The [**Model Context Protocol (MCP)**](https://modelcontextprotocol.io) is an open protocol that standardizes how applications provide tools and context to LLMs. From the MCP docs:
 
@@ -99,24 +100,13 @@ Only enable this if you're confident the tool list won't change. To invalidate t
 
 ### Tool filtering
 
-You can restrict which tools are exposed from each server. Pass either a static filter
-using `createMCPToolStaticFilter` or a custom function:
-
-```ts
-const server = new MCPServerStdio({
-  fullCommand: 'my-server',
-  toolFilter: createMCPToolStaticFilter({
-    allowed: ['safe_tool'],
-    blocked: ['danger_tool'],
-  }),
-});
-
-const dynamicServer = new MCPServerStreamableHttp({
-  url: 'http://localhost:3000',
-  toolFilter: ({ runContext }, tool) =>
-    runContext.context.allowAll || tool.name !== 'admin',
-});
-```
+You can restrict which tools are exposed from each server by passing either a static filter via `createMCPToolStaticFilter` or a custom function. Here’s a combined example showing both approaches:
+
+<Code 
+  lang="typescript" 
+  code={toolFilterExample} 
+  title="Tool filtering" 
+/>
 
 ## Further reading
 

docs/src/content/docs/guides/mcp.mdx

@@ -0,0 +1,24 @@
+import {
+  MCPServerStdio,
+  MCPServerStreamableHttp,
+  createMCPToolStaticFilter,
+  MCPToolFilterContext,
+} from '@openai/agents';
+
+interface ToolFilterContext {
+  allowAll: boolean;
+}
+
+const server = new MCPServerStdio({
+  fullCommand: 'my-server',
+  toolFilter: createMCPToolStaticFilter({
+    allowed: ['safe_tool'],
+    blocked: ['danger_tool'],
+  }),
+});
+
+const dynamicServer = new MCPServerStreamableHttp({
+  url: 'http://localhost:3000',
+  toolFilter: async ({ runContext }: MCPToolFilterContext, tool) =>
+    (runContext.context as ToolFilterContext).allowAll || tool.name !== 'admin',
+});