Module: mcp

Type Aliases

McpServerLimits

Ƭ McpServerLimits: Object Limits one session may not exceed.

Type declaration

Name	Type	Description
`callsPerMinute?`	`number`	Requests a session may make each minute. Default 60.
`pollsPerMinute?`	`number`	Status and recovery requests a session may make each minute. Default 30.

McpServerDefinition

Ƭ McpServerDefinition: Object One MCP server: the tools it publishes and how its sessions start.

Type declaration

Name	Type	Description
`description`	`string`	What the server is for, as the console and `bijection mcp describe` show it.
`instructions?`	`string`	How to use the tools together, which every client receives when it connects and an agent reads before its own instructions: what to read first, which tool answers what, what never to do. At most 8 KiB.
`sessions`	`SessionPolicy`	-
`tools`	`Record`<`string`, `ToolDeclaration`>	-
`limits?`	`McpServerLimits`	How many requests each issued session may make a minute. A delegated server declares none: its sessions are admitted per request.

McpServerDeclaration

Ƭ McpServerDeclaration: Readonly<{ name: string ; description: string ; instructions: string | null ; sessions: SessionPolicy ; tools: Readonly<Record<string, ToolDeclaration>> ; limits: Required<McpServerLimits> | null }> A validated server declaration.

McpModuleOptions

Ƭ McpModuleOptions: Object What mcpModule needs beyond the servers themselves.

Type declaration

Name	Type	Description
`access`	`AccessModel`	The application’s access model decides every session’s authority.
`servers`	readonly `McpServerDeclaration`[]	-
`module?`	`string`	The module the bundle is the default export of. Default `mcp`, for `bijection/mcp.ts`.
`authorizationServers?`	readonly `string`[]	For servers whose sessions are delegated: the identity providers a person’s own client signs in with, by issuer URL. The deployment’s auth configuration trusts them; the server advertises them as its authorization servers, and accepts their tokens issued for it.

McpSession

Ƭ McpSession: Object What a function learns about the server session calling it.

Type declaration

Name	Type	Description
`id`	`string`	-
`server`	`string`	-
`actsFor`	{ `type`: `string` ; `key`: `string` } \| `null`	The object the session acts for, or null before verification and for a delegated session, which acts as its person.
`channel`	`string`	-
`expiresAt`	`number` \| `null`	When an issued session ends; null for a delegated one, which ends with its token, within the server’s minutes.

Variables

MAX_INSTRUCTIONS

• Const MAX_INSTRUCTIONS: 8192 The longest a server’s instructions may be, in characters.

Functions

mcpTables

▸ mcpTables(): Object The two coordination tables every server shares. Spread them into the application’s schema. Sessions name who acts for what until when; admissions count each session’s requests in the current minute. Neither holds business data or authority: what a session may do, and whether it is live, is the engine’s own record of it, decided by the access model on every call.

Returns

Object

