Skip to content

Documentation / @agentick/mcp / MCPServer

Class: MCPServer

Defined in: server/server.ts:230

Constructors

Constructor

new MCPServer(options): MCPServer

Defined in: server/server.ts:246

Parameters

options

MCPServerOptions

Returns

MCPServer

Methods

close()

close(): Promise<void>

Defined in: server/server.ts:513

Returns

Promise<void>


connect()

connect(transport): Promise<void>

Defined in: server/server.ts:268

Parameters

transport

Transport

Returns

Promise<void>


getActiveSessions()

getActiveSessions(): MCPSessionInfo[]

Defined in: server/server.ts:550

Returns

MCPSessionInfo[]


getRegisteredTools()

getRegisteredTools(): MCPToolDefinition[]

Defined in: server/server.ts:559

Returns

MCPToolDefinition[]


handleHTTPRequest()

handleHTTPRequest(req, res): Promise<void>

Defined in: server/server.ts:317

Parameters

req

IncomingMessage

res

ServerResponse

Returns

Promise<void>


listRoots()

listRoots(sessionId, opts?): Promise<Root[]>

Defined in: server/server.ts:630

Parameters

sessionId

string

opts?
force?

boolean

signal?

AbortSignal

timeoutMs?

number

Returns

Promise<Root[]>


off()

off<E>(event, handler): void

Defined in: server/server.ts:492

Type Parameters

E

E extends keyof MCPServerEvents

Parameters

event

E

handler

(data) => void

Returns

void


on()

on<E>(event, handler): void

Defined in: server/server.ts:488

Type Parameters

E

E extends keyof MCPServerEvents

Parameters

event

E

handler

(data) => void

Returns

void


registerApp()

registerApp(definition): void

Defined in: server/server.ts:467

Parameters

definition

MCPAppDefinition

Returns

void


registerResource()

registerResource(definition): void

Defined in: server/server.ts:442

Parameters

definition

MCPStaticResource | MCPResourceTemplateDefinition

Returns

void


registerTool()

registerTool(definition): void

Defined in: server/server.ts:424

Parameters

definition

MCPToolDefinition

Returns

void


request()

request<T>(sessionId, method, params, opts?): Promise<T>

Defined in: server/server.ts:584

Issue a request to the client connected at sessionId and await the response. The request is routed through the session's underlying SDK Server, so capability negotiation, transport, and serialization all use the same path the client established at initialize time.

Type Parameters

T

T = unknown

Parameters

sessionId

string

method

string

params

unknown

opts?
resultSchema?

ZodType<T, unknown, $ZodTypeInternals<T, unknown>>

Zod schema for response validation. Defaults to passthrough (returns unknown).

signal?

AbortSignal

Abort signal — rejects with an abort error if signaled.

timeoutMs?

number

Hard timeout in milliseconds.

Returns

Promise<T>

Throws

if sessionId is not a known session

Throws

if the server has been closed

Throws

on timeout, abort, schema validation failure, or client error


requestElicitation()

requestElicitation(sessionId, params, opts?): Promise<ElicitationResponse>

Defined in: server/server.ts:746

Parameters

sessionId

string

params
message

string

mode?

"form"

requestedSchema

ElicitationFormSchema

opts?
signal?

AbortSignal

timeoutMs?

TimeoutOption

Returns

Promise<ElicitationResponse>


requestSampling()

requestSampling(sessionId, params, opts?): Promise<SamplingResult>

Defined in: server/server.ts:710

Parameters

sessionId

string

params

SamplingParams

opts?
signal?

AbortSignal

timeoutMs?

number

Returns

Promise<SamplingResult>


requestUrlElicitation()

requestUrlElicitation(sessionId, params, opts?): Promise<UrlElicitationResponse>

Defined in: server/server.ts:773

Parameters

sessionId

string

params
elicitationId

string

message

string

mode

"url"

url

string

opts?
signal?

AbortSignal

timeoutMs?

TimeoutOption

Returns

Promise<UrlElicitationResponse>


unregisterApp()

unregisterApp(uri): void

Defined in: server/server.ts:475

Parameters

uri

string

Returns

void


unregisterResource()

unregisterResource(uriOrTemplate): void

Defined in: server/server.ts:457

Parameters

uriOrTemplate

string

Returns

void


unregisterTool()

unregisterTool(name): void

Defined in: server/server.ts:433

Parameters

name

string

Returns

void

Released under the ISC License.