# createSdkMcpServer() Function

> The function that puts your tools on one server for the agent.

**Field:** Artificial Intelligence  
**Category:** Claude Agent SDK  
**Also known as:** create_sdk_mcp_server, createSdkMcpServer, Claude Agent SDK createSdkMcpServer()

## Think of it like

It is like a panel that holds your new buttons.

## Definition

createSdkMcpServer() is the Agent SDK function that wraps your custom tools in an MCP server. In Python it is create_sdk_mcp_server. You give it a name, a version and the list of tools. You then pass the server in the mcpServers option. The server name becomes part of each tool's name, such as mcp__orders__get_order.

## Example

Mia puts two order tools in one server called orders. Claude then sees each tool with the server name in front.

## Example code

```typescript
const orders = createSdkMcpServer({
  name: "orders",
  version: "1.0.0",
  tools: [getOrder],
});
```

Wrap one tool in a server called orders.

## Why it matters

Custom tools reach Claude only through an MCP server, and this makes one in a single call.

## Common mistake

Allowing a tool by its short name. In allowedTools, use the full name that starts with mcp.

## Three principles

- **Name, version, tools.** Its inputs.
- **Goes in mcpServers.** Like any server.
- **Name joins the tool name.** mcp__server__tool.

## Related terms

- [tool() Helper](https://learn.benibix.com/term/ai/sdk-tool-helper)
- [SDK MCP Server](https://learn.benibix.com/term/ai/sdk-mcp-server)
- [mcpServers Option](https://learn.benibix.com/term/ai/mcp-servers-option)
- [MCP Permission Rule](https://learn.benibix.com/term/ai/mcp-permission-rule)

---

Source: https://learn.benibix.com/term/ai/create-sdk-mcp-server
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-20
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