Name	Type
`mcpSessions`	`TableDefinition`<`VObject`<{ `credential`: `string` ; `evidence`: `null` \| { reference?: string; method: string; } ; `expires_at`: `number` ; `principal`: `string` ; `tools`: { name: string; revision: string; }[] ; `server`: `string` ; `channel`: `string` ; `audience`: `string` ; `acts_for`: `null` \| { type: string; key: string; } ; `started_at`: `number` }, { `server`: `VString`<`string`, `"required"`> ; `credential`: `VString`<`string`, `"required"`> ; `principal`: `VString`<`string`, `"required"`> ; `acts_for`: `VUnion`<`null` \| { `type`: `string` ; `key`: `string` }, [`VNull`<`null`, `"required"`>, `VObject`<{ `type`: `string` ; `key`: `string` }, { `type`: `VString`<`string`, `"required"`> ; `key`: `VString`<`string`, `"required"`> }, `"required"`, `"type"` \| `"key"`>], `"required"`, `"type"` \| `"key"`> ; `audience`: `VString`<`string`, `"required"`> ; `tools`: `VArray`<{ `name`: `string` ; `revision`: `string` }[], `VObject`<{ `name`: `string` ; `revision`: `string` }, { `name`: `VString`<`string`, `"required"`> ; `revision`: `VString`<`string`, `"required"`> }, `"required"`, `"name"` \| `"revision"`>, `"required"`> ; `channel`: `VString`<`string`, `"required"`> ; `evidence`: `VUnion`<`null` \| { `reference`: `undefined` \| `string` ; `method`: `string` }, [`VNull`<`null`, `"required"`>, `VObject`<{ `reference`: `undefined` \| `string` ; `method`: `string` }, { `method`: `VString`<`string`, `"required"`> ; `reference`: `VString`<`undefined` \| `string`, `"optional"`> }, `"required"`, `"method"` \| `"reference"`>], `"required"`, `"method"` \| `"reference"`> ; `started_at`: `VFloat64`<`number`, `"required"`> ; `expires_at`: `VFloat64`<`number`, `"required"`> }, `"required"`, `"credential"` \| `"evidence"` \| `"expires_at"` \| `"principal"` \| `"tools"` \| `"server"` \| `"channel"` \| `"audience"` \| `"acts_for"` \| `"started_at"` \| `"evidence.method"` \| `"evidence.reference"` \| `"acts_for.type"` \| `"acts_for.key"`>, { `by_principal`: [`"principal"`, `"_creationTime"`] ; `by_server`: [`"server"`, `"started_at"`, `"_creationTime"`] }, {}, {}, `false`, {}>
`mcpAdmissions`	`TableDefinition`<`VObject`<{ `key`: `string` ; `count`: `number` ; `window`: `number` ; `polls`: `number` }, { `key`: `VString`<`string`, `"required"`> ; `window`: `VFloat64`<`number`, `"required"`> ; `count`: `VFloat64`<`number`, `"required"`> ; `polls`: `VFloat64`<`number`, `"required"`> }, `"required"`, `"key"` \| `"count"` \| `"window"` \| `"polls"`>, { `by_key`: [`"key"`, `"_creationTime"`] }, {}, {}, `false`, {}>

defineMcpServer

▸ defineMcpServer(name, definition): McpServerDeclaration Declare one MCP server, served at /mcp/<name>. Throws on an inconsistent declaration.

Parameters

Name	Type
`name`	`string`
`definition`	`McpServerDefinition`

Returns

McpServerDeclaration

mcpSession

▸ mcpSession(ctx): Promise<McpSession | null> The server session calling this query or mutation, or null for every other caller. A tool with no arguments learns its object here; the model never names it. The engine admits a session’s principal only while the session is live, so a session read here is. This reads the session only: the caller’s rules still decide every row.

Parameters

Name	Type
`ctx`	`any`

Returns

Promise<McpSession | null>

mountMcp

▸ mountMcp(http, servers): void Mount every server and its OAuth protected-resource metadata on the application’s router.

Parameters

Name	Type
`http`	`HttpRouter`
`servers`	`object`

Returns

void

mcpModule

▸ mcpModule(options): Record<string, unknown> & { isFunctionBundle: true } The functions behind every declared server, as one function bundle: export it as the default of bijection/mcp.ts.

Parameters

Name	Type
`options`	`McpModuleOptions`

Returns

Record<string, unknown> & { isFunctionBundle: true }

Get Started

Use-case atlas

Platform

Data and Operations

Guides

Client Libraries

Tools

API Reference

Type Aliases

McpServerLimits

Type declaration

McpServerDefinition

Type declaration

McpServerDeclaration

McpModuleOptions

Type declaration

McpSession

Type declaration

Variables

MAX_INSTRUCTIONS

Functions

mcpTables

Returns

defineMcpServer

Parameters

Returns

mcpSession

Parameters

Returns

mountMcp

Parameters

Returns

mcpModule

Parameters

Returns

​Type Aliases

​McpServerLimits

​Type declaration

​McpServerDefinition

​Type declaration

​McpServerDeclaration

​McpModuleOptions

​Type declaration

​McpSession

​Type declaration

​Variables

​MAX_INSTRUCTIONS

​Functions

​mcpTables

​Returns

​defineMcpServer

​Parameters

​Returns

​mcpSession

​Parameters

​Returns

​mountMcp

​Parameters

​Returns

​mcpModule

​Parameters

​Returns

Type Aliases

McpServerLimits

Type declaration

McpServerDefinition

Type declaration

McpServerDeclaration

McpModuleOptions

Type declaration

McpSession

Type declaration

Variables

MAX_INSTRUCTIONS

Functions

mcpTables

Returns

defineMcpServer

Parameters

Returns

mcpSession

Parameters

Returns

mountMcp

Parameters

Returns

mcpModule

Parameters

Returns