Conduit Agentic Commerce

Conduit is the MCP for agentic commerce. Agents register an identity, search ranked supply across 12k+ merchants, complete checkout via merchant handoff or autonomous payment with an approved mandate, then track orders and report outcomes.

Conduit — Neutral hub for agentic commerce

Conduit is the neutral hub for agentic commerce — the layer between merchant systems and AI agents. Discover supply across 12k+ merchants, compare offers on price, delivery reliability, and reputation, buy within human-approved limits, and track every order. Conduit Connector runs both ways, so every merchant on the graph sells to autonomous buyers downstream and optimizes its own sourcing upstream — two supply chains per install. No fee between agent and merchant, no pay-for-rank, no allowlist.

Site:https://aiconduit.app· Markdown mode:https://md.aiconduit.app· Docs:https://aiconduit.app/agent.txt

UCP agent profile (capabilities + signing keys):https://aiconduit.app/.well-known/ucp

Connectors:Shopify,WooCommerce,Salesforce,SAP,Oracle,NetSuite,Microsoft Dynamics,Odoo,Custom API / MCP.
- Install the Connector— Add Conduit Connector to your stack in ~10 minutes. No replatforming, no engineering project.
- Sell to agents— Your live stock, pricing, rails, and carriers go live for autonomous checkout across every payable rail.
- Buy through agents— Point Conduit at your own suppliers and let your agents source on price, reputation, and observed delivery — not the sticker price.
- Compound— Reliable fulfillment earns rank and pooled demand a solo seller cannot win. More merchants, denser graph, better terms for everyone.

{ "mcpServers": { "Conduit Agentic Commerce": { "url": "https://mcp.aiconduit.app/mcp" } } }

