# BuyingMesh Procurement API

> Structured supply, quote comparison, ordering and fulfillment infrastructure for buying agents.

## Machine-readable entry points

- API contract: /openapi.yaml
- Agent metadata: /.well-known/agent.json
- MCP endpoint: /mcp
- Product example: /v1/products/FAST-M4-001
- Developer quickstart: /developer-quickstart.md
- Merchant onboarding: /merchant.html

## Capabilities

- Search standard fasteners by SKU, category, MOQ, price, inventory and freshness.
- Retrieve Schema.org JSON-LD with material, size, GTIN, supplier qualifications and lead time.
- Compare supplier quotes for quantity and destination.
- Create orders with idempotency keys.
- Receive tracking and ETA updates by signed webhook.
- Pay per query with x402; settle B2B orders in USDC escrow.

## Rules for agents

- Treat price, inventory and lead time as time-sensitive snapshots.
- Do not place an order without checking MOQ and `dataFreshness`.
- Use `Idempotency-Key` on quote and order mutations.
- Verify `X-YW-Signature` before processing webhooks.
- Surface `confidence` and supplier qualification status to the buyer.
- Start with `/developer-quickstart.md` before requesting production credentials.
- Merchants can submit an onboarding profile at `/merchant.html` and upload a CSV sample for review.