Class HttpConnector

Connects to an MCP server using streamable HTTP.

The connector negotiates modern and legacy protocol eras by default and can route transport requests through an HTTP gateway.

Hierarchy (View Summary)

BaseConnector
- HttpConnector

Constructors

constructor

new HttpConnector(baseUrl: string, opts?: HttpConnectorOptions): HttpConnector
Creates an HTTP connector.
Parameters
- baseUrl: string
  MCP endpoint URL.
- opts: HttpConnectorOptions = {}
  Authentication, transport, SDK, and reconnection options.
Returns HttpConnector
Overrides BaseConnector.constructor
- Defined in transport/http.ts:174

Accessors

instructions

get instructions(): string | undefined
Instructions supplied by the connected server, if any.

Returns string | undefined
Inherited from BaseConnector.instructions
- Defined in transport/base.ts:586

isClientConnected

get isClientConnected(): boolean
Whether an SDK client currently exists for this connector.

Returns boolean
Inherited from BaseConnector.isClientConnected
- Defined in transport/base.ts:495

negotiatedProtocolVersion

get negotiatedProtocolVersion(): string | undefined
The protocol version string negotiated for the active connection.

Returns string | undefined
Inherited from BaseConnector.negotiatedProtocolVersion
- Defined in transport/base.ts:601

protocolEra

get protocolEra(): ProtocolEra | undefined
The negotiated protocol era for the active connection.
- "legacy" — 2025-era server, sessionful initialize handshake.
- "modern" — 2026-era server, stateless per-request. undefined before the connection has negotiated.
Returns ProtocolEra | undefined
Inherited from BaseConnector.protocolEra
- Defined in transport/base.ts:596

publicIdentifier

get publicIdentifier(): Record<string, string>
Returns fields that identify the endpoint and negotiated transport.

Returns Record<string, string>
HTTP connector identity metadata.
Overrides BaseConnector.publicIdentifier
- Defined in transport/http.ts:652

serverCapabilities

get serverCapabilities(): Record<string, unknown>
Capabilities cached during initialization, or an empty object.

Returns Record<string, unknown>
Inherited from BaseConnector.serverCapabilities
- Defined in transport/base.ts:576

serverInfo

get serverInfo(): MCPServerInfo | null
Server identity cached during initialization, or null.

Returns MCPServerInfo | null
Inherited from BaseConnector.serverInfo
- Defined in transport/base.ts:581

tools

get tools(): {}[]
Returns the tool list cached during initialization.

Returns {}[]

Throws
When BaseConnector.initialize has not completed.
Inherited from BaseConnector.tools
- Defined in transport/base.ts:568

Methods

callTool

callTool(
    name: string,
    args: Record<string, any>,
    options?: RequestOptions,
): Promise<{ [key: string]: unknown }>
Calls a tool on the connected server.
Parameters
- name: string
  Tool name.
- args: Record<string, any>
  Tool arguments.
- Optionaloptions: RequestOptions
  Per-request timeout, cancellation, and progress options.
Returns Promise<{ [key: string]: unknown }>
The tool result returned by the server.

Throws
When the connector is not connected or the tool call fails.
Inherited from BaseConnector.callTool
- Defined in transport/base.ts:614

complete

complete(
params: {},
options?: RequestOptions,
): Promise<{ [key: string]: unknown }>
Request completion suggestions for a prompt or resource template argument
Parameters
- params: {}
  Completion request parameters
- Optionaloptions: RequestOptions
  Request options
Returns Promise<{ [key: string]: unknown }>
Completion suggestions from the server
Inherited from BaseConnector.complete
- Defined in transport/base.ts:760

connect

connect(): Promise<void>
Establishes a streamable HTTP connection to the MCP server.

Returns Promise<void>
A promise that resolves after protocol negotiation completes.

Throws
An error with code: 401 when authentication is required.
Overrides BaseConnector.connect
- Defined in transport/http.ts:336

