MCP (LLM tool surface)
Provide a “tool family” interface so chatbots/agents can call VMSAgent safely. The VMS chatbot navigates the system of record; VMSAgent creates the Intent ID, plans, preflights, and publishes.
Tools
Core MCP tools (family)
| Family | Tool | Description |
|---|---|---|
| Intent | intent_create | Initializes a record; returns stable intent_id. |
| Intent | intent_patch | Updates the record with diagnostics/routing/admin. |
| Routing | plan_generate | Applies Channel Map to identify target VMS/destination. |
| Routing | mapping_preflight | Validates Intent vs platform requirements; returns enrichment gaps. |
| Execution | adapter_publish | Idempotent write to VMS; records external IDs + receipt. |
Patterns
LLM-readiness guardrails
State guardrails
Minimum viable intent for each transition. Overrides are explicit events in timeline.
Enrichment loop
If target_system needs fields intent lacks, emit enrichment_request rather than failing publish.
Passthrough with anchors
Allow raw platform calls, but always attach intent_id + version + rationale in timeline.