@octoryn/mcp

Governed Model Context Protocol client bridge for Octoryn and Reef.

import { connectOctorynMcp } from "@octoryn/mcp";

const mcp = await connectOctorynMcp({
  url: "https://tools.example.com/mcp",
  accessToken: () => identity.getShortLivedToken(),
  allowedTools: ["search_policy", "read_patient"],
});

const tools = await mcp.toolDefinitions();
const result = await mcp.callTool("search_policy", { query: "AU-PHI-001" });

The bridge uses the official MCP v1.30 Streamable HTTP client, paginates tool discovery, refreshes bearer credentials per request, and filters both discovery and invocation through a local allowlist. Tool-level failures remain distinct from protocol errors.

This package performs only explicit single-tool calls. It does not choose a tool, retry a business action, or execute an agent loop; use Reef for governed multi-step execution and approval.