
# MCP Tools

The AI SDK supports Model Context Protocol (MCP) tools by offering a lightweight client that exposes a `tools` method for retrieving tools from a MCP server. After use, the client should always be closed to release resources.

```ts
import { experimental_createMCPClient, generateText } from 'ai';
import { Experimental_StdioMCPTransport } from 'ai/mcp-stdio';
import { openai } from '@ai-sdk/openai';

let clientOne;
let clientTwo;
let clientThree;

try {
  // Initialize an MCP client to connect to a `stdio` MCP server:
  const transport = new Experimental_StdioMCPTransport({
    command: 'node',
    args: ['src/stdio/dist/server.js'],
  });
  clientOne = await experimental_createMCPClient({
    transport,
  });

  // Alternatively, you can connect to a Server-Sent Events (SSE) MCP server:
  clientTwo = await experimental_createMCPClient({
    transport: {
      type: 'sse',
      url: 'http://localhost:3000/sse',
    },
  });

  // Similarly to the stdio example, you can pass in your own custom transport as long as it implements the `MCPTransport` interface:
  const transport = new MyCustomTransport({
    // ...
  });
  clientThree = await experimental_createMCPClient({
    transport,
  });

  const toolSetOne = await clientOne.tools();
  const toolSetTwo = await clientTwo.tools();
  const toolSetThree = await clientThree.tools();
  const tools = {
    ...toolSetOne,
    ...toolSetTwo,
    ...toolSetThree, // note: this approach causes subsequent tool sets to override tools with the same name
  };

  const response = await generateText({
    model: openai('gpt-4o'),
    tools,
    messages: [
      {
        role: 'user',
        content: 'Find products under $100',
      },
    ],
  });

  console.log(response.text);
} catch (error) {
  console.error(error);
} finally {
  await Promise.all([clientOne.close(), clientTwo.close()]);
}
```


## Navigation

- [Generate Text](/v4/cookbook/node/generate-text)
- [Retrieval Augmented Generation](/v4/cookbook/node/retrieval-augmented-generation)
- [Generate Text with Chat Prompt](/v4/cookbook/node/generate-text-with-chat-prompt)
- [Generate Text with Image Prompt](/v4/cookbook/node/generate-text-with-image-prompt)
- [Stream Text](/v4/cookbook/node/stream-text)
- [Stream Text with Chat Prompt](/v4/cookbook/node/stream-text-with-chat-prompt)
- [Stream Text with Image Prompt](/v4/cookbook/node/stream-text-with-image-prompt)
- [Stream Text with File Prompt](/v4/cookbook/node/stream-text-with-file-prompt)
- [Generate Object with a Reasoning Model](/v4/cookbook/node/generate-object-reasoning)
- [Generate Object](/v4/cookbook/node/generate-object)
- [Stream Object](/v4/cookbook/node/stream-object)
- [Stream Object with Image Prompt](/v4/cookbook/node/stream-object-with-image-prompt)
- [Record Token Usage After Streaming Object](/v4/cookbook/node/stream-object-record-token-usage)
- [Record Final Object after Streaming Object](/v4/cookbook/node/stream-object-record-final-object)
- [Call Tools](/v4/cookbook/node/call-tools)
- [Call Tools in Parallel](/v4/cookbook/node/call-tools-in-parallel)
- [Call Tools with Image Prompt](/v4/cookbook/node/call-tools-with-image-prompt)
- [Call Tools in Multiple Steps](/v4/cookbook/node/call-tools-multiple-steps)
- [Model Context Protocol (MCP) Tools](/v4/cookbook/node/mcp-tools)
- [Web Search Agent](/v4/cookbook/node/web-search-agent)
- [Embed Text](/v4/cookbook/node/embed-text)
- [Embed Text in Batch](/v4/cookbook/node/embed-text-batch)
- [Intercepting Fetch Requests](/v4/cookbook/node/intercept-fetch-requests)
- [Local Caching Middleware](/v4/cookbook/node/local-caching-middleware)


[Full Sitemap](/sitemap.md)
