Conduit Agentic Commerce MCP server

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.

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).

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

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.

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

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

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.

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.

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.

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.

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

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

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

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

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

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

Register an agent (public key + optional payment rails seed + default destination). BEFORE calling: read ~/.conduit/credentials.json (or CONDUIT_CREDENTIALS_PATH) — if it exists, reuse that agent_id and do NOT register again. Hosts without filesystem (Claude app / remote MCP): do not invent a new profile — give the human `jq -r .agent_id ~/.conduit/credentials.json` and continue from their paste. AFTER success: immediately write that file with version, agent_id, public_key, and the private key you generated (chmod 0600); if you cannot write disk, give a mkdir/cat/chmod terminal command instead. Then set default_destination with postcode via update_agent_profile before search_supply. Returns agent_id + persist guide.

Two-step re-auth. Prefer loading agent_id + private_key from ~/.conduit/credentials.json (or CONDUIT_CREDENTIALS_PATH): call with agent_id only → sign nonce with private_key → call again with agent_id + nonce + signature. Hosts WITHOUT filesystem (Claude app / remote MCP): do NOT invent ES256/openssl — (1) ask human `jq -r .agent_id ~/.conduit/credentials.json`; (2) call with agent_id only; (3) forward response `terminal` verbatim; (4) paste their JSON into the second call. Never paste private_key into chat. Do not create_agent_profile if credentials already exist.

Patch handle, payment rails, default destination, business profile, or preferences. Same fields as create_agent_profile; only pass what changes.

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.

Multi-provider discovery. Always pass agent_id for mandate-aware badges. Decision fields: badge + action (and recommended). Ignore autonomy if present. Carry search_id through get_supply_details / execute_order / submit_feedback. Read badgeCounts, hint, and partial.merchantErrors.

Full normalized product detail for one offer from the search cache. Pass agent_id to refresh badge/action for current mandate state. Catalog deliveryOptions are often empty — for shipping ETA/cost call get_delivery_estimate (non-committing checkout probe). Re-run search_supply if offer_not_in_cache; pass search_id for analytics correlation.

Non-committing checkout probe for authoritative shipping options (etaText, options[], shippingCost) to a destination. Prefer this over execute_order when comparing delivery/price — does not create a Conduit order. Requires agent_id (uses default_destination with postcode) or country. Shopify Global Catalog offers only in v0.

Complete an order only when offer badge is payable_now (autonomous, needs active AP2 mandate) or handoff (returns continue_url). Handoff responses include billBreakdown (shipping/tax/total) from the merchant checkout — useful after you have chosen an offer; for delivery comparison without creating an order, use get_delivery_estimate first. Do not call for coming_soon, discovery_only, or needs_mandate (request_payment_mandate first). Prefer search recommended / action. Use idempotency_key. handoffQuality full = auto-poll on track_order; degraded = recover via update_order_status.

Create a standing AP2 spend mandate; returns approval_url.

List, update, or revoke AP2 mandates. Update with wider caps returns approval_url (pending human re-approval); narrowing applies immediately.

Resolve refund/chargeback/report paths for an order.

Agent manual status correction or recovery. note required except cancelled. Attach tracking_id, carrier, external_checkout_id, handoff_endpoint to recover degraded handoffs when auto-poll did not wire checkout. Locks agent status when not PENDING; merchant poll will not demote locked status.

Report delivery/quality outcome; updates supplier + agent reputation.

Lifecycle timeline for an order — transitions only (coalesced merchant poll periods). Use track_order for current status and merchant_observed snapshot. When merchant_observed.conflicts_with_agent is true, read events then decide via update_order_status or get_dispute_path.

Honest deal-type-aware order status (never fabricates carrier scans). Triggers handoff poll when checkout ids are wired (~30s throttle). Returns merchant_observed, status_source, agent_status_locked, and recovery hints for degraded handoffs.