app.aiconduit/conduit

Tools

• agent_authenticate

  Two-step re-auth. Call with agent_id only → ES256-sign nonce → call again with nonce+signature. Prefer keys from ~/.conduit/credentials.json. Do not agent_create if credentials already exist.

  shallow
• agent_create

  Register an agent (ES256 P-256 public JWK JSON string + optional payment rails + destination). BEFORE: read ~/.conduit/credentials.json — if it exists, reuse agent_id (do NOT register again). AFTER: write credentials (version, agent_id, public_key, private_key as JWKs; recommend handle; chmod 0600). Then agent_update with default_destination+postcode before supply_search. Optional friendly_name / human_description / role_description only if the human stated them. Omit handle to auto-generate (e.g. parcel-watcher-12).

  shallow
• agent_notify

  Email Hub users in this agent’s linked organization (never addresses outside the org). to=all or { user_id } / { role } / { email } matching agent_organization members. Optional actions (Hub URLs only), severity, idempotency_key. Channel is email.

  shallow
• agent_organization

  Read the linked organization (name, slug, country, default address) for an agent. Returns org_not_linked when organization_id is unset — dashboard claim/join is not released yet; do not invent join_org.

  shallow
• agent_outreach

  Email outside addresses (suppliers, carriers). to is a string email, { email }, or { emails } (max 5). Not to=all and not a Hub user_id / role — those are agent_notify. Linked agents set Reply-To to an org member (default OWNER). No action buttons. Channel is email.

  shallow
• agent_report_issue

  Report unexpected tool errors or confusing Conduit outcomes for AX review (agent_report_issue — not order_feedback). Pass message (required), optional kind=bug|confusing|wrong_data|blocked, plus agent_id, tool, error, detail, search_id, order_id, session_id, and/or context. Dedupes open reports with the same tool+error+correlation. Does not change reputation.

  shallow
• agent_update

  Patch handle, rails, default_destination (postcode required for ships-to), friendly_name, human_description, role_description, business profile, or preferences.

  shallow
• inventory_levels

  What your organization has on hand, by location, in its own connected system (ERP). Pass skus or query. Every number carries as_of and basis (live | memo | cached) — say how old it is, do not imply it is now. Needs inventory permission. This is your OWN stock; a supplier's stock is supply_availability.

  shallow
• inventory_purchase_order

  After order_execute confirms a supplier order, record the matching DRAFT purchase order in your own system so the books match. Always a draft: a person confirms it there. Idempotent per order_id — calling twice returns the same draft, never a second one. Needs both inventory and checkout permission. Never creates a vendor or a product: lines that match nothing come back as unmatched_lines for a person to add.

  shallow
• inventory_replenishment

  Items below their minimum in your own system, least days of cover first, with what is already inbound and the usual vendor and last price. Each row carries a search_hint: pass its query and quantity straight to supply_search, then supply_availability before ordering. Optional location scopes to one warehouse. Needs inventory permission.

  shallow
• inventory_suppliers

  For items in your own system, the vendors on file and what you last paid, so a quote can be compared against history. Needs inventory permission. Does not contact any vendor.

  shallow
• order_dispute

  Refund/chargeback/report paths for an order. Requires owning agent_id.

  shallow
• order_events

  Lifecycle timeline — transitions only. Pair with order_track. Requires owning agent_id.

  shallow
• order_execute

  Handoff or autonomous checkout. Autonomous needs badge payable_now + active mandate. Use idempotency_key. Prefer supply_delivery when only comparing delivery.

  shallow
• order_feedback

  Attest delivery outcome (outcome=on_time|late|never_arrived|damaged|wrong_item). Requires owning agent_id. Can supersede a system-derived score once; a second agent attestation returns already_recorded. Poor outcomes next→order_dispute. Omit quality/carrier_rating if unknown.

  shallow
• order_list

  List orders for an agent ({ orders }). Optional status or open_only filter.

  shallow
• order_track

  Honest deal-type-aware status (never fabricates carrier scans). Requires owning agent_id.

  shallow
• order_update_status

  Agent manual correction or degraded handoff recovery. note required except cancelled. Owning agent_id required.

  shallow
• payment_mandate

  AP2 spend mandates. action=request (needs scope) → approval_url; list; update (mandate_id+scope); revoke (mandate_id). Widening needs human re-approval; narrowing applies immediately.

  shallow
• payment_methods

  List or enable agent payment methods (action=list|enable) with friendly labels. Defaults: cod + x402. invoice (B2B) is coming_soon. bank_card is handoff-only.

  shallow
• supply_availability

  Whether one offer can fill a quantity: verdict can_fill | split | out_now | unknown, with what is on hand, what is inbound, and as_of + basis. Suppliers choose how precisely they share stock, so the verdict may come from a band or a yes/no rather than a number. fresh=true asks the supplier now (needs agent_id, rate limited per agent and per organization); without fresh it reads the last value. Call this before order_execute on any connector offer.

  shallow
• supply_delivery

  Non-committing checkout probe for shipping ETA/cost. Uses agent default_destination, else linked org default address, or country override.

  shallow
• supply_details

  Full normalized product detail from search cache. For shipping ETA/cost use supply_delivery. Re-run supply_search if offer_not_in_cache.

  shallow
• supply_options

  Lists the selectable options (size, color, pack) for an offer whose has_options=true, with one variant per combination. Each variant carries its OWN supply_id, price and availability: to buy a chosen option, call order_execute with that variant's supply_id, not the one you searched with. Reads the merchant storefront live, so call it only when a person is actually choosing. Returns variants_not_found when the offer is not in cache or the storefront cannot be read. A single-variant product returns options:[] variants:[].

  shallow
• supply_search

  Multi-provider discovery (live REAL merchants by default). Returns a ranked page (default limit=30, max 100) with total/has_more/next_offset. Follow next.args (search_id+offset+limit) to page without re-fanout. Optional fetch_limit (max 300) deepens the upstream pull on new searches. Pass include_sandbox=true only to append DEMO/SANDBOX test merchants at the bottom (testOffer=true). Always pass agent_id for mandate-aware badges. Carry search_id through supply_details / order_execute / order_feedback.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/975b0eae-28af-42a4-a455-9471164a8e54/badge.svg)](https://vouch.tools/servers/975b0eae-28af-42a4-a455-9471164a8e54)