MCP design reference โ
This is the provided fallback MCP design for Part 5, MCP fundamentals. If you run out of time during the design exercise, adopt this mapping and checklist so you are ready for the Part 6 server build.
Capability mapping โ
| Capability | MCP concept | Description | Inputs | Output | Read-only / approval |
|---|---|---|---|---|---|
| Package data | resource | Current packages with status, route, and condition | read-only | ||
| Route data | resource | Routes and the packages currently on each | read-only | ||
| Data schema | resource | The shape of package, order, and route records | read-only | ||
| Policy document | resource | Shipping and condition rules the agent must respect | read-only | ||
| Investigate a delayed package | prompt | Reusable workflow: gather status, route, and recent history for one package | |||
list_packages | tool | Return all package IDs in the system | โ | package ID list | read-only |
lookup_package | tool | Return status, route, condition, and fragile flag for a package | package_id: string | formatted package record | read-only |
lookup_order_status | tool | Return delivery status and delay details for a package | package_id: string | status + delay fields | read-only |
lookup_route | tool | Return route details and driver for a route ID | route_id: string | route record | read-only |
update_package_status | tool | Change a package's status | package_id: string, status: enum | { ok: boolean } | approval-required |
Design checklist โ
- At least five capabilities are mapped to an MCP resource, prompt, or tool.
- Read-oriented context (package data, route data, schema, policy) is mapped to resources, not tools.
- At least one reusable workflow is mapped to a prompt.
- At least three tools have named inputs and an expected output.
- Every operation is marked read-only or approval-required.
- State-changing operations are marked approval-required for the HITL segment in Part 10.
- Each description is written for the agent, not a human reader.
Back to Part 5, MCP fundamentals ยท Continue to Part 6, Build the MCP server