---
title: "openvibe-sdk/mcp · OpenVibe.Services"
canonical: "https://openvibe.services/docs/sdk/mcp"
updated: null
---

# openvibe-sdk/mcp · OpenVibe.Services

HTML: [openvibe-sdk/mcp · OpenVibe.Services](https://openvibe.services/docs/sdk/mcp)

# `openvibe-sdk/mcp`

Generated at 2026-11-17 06:52:56 UTC from [`openvibe-contracts v0.443.0`](https://github.com/OpenVibers/OpenVibe.Contracts/tree/v0.443.0) and [`openvibe-sdk v0.177.0`](https://github.com/OpenVibers/OpenVibe.SDK/tree/v0.177.0).

From `types/mcp.d.ts` (server only). Declarations are shown verbatim.

## const MODERN\_VERSIONS

~~~~
export declare const MODERN_VERSIONS: readonly string[];
~~~~

## const LEGACY\_VERSIONS

~~~~
export declare const LEGACY_VERSIONS: readonly string[];
~~~~

## const DEFAULT\_LEGACY

~~~~
export declare const DEFAULT_LEGACY: string;
~~~~

## const META

~~~~
export declare const META: {
    readonly protocolVersion: 'io.modelcontextprotocol/protocolVersion';
    readonly clientInfo: 'io.modelcontextprotocol/clientInfo';
    readonly clientCapabilities: 'io.modelcontextprotocol/clientCapabilities';
    readonly serverInfo: 'io.modelcontextprotocol/serverInfo';
    readonly logLevel: 'io.modelcontextprotocol/logLevel';
};
~~~~

## const ERRORS

~~~~
export declare const ERRORS: {
    readonly parse: -32700; readonly invalidRequest: -32600; readonly methodNotFound: -32601; readonly invalidParams: -32602; readonly internal: -32603;
    readonly headerMismatch: -32020; readonly missingRequiredClientCapability: -32021; readonly unsupportedProtocolVersion: -32022;
};
~~~~

## interface RpcError

~~~~
export interface RpcError { code: number; message: string; data?: unknown }
~~~~

## interface Refusal

~~~~
export interface Refusal { status: number; error: RpcError }
~~~~

## type HeaderReader

~~~~
export type HeaderReader = ((name: string) => string | string[] | undefined | null) | Record<string, string | string[] | undefined>;
~~~~

## function requestVersion

The version a 2026-07-28 request names in params.\_meta, or null (a handshake-era request).

~~~~
export declare function requestVersion(params: unknown): string | null;
~~~~

## function checkRequest

null when the request may be served; else a 400 (UnsupportedProtocolVersion -32022 or HeaderMismatch -32020).

~~~~
export declare function checkRequest(opts: { header: HeaderReader; method: string; params: unknown; versions?: readonly string[]; supported?: string[] }): Refusal | null;
~~~~

## function complete

~~~~
export declare function complete<T extends object>(result: T): T & { resultType: 'complete' };
~~~~

## function listResult

~~~~
export declare function listResult<K extends string, T>(key: K, items: T[], opts?: { ttlMs?: number; cacheScope?: 'public' | 'private'; nextCursor?: string }): { resultType: 'complete'; ttlMs: number; cacheScope: 'public' | 'private'; nextCursor?: string } & Record<K, T[]>;
~~~~

## function discoverResult

~~~~
export declare function discoverResult(opts: { serverInfo?: { name: string; version: string; title?: string }; capabilities?: object; instructions?: string; versions?: string[]; ttlMs?: number }): {
    resultType: 'complete'; supportedVersions: string[]; capabilities: object; instructions?: string; ttlMs: number; cacheScope: 'public'; _meta?: Record<string, unknown>;
};
~~~~

## function methodNotFound

~~~~
export declare function methodNotFound(method: string): Refusal;
~~~~

## function legacyVersion

~~~~
export declare function legacyVersion(asked: unknown, opts?: { supported?: readonly string[]; fallback?: string }): string;
~~~~

## function modernRequest

~~~~
export declare function modernRequest(opts: { id?: string | number; method: string; params?: Record<string, unknown>; version?: string; clientInfo?: { name: string; version: string }; capabilities?: object }): {
    headers: Record<string, string>; body: { jsonrpc: '2.0'; id?: string | number; method: string; params: Record<string, unknown> };
};
~~~~

## function isComplete

~~~~
export declare function isComplete(result: unknown): boolean;
~~~~
