ERPBridge SDK
The ERPBridge SDK is a TypeScript client library for agentic AI workflow applications. Use @erpbridge/sdk to call MCP tools by exact name, invoke tools over REST, collect logs, read metrics, check health, and manage the cache and tool registry through one typed facade.
Features
- Built-in MCP client for ERPBridge Server — connect, discover, and call tools programmatically
- Exact-name tool proxy — call registered tools such as
list_employeesdirectly, with argument validation against each tool's input schema - Log aggregation — collect and inspect bridge logs from your application
- View metrics — read Prometheus metrics from the server, raw or parsed
- Health and cache — server health checks and cache statistics or flushing
- Tool registry and direct invoke — manage registered tools over REST and call them without an MCP session
- Typed errors — a single
ErpbridgeErrorhierarchy across the whole surface - Consume-only authentication — send administrator-provisioned bearer tokens with per-surface routing
- Dual build — ESM + CJS, Node.js >= 20, dependency-light
- Browser MCP and tools — use the ESM MCP client and exact-name tool proxy in
browser bundles when the server's
/mcp/CORS policy is configured
Get started
| Page | What it covers |
|---|---|
| Installation | Requirements and package managers |
| quickstart | First tool call in five lines |
| MCP tools | The MCP client, the tool proxy, and the registry |
| Logs and metrics | Log streaming, metrics, health, and cache |
| Authentication | Bearer credentials, scopes, and auth errors |
| Upgrade guide | Migrate MCP result handling and active credentials |
| API reference | Every public export, the client facade, and the error hierarchy |
Status
@erpbridge/sdk is currently v1.1.0, released independently from the ERPBridge Server and bridgectl version line. It ships the MCP client, configurable MCP transport retries, exact-name tool proxy, logs, metrics, health, cache, tool registry, direct invoke, and consume-only authentication. See the SDK CHANGELOG for release details.
Package
The @erpbridge/sdk package is published on npm with signed provenance (SLSA), dual ESM + CJS builds, and TypeScript declarations for both. Install it from the installation page.
Repository
The ERPBridge SDK is developed in the erpbridge-sdk repository. The Agent guide describes the plan-first workflow, TDD, quality gates, release pipeline, and code conventions for AI agents and contributors.