@xemahq/resolved-mcp-client

Canonical transport for resolver-issued MCP attachments

Overview

This package provides a typed JSON-RPC client for an MCP attachment that has already been resolved for a caller. It validates MCP envelopes and tool results at the transport boundary and exposes explicit failure codes instead of degrading malformed responses.

When to use it

• Use it when a trusted resolver has supplied an MCP attachment and your runtime needs to list or call its tools programmatically.

Installation

pnpm add @xemahq/resolved-mcp-client

Usage

import { ResolvedMcpClient } from '@xemahq/resolved-mcp-client';

const client = new ResolvedMcpClient();
const { tools } = await client.listTools(attachment);
const result = await client.callTool(attachment, {
  name: tools[0].name,
  arguments: {},
  requestId: operationId,
});

Peer requirements

• @xemahq/kernel-contracts >= 26

License

Apache-2.0 © Xema — xema.dev