# Conduit Agentic Commerce MCP server

Search multi-merchant supply, checkout, and track orders via MCP.

## Links
- Registry page: https://www.getdrio.com/mcp/app-aiconduit-conduit
- Repository: https://github.com/asmodeoux/conduit
- Website: https://aiconduit.app

## Install
- Endpoint: https://mcp.aiconduit.app/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://mcp.aiconduit.app/mcp

## Tools
- agent_create (Create agent profile) - 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). Endpoint: https://mcp.aiconduit.app/mcp
- agent_authenticate (Authenticate agent) - 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. Endpoint: https://mcp.aiconduit.app/mcp
- agent_update (Update agent profile) - Patch handle, rails, default_destination (postcode required for ships-to), friendly_name, human_description, role_description, business profile, or preferences. Endpoint: https://mcp.aiconduit.app/mcp
- agent_organization (Get 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. Endpoint: https://mcp.aiconduit.app/mcp
- agent_report_issue (Report an 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. Endpoint: https://mcp.aiconduit.app/mcp
- payment_methods (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. Endpoint: https://mcp.aiconduit.app/mcp
- payment_mandate (Payment mandate (AP2)) - 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. Endpoint: https://mcp.aiconduit.app/mcp
- supply_search (Search supply) - 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. Endpoint: https://mcp.aiconduit.app/mcp
- supply_details (Get 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. Endpoint: https://mcp.aiconduit.app/mcp
- supply_delivery (Get delivery estimate) - Non-committing checkout probe for shipping ETA/cost. Uses agent default_destination, else linked org default address, or country override. Endpoint: https://mcp.aiconduit.app/mcp
- order_execute (Execute order) - Handoff or autonomous checkout. Autonomous needs badge payable_now + active mandate. Use idempotency_key. Prefer supply_delivery when only comparing delivery. Endpoint: https://mcp.aiconduit.app/mcp
- order_list (List orders) - List orders for an agent ({ orders }). Optional status or open_only filter. Endpoint: https://mcp.aiconduit.app/mcp
- order_track (Track order) - Honest deal-type-aware status (never fabricates carrier scans). Requires owning agent_id. Endpoint: https://mcp.aiconduit.app/mcp
- order_events (Get order events) - Lifecycle timeline — transitions only. Pair with order_track. Requires owning agent_id. Endpoint: https://mcp.aiconduit.app/mcp
- order_update_status (Update order status) - Agent manual correction or degraded handoff recovery. note required except cancelled. Owning agent_id required. Endpoint: https://mcp.aiconduit.app/mcp
- order_dispute (Get dispute path) - Refund/chargeback/report paths for an order. Requires owning agent_id. Endpoint: https://mcp.aiconduit.app/mcp
- order_feedback (Submit 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. Endpoint: https://mcp.aiconduit.app/mcp

## Resources
- conduit://guides/agent-workflows - Agent Workflow Guide Read before signup, search, mandate, or checkout. Covers credentials persistence (~/.conduit/credentials.json), tool sequences (handoff vs autonomous), search_id / idempotency_key correlation, and hint/next handling. MIME type: text/markdown
- conduit://references/offer-badges - Offer Badge Reference Read when interpreting supply_search or supply_details results. Maps each offer badge (payable_now, needs_mandate, handoff, enable_rail_to_buy, coming_soon, discovery_only) to the correct next tool action. MIME type: text/markdown
- conduit://guides/payment-mandates - AP2 Payment Mandates Read when badge is needs_mandate or for autonomous checkout. Covers payment_mandate request → approval_url → list/update/revoke, widen vs narrow, and mandate_required / out_of_scope recovery. MIME type: text/markdown
- conduit://guides/order-tracking - Order Tracking & Recovery Read after order_execute or when polling status. Covers order_track honesty rules, order_events, degraded handoff recovery, merchant vs agent conflict, and dispute/feedback boundaries. MIME type: text/markdown
- conduit://guides/report-issue - Report MCP / AX Issues Read when stuck after hint/next. Covers agent_report_issue vs order_feedback, kinds (bug|confusing|wrong_data|blocked), correlation fields, and dedupe behavior. Does not change reputation. MIME type: text/markdown

## Prompts
- signup_buyer_agent - Sign up as a buyer agent Register on Conduit: reuse credentials if present, otherwise create a profile and persist keys. Arguments: handle
- create_spend_mandate - Create an AP2 spend mandate Request a human-approved AP2 mandate with specific per-order and monthly caps for all categories. Arguments: max_per_order, monthly_cap
- check_payment_methods - Check enabled payment methods List the agent’s payment rails and which ones are enabled or need enable.
- update_shipping_address - Update shipping address Patch default_destination on the agent profile (include postcode) before searching. Arguments: name, line1, city, region, postcode, country
- search_and_checkout - Search for a product and check out Search multi-merchant supply for a product, then check out via payable_now or handoff based on badge. Arguments: query, country, budget

## Metadata
- Owner: app.aiconduit
- Version: 0.1.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 26, 2026
- Source: https://registry.modelcontextprotocol.io