PRECONDITION — CALL ONLY after the requester supplied what the physical object must accomplish at intent.purpose (or requirement). If absent, ask the requester first; never infer purpose and do not invoke this tool yet. Build a synchronous, deterministic supplier request package from the requirement the caller already holds. The package follows the open a2a2p supplier profile and its versioned output schema at https://a2a2p.com/schema/supplier-package, preserves provenance, carries quote-stage screening, and names every quote-critical gap instead of inventing values. Every emitted package carries a reproducible SHA-256 artifact_identity over the exact package content, excluding the identity field itself. The digest proves content identity only; it does not prove supplier receipt, a quote, payment, fabrication, or physical correctness. The package also returns a deterministic quote_stage_eligibility receipt. Quote-stage eligibility lane flat_laser_cut_5052_h32: aluminum_5052_h32, laser_cutting, quantity 1-5, 10-300 mm by 10-300 mm, verified HTTPS DXF, raw finish, no secondary or regulated requirements, US delivery, and total budget up to USD 500. Classification sets no fee and grants no payment, supplier-contact, quote-acceptance, order, or fabrication authority. If no package can be built, MCP and REST share the a2a2p.supplier-package-rejection contract: a closed reason_code, exact vocabulary version, and deterministic next_action only where repair is sufficient. A purpose_required rejection includes an a2a2p.argument-repair operation that preserves the caller's existing arguments, requires the caller's own purpose statement, and forbids inference. An explicit specification.assembly with two or more parts returns decomposition_required and no package; one package represents one fabricated part. This is a stateless data transformation only: it stores no requirement, contacts no supplier or provider, requests no external quote, and creates no order, payment, or fabrication authority.
View input schema
{
"type": "object",
"properties": {
"requirement": {
"type": "string",
"minLength": 1,
"pattern": "\\S",
"description": "Plain-language description of the physical need. Maps to intent.purpose. Include function, dimensions, materials, load/performance requirements, environment, and interfaces where known."
},
"quantity": {
"type": "integer",
"description": "Number of units needed. Maps to intent.quantity.",
"minimum": 1
},
"constraints": {
"type": "string",
"description": "Hard constraints: tolerances, certifications, materials to avoid, size/weight limits. Maps to intent.functional_requirements."
},
"budget_usd": {
"type": "number",
"description": "Approximate budget in USD. Maps to intent.budget_envelope."
},
"deadline": {
"type": "string",
"description": "Required delivery date or timeframe. Maps to intent.timeline."
},
"contact": {
"type": "string",
"description": "Optional email or callback endpoint for quote delivery."
},
"business_context": {
"type": "string",
"description": "Optional business requirements (expected volumes, cost targets, ROI constraints). If provided, the quote includes a business case."
},
"callback_url": {
"type": "string",
"description": "Optional HTTPS URL. When the quote is ready, a2a2p POSTs it as JSON to this URL."
},
"intent": {
"type": "object",
"description": "Layer 1 — the problem. What the physical matter needs to DO. Use this for intent-driven requests where the agent describes purpose and a2a2p recommends solutions.",
"properties": {
"purpose": {
"type": "string",
"minLength": 1,
"pattern": "\\S",
"description": "What the physical matter needs to accomplish (one non-whitespace line minimum, required)."
},
"environment": {
"type": "array",
"items": {
"type": "string",
"enum": [
"indoor",
"outdoor",
"saltwater",
"uv_exposure",
"high_temp",
"low_temp",
"vibration",
"food_contact",
"medical",
"aerospace",
"high_humidity",
"chemical_exposure"
]
},
"description": "Conditions the part must survive."
},
"functional_requirements": {
"type": "object",
"description": "Structured physical constraints.",
"properties": {
"max_load": {
"description": "Maximum load magnitude. A Newton scalar is preferred; { value, unit: \"N\" } remains accepted.",
"oneOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"type": "number",
"exclusiveMinimum": 0
},
"unit": {
"type": "string",
"description": "Force unit; N is canonical."
}
}
}
]
},
"load_case": {
"type": "object",
"description": "Optional bounded structural sanity check. State an explicit static point-load model and rectangular section; height_mm is the bending direction.",
"required": [
"model",
"load_n",
"span_mm",
"section"
],
"properties": {
"model": {
"type": "string",
"examples": [
"cantilever_end_load",
"simply_supported_center_load"
],
"description": "Supported deterministic models: cantilever_end_load or simply_supported_center_load. Other values are preserved but reported as unsupported."
},
"load_n": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Static point-load magnitude in Newtons."
},
"span_mm": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Beam span in millimetres."
},
"section": {
"type": "object",
"required": [
"width_mm",
"height_mm"
],
"properties": {
"width_mm": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Rectangular section width in millimetres."
},
"height_mm": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Rectangular section depth in the bending direction, millimetres."
}
}
},
"elastic_modulus_gpa": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Optional requester-supplied Young's modulus. Otherwise the matched material handbook reference is used and labeled."
},
"max_deflection_mm": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Optional requester-supplied acceptance limit."
},
"allowable_stress_mpa": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Optional requester-supplied design allowable; never inferred from handbook yield."
},
"allowable_shear_stress_mpa": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Optional requester-supplied transverse-shear design allowable; evaluated independently and never inferred from handbook data."
},
"yield_strength_mpa": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Optional exact grade/condition/product-form datasheet value supplied by the requester."
},
"minimum_factor_of_safety": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Optional acceptance criterion; evaluated only with requester-supplied yield_strength_mpa."
}
}
},
"max_weight": {
"type": "number",
"description": "Maximum weight of the part in kg."
},
"flexibility": {
"type": "string",
"enum": [
"rigid",
"semi_rigid",
"flexible"
],
"description": "Rigid, semi-rigid, or flexible."
},
"thermal_range": {
"type": "object",
"properties": {
"min": {
"type": "number"
},
"max": {
"type": "number"
}
},
"description": "Operating temperature range in Celsius."
},
"electrical": {
"type": "string",
"description": "Electrical properties (conductive, insulating, etc.)."
}
}
},
"geometric_envelope": {
"type": "object",
"properties": {
"max_x": {
"type": "number"
},
"max_y": {
"type": "number"
},
"max_z": {
"type": "number"
}
},
"description": "Max bounding box in mm if known."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "How many units needed."
},
"timeline": {
"type": "string",
"description": "When needed ('2 weeks', 'ASAP', 'by March')."
},
"budget_envelope": {
"type": "object",
"properties": {
"max": {
"type": "number"
},
"type": {
"type": "string",
"enum": [
"per_unit",
"total"
]
}
},
"description": "Budget if known."
},
"priority": {
"type": "string",
"enum": [
"cost",
"speed",
"strength",
"precision",
"aesthetics"
],
"description": "What matters most when tradeoffs arise."
},
"compliance": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required standards or certifications."
},
"ship_to_region": {
"type": "string",
"description": "Delivery region. When present, a supplier package asks for a price including freight to it; when absent, freight is excluded."
},
"quote_by": {
"type": "string",
"description": "Date a quote is needed by."
},
"inspection_documents": {
"type": "string",
"description": "Inspection or material documents required with the parts, or \"none required\"."
},
"alternates_acceptable": {
"type": [
"boolean",
"string"
],
"description": "Whether a supplier may propose a different material, process or stock size."
}
}
},
"specification": {
"type": "object",
"description": "Layer 2 — the solution. What the physical matter IS. Populate what is known. Precise specifications produce faster, tighter quotes. Controlled vocabularies are preferred but open values are accepted.",
"properties": {
"part_type": {
"type": "string",
"enum": [
"bracket",
"housing",
"gear",
"shaft",
"enclosure",
"fixture",
"adapter",
"structural",
"custom"
],
"description": "Category of physical part."
},
"material": {
"type": "string",
"description": "Material (controlled vocab preferred: aluminum_6061, steel_304, PLA, ...; open values accepted)."
},
"process": {
"type": "string",
"enum": [
"cnc_milling",
"cnc_turning",
"cnc_routing",
"fdm_3d_print",
"sla_3d_print",
"sls_3d_print",
"sheet_metal",
"laser_cutting",
"casting",
"injection_molding",
"extrusion"
],
"description": "Manufacturing process."
},
"dimensions": {
"type": "object",
"description": "Critical dimensions with units, or bounding box."
},
"tolerance_class": {
"type": "string",
"enum": [
"coarse",
"medium",
"fine",
"precision"
],
"description": "Required precision: coarse, medium, fine, precision."
},
"surface_finish": {
"type": "string",
"enum": [
"as_machined",
"polished",
"brushed",
"bead_blasted",
"raw"
],
"description": "Surface finish."
},
"post_processing": {
"type": "array",
"items": {
"type": "string",
"enum": [
"anodizing",
"powder_coat",
"painting",
"none"
]
},
"description": "Post-processing treatments."
},
"design_files": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"format": {
"type": "string",
"enum": [
"stl",
"step",
"stp",
"dxf",
"pdf"
]
},
"role": {
"type": "string",
"enum": [
"geometry",
"drawing",
"reference"
]
}
},
"required": [
"url",
"format"
]
},
"description": "Temporary or externally hosted manufacturing file references ({url, format, optional role}). Accepted upload aliases: stl, step, stp, dxf, pdf; shared downstream ceiling: 8388608 bytes."
},
"tolerances": {
"type": "object",
"description": "Exact numeric tolerance callouts keyed by feature. They govern over tolerance_class for the named feature. Forms: a positive number (plus or minus that amount); { nominal, plus, minus }; or a stock-relative rule { relative_to: \"measured_stock_thickness\", allowance_mm, plus, minus, fit_class } for joints cut to the sheet actually used.",
"additionalProperties": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"properties": {
"value": {
"type": "number",
"exclusiveMinimum": 0
},
"nominal": {
"type": "number",
"exclusiveMinimum": 0
},
"unit": {
"type": "string"
},
"plus": {
"type": "number",
"minimum": 0
},
"minus": {
"type": "number",
"minimum": 0
},
"relative_to": {
"type": "string",
"enum": [
"measured_stock_thickness"
]
},
"allowance_mm": {
"type": "number",
"description": "Added to the measured stock thickness; negative for an interference fit."
},
"fit_class": {
"type": "string",
"description": "Optional label such as push_fit or press_fit."
}
}
}
]
}
},
"sheet_stock": {
"type": "object",
"description": "The sheet a flat part is cut from. For plywood a supplier needs face_grade, nominal and actual thickness, ply_count and glue_class; for MDF, grade and thickness. Missing facts are asked, never chosen by a2a2p.",
"properties": {
"nominal_thickness_mm": {
"type": "number",
"exclusiveMinimum": 0
},
"actual_thickness_mm": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "object",
"properties": {
"min": {
"type": "number"
},
"max": {
"type": "number"
}
}
}
],
"description": "Measured or specified actual thickness. Stock-relative tolerances also satisfy this: the joint follows the sheet."
},
"face_grade": {
"type": "string",
"description": "Face/back veneer grade, for example B/BB."
},
"ply_count": {
"type": "integer",
"minimum": 1
},
"glue_class": {
"type": "string",
"description": "Bond class, for example EN 314-2 class 1 (interior) or class 3 (exterior)."
},
"grade": {
"type": "string",
"description": "Panel grade for MDF and similar boards, for example standard or moisture_resistant."
},
"grain_direction": {
"type": "string",
"enum": [
"along_x",
"along_y",
"not_applicable"
],
"description": "Face-grain direction relative to the declared X/Y dimensions."
}
}
},
"cutting": {
"type": "object",
"description": "Cutting-tool constraints for routed or milled profiles.",
"properties": {
"tool_diameter_mm": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Smallest cutter that will be used. Inside corners and holes with a smaller radius are flagged against the measured DXF."
},
"inside_corner_relief": {
"type": "string",
"enum": [
"dogbone",
"t_bone",
"in_file",
"not_required"
],
"description": "dogbone or t_bone: the supplier adds that relief; in_file: relief is already drawn; not_required: tool-radius corners are acceptable."
}
}
},
"notes": {
"type": "string",
"maxLength": 4000,
"description": "Manufacturing notes for the supplier. Carried verbatim into the supplier package; never parsed into facts. State anything a check must use in its structured field."
}
}
},
"rejected_alternatives": {
"type": "array",
"description": "Options already considered and ruled out. Prevents re-suggesting and builds the learning corpus.",
"items": {
"type": "object",
"properties": {
"field": {
"type": "string",
"description": "Which spec field (material, process, part_type, etc.)."
},
"value": {
"type": "string",
"description": "The rejected option."
},
"reason": {
"type": "string",
"description": "Why it was rejected."
}
}
}
},
"delivery": {
"type": "object",
"description": "Optional caller-declared routing context carried into the returned package. a2a2p does not send it anywhere.",
"properties": {
"accountable_principal": {
"type": "string",
"maxLength": 300,
"description": "A named person or legal entity accountable for the request."
},
"principal_kind": {
"type": "string",
"enum": [
"organization",
"person"
]
},
"registered_address": {
"type": "string",
"maxLength": 500,
"description": "Required for an organization principal; its verifiable registered address."
},
"reply_to": {
"type": "string",
"maxLength": 500,
"description": "A reachable business email or HTTPS reply route."
}
},
"required": [
"accountable_principal",
"principal_kind",
"reply_to"
],
"additionalProperties": false
}
},
"required": [],
"anyOf": [
{
"required": [
"requirement"
]
},
{
"required": [
"intent"
],
"properties": {
"intent": {
"required": [
"purpose"
]
}
}
}
],
"description": "PRECONDITION: provide a requester-supplied non-whitespace purpose at intent.purpose or requirement before invoking. If purpose is absent, ask what the physical object must accomplish; do not infer it and do not call this tool yet.",
"examples": [
{
"intent": {
"purpose": "Hold an indoor sensor enclosure against a vertical rail without drilling."
}
}
]
}