How danniel-jame/k4-l3b-multiagent-mcp-a2a works
This is a Python starter kit for investigating e-commerce complaints through a multi-agent workflow, querying audited MCP evidence, and producing validated case outputs and a submission package. The documented investigation spans entity resolution, customer context, order/product, shipment, payment/refund, policy/source conflicts, and verification. The CLI loads cases, connects the evidence gateway, invokes the solver, and writes outputs and traces. Important limitation: solve_case is intentionally unimplemented, so the documented investigation stages are shown as capabilities, not as a verified agent pipeline or set of tool calls.
Main entry points: cli.py CLI runner · submission.py Submission packager · contracts.py Contract validator · mcp_gateway.py Evidence gateway
Components 22
Run and cases
- CLI runner
src/student_agent/cli.py - Settings
src/student_agent/config.py - Case loader
src/student_agent/cases.py - Case inputs
inputs
Investigation workflow
- Case solver
src/student_agent/workflow.py - Entity resolution
src/student_agent/workflow.py - Customer context
src/student_agent/workflow.py - Order and product
src/student_agent/workflow.py - Shipment analysis
src/student_agent/workflow.py - Payment and refund
src/student_agent/workflow.py - Policy and conflict
src/student_agent/workflow.py - Result verification
src/student_agent/workflow.py
Evidence and trace
- Evidence gateway
src/student_agent/mcp_gateway.py - Contract validator
src/student_agent/contracts.py - JSON schemas
contracts/schemas - Trace writer
src/student_agent/trace.py
Outputs and submission
- Trace artifact
traces - Case outputs
outputs - Submission packager
src/student_agent/submission.py - Submission ZIP
Other components
- Operator
- MCP Gateway
Connections 21
- Operator → CLI runner: runs commands
- CLI runner → Settings: loads settings
- CLI runner → Case loader: loads cases
- Case loader → Case inputs: reads
- CLI runner → Contract validator: creates validator
- CLI runner → Evidence gateway: connects
- Evidence gateway → MCP Gateway: discovers and calls
- Evidence gateway → Contract validator: validates evidence
- Contract validator → JSON schemas: loads schemas
- CLI runner → Trace writer: creates writer
- Trace writer → Contract validator: validates events
- Trace writer → Trace artifact: appends events
- CLI runner → Case solver: invokes per case
- CLI runner → Contract validator: validates outputs
- CLI runner → Case outputs: writes outputs
- Operator → Submission packager: requests packaging
- Submission packager → Case loader: loads case set
- Submission packager → Contract validator: validates artifacts
- Submission packager → Case outputs: reads
- Submission packager → Trace artifact: reads
- Submission packager → Submission ZIP: creates