disconnect

disconnect(): Promise<void>
Disconnects the SDK client and releases transport resources.

Returns Promise<void>
A promise that resolves after cleanup completes.
Inherited from BaseConnector.disconnect
- Defined in transport/base.ts:482

getPrompt

getPrompt(
name: string,
args: Record<string, any>,
): Promise<{ [key: string]: unknown }>
Gets a prompt with the supplied arguments.
Parameters
- name: string
  Prompt name.
- args: Record<string, any>
  Prompt arguments.
Returns Promise<{ [key: string]: unknown }>
The rendered prompt returned by the server.
Inherited from BaseConnector.getPrompt
- Defined in transport/base.ts:859

getRoots

getRoots(): {}[]
Returns the roots currently advertised to the server.

Returns {}[]
A copy of the configured roots.
Inherited from BaseConnector.getRoots
- Defined in transport/base.ts:386

getTransportType

getTransportType(): "streamable-http" | null
Returns the active transport type.

Returns "streamable-http" | null
"streamable-http" after connection, otherwise null.
- Defined in transport/http.ts:666

initialize

initialize(defaultRequestOptions?: RequestOptions): Promise<{} | undefined>
Initialise the MCP session after connect() has succeeded.

In the SDK, Client.connect(transport) automatically performs the protocol‑level initialize handshake, so we only need to cache the list of tools and expose some server info.
Parameters
- defaultRequestOptions: RequestOptions = ...
  Options used while fetching the initial tool list.
Returns Promise<{} | undefined>
The capabilities advertised by the server.

Throws
When BaseConnector.connect has not completed.
Inherited from BaseConnector.initialize
- Defined in transport/base.ts:510

listAllResources

listAllResources(options?: RequestOptions): Promise<{ resources: any[] }>
List all resources from the server, automatically handling pagination
Parameters
- Optionaloptions: RequestOptions
  Request options
Returns Promise<{ resources: any[] }>
Complete list of all resources
Inherited from BaseConnector.listAllResources
- Defined in transport/base.ts:700

listPrompts

listPrompts(): Promise<{ [key: string]: unknown }>
Lists prompts exposed by the server.

Returns Promise<{ [key: string]: unknown }>
The prompt list, or an empty list when prompts are unsupported.
Inherited from BaseConnector.listPrompts
- Defined in transport/base.ts:827

listResources

listResources(
cursor?: string,
options?: RequestOptions,
): Promise<{ [key: string]: unknown }>
List resources from the server with optional pagination
Parameters
- Optionalcursor: string
  Optional cursor for pagination
- Optionaloptions: RequestOptions
  Request options
Returns Promise<{ [key: string]: unknown }>
Resource list with optional nextCursor for pagination
Inherited from BaseConnector.listResources
- Defined in transport/base.ts:685

listResourceTemplates

listResourceTemplates(
options?: RequestOptions,
): Promise<{ [key: string]: unknown }>
List resource templates from the server
Parameters
- Optionaloptions: RequestOptions
  Request options
Returns Promise<{ [key: string]: unknown }>
List of available resource templates
Inherited from BaseConnector.listResourceTemplates
- Defined in transport/base.ts:744

listTools

listTools(options?: RequestOptions): Promise<{}[]>
List all available tools from the MCP server. This method fetches fresh tools from the server, unlike the tools getter which returns cached tools.
Parameters
- Optionaloptions: RequestOptions
  Optional request options
Returns Promise<{}[]>
Array of available tools
Inherited from BaseConnector.listTools
- Defined in transport/base.ts:663

onNotification

onNotification(handler: NotificationHandler): void
Register a handler for server notifications
Parameters
- handler: NotificationHandler
  Function to call when a notification is received
Returns void
Example
```
connector.onNotification((notification) => {
  console.log(`Received: ${notification.method}`, notification.params);
});
```
Inherited from BaseConnector.onNotification
- Defined in transport/base.ts:187

