listMcpServers()
This method lists deployment MCP servers.
Usage
The following example shows a basic usage of the backend client from @wacht/nextjs/server.
import { wachtClient } from '@wacht/nextjs/server';export async function example() { const client = await wachtClient(); const options: ListOptions = { limit: 20, offset: 0, }; return client.ai.listMcpServers(options);}Signature
function listMcpServers( options?: ListOptions, client?: WachtClient,): Promise<PaginatedResponse<McpServer>>Parameters
›options?: ListOptions | undefined;
options?: ListOptions | undefined;Optional query/filter object used to shape list/search behavior.
›limit?: number | undefined;
limit?: number | undefined;limit value used by this request.
›offset?: number | undefined;
offset?: number | undefined;offset value used by this request.
Return value
›data?: McpServer[] | undefined;
data?: McpServer[] | undefined;Current page result items.
›has_more?: boolean | undefined;
has_more?: boolean | undefined;Whether additional pages are available.
›limit?: number | undefined;
limit?: number | undefined;Effective page size when returned by backend.
›offset?: number | undefined;
offset?: number | undefined;Effective offset when returned by backend.
Examples
AI usage pattern
import { wachtClient } from '@wacht/nextjs/server';export async function provisionMcp(actorId: string) { const client = await wachtClient(); const server = await client.ai.createMcpServer({ name: 'Internal MCP', transport: 'sse', endpoint_url: 'https://mcp.example.com', }); const connected = await client.ai.connectActorMcpServer(actorId, server.id); return { server, connected };}