---
title: "MCP Servers hooks"
description: "Hand-written shim. Implementation is generated; see ./mcp-servers.gen."
section: "Libraries"
group: "React hooks"
order: 433
---

## Hooks

### `useCreateMcpServer` `mutation`

Create a new MCP server.

```ts
useCreateMcpServer(options?: MutationOpts<McpServer, CreateMcpServerParams>)
```

**Types:** [McpServer](/types/mcp-server) · [CreateMcpServerParams](/types/create-mcp-server-params)

### `useDeleteMcpServer` `mutation`

Soft-delete an MCP server.

```ts
useDeleteMcpServer(options?: MutationOpts<SuccessResponse, string>)
```

**Types:** [SuccessResponse](/types/success-response)

### `useListMcpServers` `query`

List MCP servers with pagination.

```ts
useListMcpServers(params?: Omit<ListMcpServersParams, | > & { filter?: McpServerFilter; orderBy?: McpServerOrderBy[]; } & McpServerShorthands, options?: QueryOpts<Page<McpServer>>)
```

**Types:** [ListMcpServersParams](/types/list-mcp-servers-params) · [McpServerFilter](/types/mcp-server-filter) · [McpServerOrderBy](/types/mcp-server-order-by) · [McpServerShorthands](/types/mcp-server-shorthands) · [Page](/types/page) · [McpServer](/types/mcp-server)

### `usePurgeMcpServer` `composite`

Permanently delete a soft-deleted MCP server.

```ts
usePurgeMcpServer(options?: MutationOpts<SuccessResponse, PurgeMcpServerParams>)
```

**Types:** [SuccessResponse](/types/success-response) · [PurgeMcpServerParams](/types/purge-mcp-server-params)

### `useRestoreMcpServer` `composite`

Restore a soft-deleted MCP server.

```ts
useRestoreMcpServer(options?: MutationOpts<McpServer, string>)
```

**Types:** [McpServer](/types/mcp-server)

### `useRetrieveMcpServer` `query`

Get a single MCP server by ID.

```ts
useRetrieveMcpServer(id: string, options?: QueryOpts<McpServer>)
```

**Types:** [McpServer](/types/mcp-server)

### `useUpdateMcpServer` `mutation`

Update an MCP server.

```ts
useUpdateMcpServer(options?: MutationOpts<McpServer, UpdateMcpServerParams>)
```

**Types:** [McpServer](/types/mcp-server) · [UpdateMcpServerParams](/types/update-mcp-server-params)