Skip to main content
Version: ERPBridge + bridgectl · v0.5.0-alpha.2

Quickstart

Get ERPBridge running locally in a few minutes.

Prerequisites​

  • Docker, or a local Go toolchain with Go 1.26+
  • A GitHub account for MCP clients such as Claude Desktop or Cursor

1. Start the stack​

Start the full stack
git clone https://github.com/nmdra/ERPBridge.git
cd ERPBridge
docker compose up -d

This starts the following services:

  • erpbridge-server on port 8080
  • mock-erp (mock ERPNext) on port 8081
Redis is optional

The exact-match cache uses a bounded in-memory LRU when Redis is not configured. Set CACHE_MEMORY_MAX_ENTRIES=0 to disable memory-cache storage. See Caching.

2. Verify server health​

Health check
curl http://localhost:8080/mcp/health

Expected response:

Response
{"status":"ok"}

3. Connect an MCP client​

Base URL:

http://localhost:8080/mcp/

See the Connectivity and transport guide for the full handshake and Postman setup.

4. Discover tools​

Request the tool list through the MCP initialize and tools/list lifecycle. You can also use bridgectl:

List registered tools
./bridgectl tool get
Need the CLI?

The complete bridgectl reference lives in its own section — see the bridgectl overview.

5. Call a tool​

Direct invocation
curl -X POST http://localhost:8080/api/tools/invoke \
  -H 'Content-Type: application/json' \
  -d '{"name": "list_employees", "arguments": {}}'

Next steps​