Skip to content

Releases: mcpambassador/client

v0.8.0-beta.1 — First Public Beta

28 Feb 00:22

Choose a tag to compare

Pre-release

MCP Ambassador Client — First Public Beta

The official TypeScript/Node.js client for connecting AI tools to an MCP Ambassador governance server.

What's Included

MCP Protocol Client

  • Full MCP protocol implementation over stdio transport
  • Preshared key + HMAC-SHA256 ephemeral session authentication
  • Automatic session lifecycle (register → heartbeat → deregister)
  • Tool result caching with configurable TTL

CLI Interface

  • Standalone CLI for connecting any MCP-compatible AI tool
  • Environment variable support for IDE integration (VS Code, Cursor, etc.)
  • Configurable heartbeat intervals and cache settings

Security

  • HTTPS validation with configurable enforcement
  • Preshared key authentication with HMAC-SHA256 signed tokens
  • Secure secret masking in logs

Installation

npm install @mcpambassador/client

Or use directly via npx:

npx @mcpambassador/client --server https://your-server:3500 --psk your-key

Quick Start

{
  "mcpServers": {
    "ambassador": {
      "command": "npx",
      "args": [
        "@mcpambassador/client",
        "--server", "https://your-server:3500",
        "--psk", "your-preshared-key"
      ]
    }
  }
}

See the README for full configuration options.

Links


This is a pre-release. APIs may change before 1.0. We welcome feedback via GitHub Issues.