Guides
MCP bridge
amalgament-builder-mcp is a local stdio MCP bridge for building the company model from an MCP client. The governed HTTP service stays the only authority; the bridge calls it like any other client.
Note The bridge is on main and runs on loopback only. A per-business MCP endpoint is on a development branch, and a hosted MCP endpoint is planned.
Install
pip install -e '.[mcp]'
Configure
The bridge reads three environment variables:
| Variable | What it holds |
|---|---|
AMALGAMENT_HOST_URL |
The local service origin, which must be a loopback address |
AMALGAMENT_BUSINESS |
The business ID |
AMALGAMENT_HOST_AGENT_TOKEN_FILE |
A file holding the agent token |
Then point your MCP client at the amalgament-builder-mcp command.
Tools it exposes
The building tools only: describe, status, inspect_source, sample_records, and the company model draft tools: list_ontology_proposals, inspect_ontology_proposal, propose_ontology_change, note_ontology_proposal, validate_ontology_proposal, request_ontology_review and submit_ontology_proposal. It cannot install a contract, approve or release.