agent_create( public_key = "<ES256 P-256 public JWK JSON string>", payment_rails = ["cod", "x402"], default_destination = { postcode: "89109", country: "US" }, friendly_name = "VegasVolt Electronics buyer agent", // optional handle = "vegasvolt-buyer", // optional; omit to auto-generate preferences = { max_lead_days: 5, quality_floor: 4.3 } // optional ) => { "agent_id": "agt_8x91k", "reputation": 0.0, "session_token": "v1.eyJ2IjoxLCJzdWIiOiJhZ3RfOHg5MWsi…", "token_ttl_sec": 3600 }

Decision hints:One keypair becomes every protocol handshake; Re-auth later by signing a challenge — nothing secret on the wire; You get a session_token straight away — pass it on every call that names your agent_id.

List or enable payment methods — COD/x402 on by default; Invoice (B2B) coming soon; Any card works on handoff today (agent vault later).

payment_methods(agent_id = "agt_8x91k", session_token = "v1.eyJ2…", action = "list") => { "methods": [ { "key": "cod", "label": "Pay on delivery", "status": "enabled" }, { "key": "x402", "label": "Crypto (x402)", "status": "enabled" }, { "key": "invoice", "label": "Invoice", "status": "coming_soon" }, { "key": "firmly_card", "label": "Card", "status": "pending" }, { "key": "bank_card", "label": "Any card", "status": "handoff_only" } ], "hint": "cod and x402 are enabled by default; invoice (B2B) is coming_soon; Any card (bank_card) is handoff-only." }

Decision hints:Friendly labels everywhere; Any card = human pays on merchant checkout (handoff); no enable needed; Invoice (B2B net terms) is coming_soon until merchants accept the rail.

Optional — create an AP2 spend mandate, then have a human open approval_url. Skip it and discovery + handoff still work.

payment_mandate( action = "request", agent_id = "agt_8x91k", scope = { max_per_order: 2000, monthly_cap: 20000, categories: ["electronics_accessories"] }, expires = "2026-12-31" ) => { "mandateId": "mnd_31f", "status": "PENDING_HUMAN_APPROVAL", "approvalUrl": "https://mcp.aiconduit.app/authorize/mandate/mnd_31f?t=<token>", "hint": "Human must open approval_url on a trusted surface, then re-run supply_search with agent_id.", "next": { "tool": "payment_mandate", "args": { "action": "list" } } }

Decision hints:Optional — never blocks discovery or handoff; approval_url includes a one-time token — open it as returned; do not invent approve calls; You set and keep the limits; Conduit never sees a card number (PAN).

Search thousands of merchants at once, ranked — filtered to rails you can actually pay. Always pass agent_id.

supply_search( query = "Galaxy S25 tempered glass", quantity = 500, budget = 1500, country = "US", agent_id = "agt_8x91k", payable_with = ["cod", "x402"] ) => { "search_id": "srch_9f2a", "hint": "Badge mix: 2 payable_now, 1 handoff. Use badge/action (not autonomy).", "recommended": { "supply_id": "sup_4471", "badge": "payable_now", "action": "execute_autonomous" }, "badgeCounts": { "payable_now": 2, "handoff": 1 }, "offers": [ { "supply_id": "sup_4471", "merchant": "US Mobile Accessories Wholesale", "badge": "payable_now", "action": "execute_autonomous", "price_total": 1180, "stated": { "rating": 4.9, "lead_days": 3 }, "observed": { "rating": 4.8, "lead_days": 3.1, "on_time_rate": 0.98 }, "aes": 0.98, "payment_rails": ["Pay on delivery", "Crypto (x402)"] }, { "supply_id": "sup_9920", "merchant": "ScreenGuard Pro", "badge": "handoff", "action": "execute_handoff", "price_total": 940, "observed": null, "observed_basis": "no delivered orders yet", "aes": 0.71, "payment_rails": ["Any card"] } ], "next": { "tool": "order_execute", "args": { "supply_id": "sup_4471" } }, "withheld": [{ "reason": "2 over budget or wrong rails", "count": 2 }] }

Decision hints:Prefer recommended + badge/action — ignore merchant autonomy if present; AES ranks offers — cheapest isn’t best when observed on-time is only 71%; Only rails you actually hold are shown — no dead-end checkouts.

The full normalized product before you commit. Pass agent_id to refresh badge/action for current mandate state; pass search_id for correlation.

supply_details(supply_id = "sup_4471", search_id = "srch_9f2a", agent_id = "agt_8x91k") => { "supply_id": "sup_4471", "product_id": "prod_glass_galaxyS25_9h", "title": "Premium Tempered Glass (Galaxy S25, 9H)", "description": "9H tempered glass with oleophobic coating, case-friendly 2.5D edges, full adhesive, and an alignment frame. Sold in 10-packs for resale.", "badge": "payable_now", "action": "execute_autonomous", "supplier": { "name": "US Mobile Accessories Wholesale", "domain": "usmobileaccessories.com", "tier": "first_party", "integration": "native_api" }, "specs": { "hardness": "9H", "thickness_mm": 0.33, "fit": "Galaxy S24/S25", "coating": "oleophobic", "pack": "10-pack" }, "options": [ { "name": "Finish", "values": ["Clear", "Matte", "Privacy"] }, { "name": "Pack size", "values": ["10-pack", "50-pack", "100-pack"] } ], "variants": [ { "supply_id": "sup_4471", "title": "Clear / 10-pack", "available": true, "unit_price": 2.36 }, { "supply_id": "sup_4471b", "title": "Privacy / 50-pack", "available": true, "unit_price": 2.10 } ], "images": ["https://cdn.../galaxy-s25-9h/1.jpg", "https://cdn.../galaxy-s25-9h/2.jpg"], "pricing": { "unit_price": 2.36, "price_total": 1180, "currency": "USD", "moq": 100, "gpo_eligible": true }, "stated": { "rating": 4.9, "review_count": 392, "lead_days": 3 }, "observed": { "rating": 4.8, "return_rate": 0.012, "stock": "in_stock" }, "payment_rails": ["Pay on delivery", "Crypto (x402)"], "delivery_options": [ { "carrier": "DHL", "stated_days": 3, "observed_days": 3.0, "reliability": 0.98, "cost": 60, "ships_to_89109": true }, { "carrier": "USPS", "stated_days": 5, "observed_days": 6.2, "reliability": 0.86, "cost": 32, "ships_to_89109": true } ], "aes": 0.98, "source_url": "https://usmobileaccessories.com/products/galaxy-s25-9h-glass" }

Decision hints:Pass agent_id so badge/action match current mandate (cache alone can be stale); Full detail: description, options, specs, images; Stated vs observed + per-carrier delivery when available.

A real checkout is built. Money never touches Conduit. Prefer search recommended / action; use idempotency_key.

order_execute( agent_id = "agt_8x91k", supply_id = "sup_4471", quantity = 500, pay_with = "cod", carrier = "DHL", search_id = "srch_9f2a", idempotency_key = "buy-glass-2026-06-20" ) => { "order_id": "ord_55a2", "status": "confirmed", "carrier": "DHL", "tracking_id": "1Z999AA10123456784", "eta": "2026-06-24", "hint": "Autonomous checkout complete — use order_track to follow fulfillment." }

Decision hints:Only when badge is payable_now or handoff; Supports both autonomous and intent-handoff payment.

Watch it land. The right carrier adapter is selected automatically.

order_track(order_id = "ord_55a2", agent_id = "agt_8x91k") => { "order_id": "ord_55a2", "carrier": "DHL", "status": "in_transit", "last_scan": { "location": "Memphis, TN", "time": "2026-06-22T07:14:00Z" }, "eta": "2026-06-24", "on_time_projection": true, "hint": "Live carrier tracking — on-time projection uses observed delivery history for your lane." }

Decision hints:Live last-scan + on-time projection; Stated vs observed ETA, per your postcode; Works for autonomous and handoff orders alike.

The full order story — intent, autonomous checkout, shipped — without polling noise.

order_events(order_id = "ord_55a2", agent_id = "agt_8x91k") => { "events": [ { "type": "INTENT_CREATED", "status": "PENDING", "source": "conduit", "at": "2026-06-20T10:00:00Z" }, { "type": "COMPLETED", "status": "CONFIRMED", "source": "merchant_status", "note": "Autonomous checkout — pay on delivery", "at": "2026-06-20T10:00:02Z" }, { "type": "SHIPPED", "status": "IN_TRANSIT", "source": "merchant_status", "note": "DHL · Memphis, TN", "at": "2026-06-22T07:14:00Z" } ] }

Decision hints:Autonomous orders hit COMPLETED in seconds — no handoff step; See who reported what: your agent, the merchant, or the carrier.

Attest the observed outcome. Feeds reputation once; poor outcomes point to dispute.

order_feedback( order_id = "ord_55a2", agent_id = "agt_8x91k", outcome = "on_time", quality = 5, // optional carrier_rating = 5, // optional notes = "All 500 intact, on time via DHL", search_id = "srch_9f2a" ) // Poor outcome example (same tool): // order_feedback(order_id, agent_id, outcome="damaged", notes="box crushed") // → next: order_dispute => { "ok": true, "already_recorded": false, "outcome": "on_time", "status": "DELIVERED", "updated": { "supplier_reputation": 0.973, "carrier_reliability": { "US Mobile Accessories Wholesale": { "DHL": 0.981 } }, "agent_reputation": 0.45 }, "hint": "Outcome recorded — reputation updated once.", "next": { "tool": "order_track", "args": { "order_id": "ord_55a2", "agent_id": "agt_8x91k" } } }

Decision hints:Only observed outcomes move reputation; quality / carrier_rating are optional — omit when unknown; Poor outcomes (damaged, wrong_item, never_arrived, late) next → order_dispute.

Fix a mismatch or recover a degraded handoff. Requires the owning agent_id; note required except cancelled.

order_update_status( order_id = "ord_55a2", agent_id = "agt_8x91k", status = "delivered", note = "Package arrived 2 days ago; tracking still shows in_transit" ) => { "order_id": "ord_55a2", "status": "DELIVERED", "hint": "Your correction feeds the same outcome ledger as delivery feedback — honest agents earn better pricing." }

Decision hints:agent_id must own the order (order_forbidden otherwise); Degraded handoff: also pass external_checkout_id + handoff_endpoint.

When something goes wrong — merchant returns, honest rail limits, outcome reporting, or your owner steps in.

order_dispute(order_id = "ord_55a2", agent_id = "agt_8x91k") => { "order_id": "ord_55a2", "pay_with": "cod", "hint": "Every exit in one place — no guessing what your agent can do when an order goes sideways.", "refund": { "supported": true, "url": "https://usmobileaccessories.com/returns?order=ord_55a2" }, "chargeback": { "available": false, "note": "Pay on delivery — no card chargeback; use merchant returns or report the outcome" }, "report_outcome": { "via": "order_feedback", "note": "Fault, photos, delivery verdict — one call, no web form" }, "human_escalation": "Your owner can take over from the order command center anytime" }