readResource

readResource(
uri: string,
options?: RequestOptions,
): Promise<{ [key: string]: unknown }>
Reads a resource by URI.
Parameters
- uri: string
  Resource URI to read.
- Optionaloptions: RequestOptions
  Per-request options.
Returns Promise<{ [key: string]: unknown }>
The resource contents returned by the server.
Inherited from BaseConnector.readResource
- Defined in transport/base.ts:782

request

request(
    method: string,
    params?: Record<string, any> | null,
    options?: RequestOptions,
): Promise<unknown>
Sends a raw, potentially non-standard request through the SDK client.
Parameters
- method: string
  JSON-RPC method name.
- params: Record<string, any> | null = null
  Request parameters. Defaults to an empty object.
- Optionaloptions: RequestOptions
  Per-request options.
Returns Promise<unknown>
The unvalidated result returned by the server.
Inherited from BaseConnector.request
- Defined in transport/base.ts:876

setRoots

setRoots(roots: {}[]): Promise<void>
Set roots and notify the server. Roots represent directories or files that the client has access to.
Parameters
- roots: {}[]
  Array of Root objects with uri (must start with "file://") and optional name
Returns Promise<void>
Deprecated
Roots are retained only for v1 compatibility.
Example
```
await connector.setRoots([
  { uri: "file:///home/user/project", name: "My Project" },
  { uri: "file:///home/user/data" }
]);
```
Inherited from BaseConnector.setRoots
- Defined in transport/base.ts:371

subscribeToResource

subscribeToResource(uri: string, options?: RequestOptions): Promise<{}>
Subscribe to resource updates
Parameters
- uri: string
  URI of the resource to subscribe to
- Optionaloptions: RequestOptions
  Request options
Returns Promise<{}>
Inherited from BaseConnector.subscribeToResource
- Defined in transport/base.ts:798

unsubscribeFromResource

unsubscribeFromResource(uri: string, options?: RequestOptions): Promise<{}>
Unsubscribe from resource updates
Parameters
- uri: string
  URI of the resource to unsubscribe from
- Optionaloptions: RequestOptions
  Request options
Returns Promise<{}>
Inherited from BaseConnector.unsubscribeFromResource
- Defined in transport/base.ts:813

Class HttpConnector

Hierarchy (View Summary)

Index

Constructors

Accessors

Methods

Constructors

constructor

Parameters

Returns HttpConnector

Accessors

instructions

Returns string | undefined

isClientConnected

Returns boolean

negotiatedProtocolVersion

Returns string | undefined

protocolEra

Returns ProtocolEra | undefined

publicIdentifier

Returns Record<string, string>

serverCapabilities

Returns Record<string, unknown>

serverInfo

Returns MCPServerInfo | null

tools

Returns {}[]

Throws

Methods

callTool

Parameters

Returns Promise<{ [key: string]: unknown }>

Throws

complete

Parameters

Returns Promise<{ [key: string]: unknown }>

connect

Returns Promise<void>

Throws

disconnect

Returns Promise<void>

getPrompt

Parameters

Returns Promise<{ [key: string]: unknown }>

getRoots

Returns {}[]

getTransportType

Returns "streamable-http" | null

initialize

Parameters

Returns Promise<{} | undefined>

Throws

listAllResources

Parameters

Returns Promise<{ resources: any[] }>

listPrompts

Returns Promise<{ [key: string]: unknown }>

listResources

Parameters

Returns Promise<{ [key: string]: unknown }>

listResourceTemplates

Parameters

Returns Promise<{ [key: string]: unknown }>

listTools

Parameters

Returns Promise<{}[]>

onNotification

Parameters

Returns void

Example

readResource

Parameters

Returns Promise<{ [key: string]: unknown }>

request

Parameters

Returns Promise<unknown>

setRoots

Parameters

Returns Promise<void>

Deprecated