Conduit Agentic Commerce

Server Details

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

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.

Status: Healthy
Uptime: 100.0% over the last 24 hours
Last Tested: 2026-11-10 00:01
Transport: Streamable HTTP · MCP 2025-11-25
URL
ChatGPT: –
Claude: –

TDQS

A3.9/5.0

Scored 2026-10-18 01:20 across 25 tools

Disambiguation4/5

Most tools target clearly distinct resource+action pairs, and descriptions actively draw boundaries (e.g. agent_notify vs agent_outreach, order_feedback vs order_dispute, agent_report_issue vs order_feedback). The five supply_* tools (search/availability/details/options/delivery) are individually well-scoped but dense and easy to misorder. A couple of pairs (order_track vs order_events, notify vs outreach) still share a surface and rely on prose to separate them.

Naming Consistency5/5

Every tool is snake_case with a consistent domain prefix (agent_, inventory_, order_, payment_, supply_) followed by a verb_noun-style suffix. The grouping makes the surface predictable and scannable. A few resource-noun names (agent_organization, payment_mandate, payment_methods) are natural fits for read operations and do not break the pattern.

Tool Count4/5

At 25 tools it sits at the heavy end, but the server spans five real sub-domains (identity, inventory, orders, payments, supply), so each tool broadly earns its place. The 5-supply and 7-order clusters are the only places it feels slightly inflated. No tool looks redundant or trivial.

Completeness4/5

The surface covers the full agentic-commerce lifecycle: agent register/auth/update, org read, comms, inventory read + draft PO, order list/track/execute/update/dispute/feedback, and payments. Gaps are minor (no agent de-registration, no dedicated order cancel/search beyond status filters), and several are intentionally delegated to handoffs or human steps. Core workflows have no obvious dead ends.

Available Tools

25 tools

agent_authenticateAuthenticate agentAInspect

Two-step re-auth. Call with agent_id only → ES256-sign nonce → call again with nonce+signature. Prefer keys from ~/.conduit ({handle}.credentials.json or legacy credentials.json; CONDUIT_CREDENTIALS_PATH pins one file). After success, merge name/role/description into that file; never overwrite private_key; keep session_token in memory. Do not agent_create if identity files already exist unless the human asked for a new agent.

Name	Required	Description
`nonce`	No	Challenge nonce from the first agent_authenticate call (omit to request one)
`agent_id`	Yes	Agent id from the chosen ~/.conduit credentials file, e.g. agt_...
`signature`	No	Signature of the nonce with the agent private key (omit with nonce to get challenge)

Output Schema

Name	Required	Description
`hint`	No
`next`	No
`error`	No
`nonce`	No
`avatar`	No
`detail`	No
`handle`	No
`persist`	No
`agent_id`	No
`mandates`	No
`terminal`	No
`challenge`	No
`created_at`	No
`public_key`	No
`reputation`	No
`open_orders`	No
`permissions`	No
`preferences`	No
`organization`	No
`total_orders`	No
`friendly_name`	No
`payment_rails`	No
`organization_id`	No
`business_profile`	No
`role_description`	No
`human_description`	No
`destination_source`	No
`default_destination`	No
`effective_destination`	No

agent_createCreate agent profileAInspect

Register an agent (ES256 P-256 public JWK JSON string + optional payment rails + destination). BEFORE: list ~/.conduit identity files — if any exist, reuse agent_id (do NOT register again unless the human asked for a new agent). AFTER: write persist.path (version, agent_id, public_key, private_key as JWKs; also handle, friendly_name, role_description, human_description; chmod 0600; write ~/.conduit/active). Then agent_update with default_destination+postcode before supply_search. Optional friendly_name / human_description / role_description / avatar only if the human stated them — never invent; omit avatar and the server assigns a random invader+gradient. Omit handle to auto-generate (e.g. parcel-watcher-12).

Name	Required	Description
`avatar`	No	Identity mark. Omit unless the human chose it — server assigns a random invader+gradient. { kind:"glyph", glyph:"invader"\|emoji, tint?:invader color, gradient } or { kind:"image", src }. Tint only for invader. Do not store in the credentials file.
`handle`	No	Optional display handle (lowercase kebab); omit to auto-generate e.g. parcel-watcher-12
`public_key`	Yes	ES256 P-256 public JWK as a JSON string (kty=EC, crv=P-256, x, y). Not PEM, hex, or base64url-wrapped JSON. Keep the matching private JWK only in ~/.conduit/{handle}.credentials.json.
`preferences`	No	Optional agent preference bag
`friendly_name`	No	Human-facing label (≠ handle), e.g. EU Restock Bot
`payment_rails`	No	Optional rail keys to seed, e.g. ["x402"]
`business_profile`	No	Optional business profile metadata object
`role_description`	No	Self-instruction for this agent only, e.g. manage EU supplies
`human_description`	No	Description shown to humans on the org dashboard
`default_destination`	No	Where orders ship. postcode + country is enough for supply_search and delivery estimates; add address, locality and region so checkout links arrive prefilled.

Output Schema

Name	Required	Description
`hint`	No
`next`	No
`error`	No
`nonce`	No
`avatar`	No
`detail`	No
`handle`	No
`persist`	No
`agent_id`	No
`mandates`	No
`terminal`	No
`challenge`	No
`created_at`	No
`public_key`	No
`reputation`	No
`open_orders`	No
`permissions`	No
`preferences`	No
`organization`	No
`total_orders`	No
`friendly_name`	No
`payment_rails`	No
`organization_id`	No
`business_profile`	No
`role_description`	No
`human_description`	No
`destination_source`	No
`default_destination`	No
`effective_destination`	No

agent_notifyNotify org membersA

Idempotent

Name	Required	Description
`to`	Yes	Who to notify: "all", { user_id }, { user_ids }, { role }, { roles }, or { email } matching an org member. Never an address outside the org.
`body`	Yes	Plain-text body, max 4000 characters. Conduit wraps HTML; do not send markup.
`title`	Yes	Subject line, max 120 characters
`actions`	No	Optional buttons, max 3. Hosts outside Conduit are rejected.
`channel`	No	Delivery channel. Email only — omit or pass email
`dry_run`	No	If true, resolve recipients and from-address without sending or storing
`agent_id`	Yes	Linked agent sending the message
`order_id`	No	Optional order correlation
`severity`	No	info (default), warning, or urgent — affects subject prefix and accent
`search_id`	No	Optional search correlation
`session_token`	No	Session token from agent_authenticate — required whenever agent_id is passed
`idempotency_key`	No	Replay key — same agent + key returns the original notify_id without sending again

Name	Required	Description
`from`	No
`hint`	No
`next`	No
`error`	No
`detail`	No
`failed`	No
`channel`	No
`dry_run`	No
`delivered`	No
`notify_id`	No
`recipients`	No
`idempotent_replay`	No

Name	Required	Description	Default
`agent_id`	Yes	Agent id whose linked organization to read
`session_token`	No	Session token from agent_authenticate — required whenever agent_id is passed

Name	Required	Description
`to`	Yes	Outside address(es): a string email, { email }, or { emails } (max 5). Not to=all and not a Hub user_id / role — those are agent_notify.
`body`	Yes	Plain-text body, max 4000 characters. URLs stay escaped text, not buttons.
`title`	Yes	Subject line, max 120 characters
`channel`	No	Delivery channel. Email only — omit or pass email
`dry_run`	No	If true, resolve recipients and from-address without sending or storing
`agent_id`	Yes	Authenticated agent sending the note
`order_id`	No	Optional order correlation
`reply_to`	No	Linked only: who receives replies. { email } or { role } matching a member. Omit to default to the OWNER. Unlinked agents have no Reply-To.
`search_id`	No	Optional search correlation
`session_token`	No	Session token from agent_authenticate — required whenever agent_id is passed
`idempotency_key`	No	Replay key — same agent + key returns the original outreach_id without sending again

Name	Required	Description
`kind`	No	Triage kind (default confusing): bug \| confusing \| wrong_data \| blocked
`tool`	No	MCP tool that failed or confused you, e.g. supply_search or order_execute
`error`	No	Error code from the prior tool response when present, e.g. offer_not_in_cache
`detail`	No	Optional longer detail (response excerpt, unexpected field). Do not include private_key.
`context`	No	Optional structured extras (args summary, badge, etc.). Secrets are stripped.
`message`	Yes	Required: what went wrong or what confused you (expected vs actual). Keep actionable. This is agent_report_issue — not order_feedback.
`agent_id`	No	Agent id from credentials when available (omit placeholders like "agent_id")
`order_id`	No	order_id for correlation when the issue is order-related
`search_id`	No	search_id for correlation when the issue is search-related
`session_id`	No	Optional session id; Conduit also picks up x-conduit-session-id from the transport
`session_token`	No	Session token from agent_authenticate — required whenever agent_id is passed

Name	Required	Description
`skus`	No	Item codes in your own system, e.g. ["CART-6040"]. Pass skus or query
`fresh`	No	Ask the system now instead of reading the last value (slower, rate limited)
`query`	No	Free-text item search in your own system, e.g. "carton"
`agent_id`	Yes	Agent id; its organization owns the connected system
`connection_id`	No	Which connected system, when the org has several
`session_token`	No	Session token from agent_authenticate — required whenever agent_id is passed

Name	Required	Description
`hint`	No
`next`	No
`as_of`	No
`basis`	No
`error`	No
`detail`	No
`system`	No
`freshness`	No
`connections`	No
`availability`	No
`connection_id`	No
`could_not_reach`	No

Name	Required	Description
`agent_id`	Yes	Agent id; needs both inventory and checkout permission
`order_id`	Yes	Conduit order id of a supplier order already placed with order_execute
`connection_id`	No	Which connected system, when the org has several
`session_token`	No	Session token from agent_authenticate — required whenever agent_id is passed

Name	Required	Description
`hint`	No
`next`	No
`unit`	No
`draft`	No
`error`	No
`total`	No
`detail`	No
`vendor`	No
`currency`	No
`order_id`	No
`quantity`	No
`replayed`	No
`external_name`	No
`supplier_order`	No
`unmatched_lines`	No

Name	Required	Description
`hint`	No
`next`	No
`rows`	No
`as_of`	No
`basis`	No
`error`	No
`detail`	No
`system`	No
`window`	No
`freshness`	No
`provenance`	No
`connections`	No
`connection_id`	No
`next_to_watch`	No
`could_not_reach`	No

Name	Required	Description
`hint`	No
`next`	No
`note`	No
`error`	No
`detail`	No
`status`	No
`product`	No
`order_id`	No
`pay_with`	No
`quantity`	No
`rail_key`	No
`supplier`	No
`shortfall`	No
`simulated`	No
`supply_id`	No
`bill_total`	No
`created_at`	No
`continue_url`	No
`address_status`	No
`bill_breakdown`	No
`purchase_draft`	No
`supplier_order`	No
`handoff_quality`	No
`shipping_option`	No
`handoff_endpoint`	No
`idempotent_replay`	No
`shipping_selected`	No
`external_checkout_id`	No

Name	Required	Description
`hint`	No
`next`	No
`error`	No
`detail`	No
`status`	No
`carrier`	No
`product`	No
`order_id`	No
`recovery`	No
`tracking`	No
`trackable`	No
`checkout_id`	No
`tracking_id`	No
`continue_url`	No
`status_source`	No
`address_status`	No
`purchase_draft`	No
`supplier_order`	No
`tracking_source`	No
`merchant_observed`	No
`handoff_expires_at`	No
`agent_status_locked`	No

Name	Required	Description
`note`	No	Required note except when status=CANCELLED
`status`	Yes	New status, e.g. PENDING, CONFIRMED, SHIPPED, DELIVERED, CANCELLED
`carrier`	No	Carrier name when attaching tracking
`agent_id`	Yes	Owning agent id (required for authorization)
`order_id`	Yes	Order id to update
`search_id`	No	Optional search_id for analytics correlation
`tracking_id`	No	Carrier tracking id when recovering handoff
`tracking_url`	No	Carrier's public tracking page for tracking_id, when you have it. Never invent one.
`session_token`	No	Session token from agent_authenticate — required whenever agent_id is passed
`handoff_endpoint`	No	Merchant handoff/status endpoint URL for poll recovery
`external_checkout_id`	No	Merchant checkout id to recover degraded handoff polling

Name	Required	Description
`scope`	No	Spend limits — required for action=request and action=update
`action`	Yes	request = create mandate (needs scope); list = enumerate; update = change scope (needs mandate_id+scope); revoke = revoke (needs mandate_id)
`expires`	No	Optional ISO-8601 expiry, e.g. 2026-12-31T00:00:00Z
`agent_id`	Yes	Owning agent id
`mandate_id`	No	Mandate id required for update/revoke
`session_token`	No	Session token from agent_authenticate — required whenever agent_id is passed

Name	Required	Description
`skus`	Yes	Item codes in your own system whose usual vendors and last prices to read
`agent_id`	Yes	Agent id; its organization owns the connected system
`connection_id`	No	Which connected system, when the org has several
`session_token`	No	Session token from agent_authenticate — required whenever agent_id is passed

Name	Required	Description
`carrier`	No	The shipping rate to buy, as the option's own `title` from supply_delivery. Conduit selects it on the merchant checkout, so the buyer opens the page on that rate instead of the merchant's default, which is the cheapest one. A title the merchant does not quote for this address leaves its default in place, and the response says so via shipping_selected.
`agent_id`	Yes	Owning agent id
`pay_with`	No	Rail key to pay with when multiple are enabled
`quantity`	No	Units to buy (default 1)
`search_id`	No	search_id from supply_search for correlation
`supply_id`	Yes	Offer supply id to purchase
`session_token`	No	Session token from agent_authenticate — required whenever agent_id is passed
`idempotency_key`	No	Client idempotency key — reuse to safely retry the same execute
`payment_term_id`	No	Payment term id from supply_details payment_terms[] (e.g. net 30). Omit to pay immediately

Name	Required	Description
`notes`	No	Free-text delivery/quality notes
`outcome`	Yes	Observed fulfillment outcome. Sets status (on_time/late→DELIVERED, damaged/wrong_item→DISPUTED, never_arrived→FAILED) and reputation.
`quality`	No	Product quality 1-5 — omit if unknown (do not invent)
`agent_id`	Yes	Owning agent id (required for authorization)
`order_id`	Yes	Order id to attest
`search_id`	No	Optional search_id for analytics correlation
`session_token`	No	Session token from agent_authenticate — required whenever agent_id is passed
`carrier_rating`	No	Carrier rating 1-5 — omit if unknown; used in reputation when provided

Name	Required	Description
`ok`	No
`hint`	No
`next`	No
`error`	No
`detail`	No
`status`	No
`outcome`	No
`updated`	No
`order_id`	No
`superseded`	No
`already_recorded`	No

Name	Required	Description
`status`	No	Optional status filter: PENDING, CONFIRMED, IN_TRANSIT, DELIVERED, ABANDONED (or CANCELLED), FAILED, DISPUTED
`agent_id`	Yes	Owning agent id whose orders to list
`open_only`	No	If true, only in-flight orders (PENDING, CONFIRMED, IN_TRANSIT). Ignored when status is set.
`session_token`	No	Session token from agent_authenticate — required whenever agent_id is passed

Name	Required	Description
`rail`	No	Rail key required when action=enable, e.g. x402 (not bank_card vault)
`action`	Yes	list = enumerate rails; enable = turn on one rail
`agent_id`	Yes	Agent id whose methods to list or enable
`session_token`	No	Session token from agent_authenticate — required whenever agent_id is passed

Name	Required	Description
`fresh`	No	Ask the supplier now rather than reading the last value. Needs agent_id, and is rate limited per agent and per organization
`quote`	No	Also return the supplier's exact total with tax for this quantity, computed without saving anything. Needs agent_id and an account with the supplier
`agent_id`	No	Agent id. Required for fresh, and it is what reveals your negotiated prices
`quantity`	No	Quantity to fill (default 1)
`supply_id`	Yes	Offer supply id from supply_search / supply_details
`session_token`	No	Session token from agent_authenticate — required whenever agent_id is passed

Name	Required	Description
`region`	No	Optional region/state override
`address`	No	Street override. Many merchants will not quote shipping without it.
`country`	No	ISO country override, e.g. US (else agent/org destination)
`agent_id`	No	Agent id — uses agent destination else org default when country omitted
`locality`	No	City override. Needed with street for a real delivery quote.
`quantity`	No	Units to price shipping for (default 1)
`supply_id`	Yes	Offer supply id from supply_search / supply_details
`postal_code`	No	Postal/ZIP override for the probe destination
`session_token`	No	Session token from agent_authenticate — required whenever agent_id is passed

Name	Required	Description
`agent_id`	No	Agent id to refresh badge/action for mandate state
`search_id`	No	search_id from supply_search for correlation
`supply_id`	Yes	Offer supply id from supply_search results
`session_token`	No	Session token from agent_authenticate — required whenever agent_id is passed
`include_description_original`	No	Adds description_original {format, content}: the merchant's own markup, for rendering or checking our conversion. Untrusted merchant text. supply_details only.

Name	Required	Description
`aes`	No
`hint`	No
`next`	No
`badge`	No
`error`	No
`title`	No
`action`	No
`detail`	No
`currency`	No
`supplier`	No
`supply_id`	No
`unit_price`	No
`description`	No
`price_total`	No
`payment_rails`	No
`payment_terms`	No
`delivery_options`	No
`description_original`	No	Only with include_description_original. The merchant's markup, untrusted. format is html or markdown today; plain is reserved.
`description_original_omitted`	No	Only with include_description_original, when there is no original: no_markup (plain text or none), oversize (over 20,000 chars), empty (markup with no visible text).

Server Details

TDQS

Available Tools

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Output Schema

Tool Schema Changelog

Related MCP Connectors

Related MCP Servers

Shopping MCP Server

PurchasePlus MCPofficial

ChopChop MCP Server

ingrammicro-mcp

Glama MCP Gateway

Resources

Name	Required	Description
`agent_id`	No	Agent id, for permission and analytics
`supply_id`	Yes	Offer supply id whose product options to list (has_options=true on the offer)
`session_token`	No	Session token from agent_authenticate — required whenever agent_id is passed

Name	Required	Description
`limit`	No	Page size of ranked offers to return (default 30, max 100)
`query`	No	Product search query, e.g. USB-C charger 65W. Required for a new search; omit when paging with search_id + offset
`budget`	No	Max total budget — number means USD; or { amount, currency }
`offset`	No	0-based offset into the ranked set for this search_id (default 0). For page 2+, pass search_id from the prior response and follow next.args
`country`	No	ISO country for ships-to, e.g. US
`agent_id`	No	Agent id for mandate-aware badges (always pass when available)
`quantity`	No	Desired quantity (default 1)
`search_id`	No	Resume paging into a prior ranked set (with offset>0, or offset 0 without query). New searches with query mint a fresh search_id
`fetch_limit`	No	Optional override for per-merchant upstream pull (default max(20, limit*2), max 300). Ignored when paging via search_id+offset
`payable_with`	No	Filter to rails the agent can pay with, e.g. ["x402"]
`session_token`	No	Session token from agent_authenticate — required whenever agent_id is passed
`include_sandbox`	No	Include DEMO/SANDBOX merchants (listed last, test_offer=true). Default false — live REAL merchants only. Use only when testing Conduit checkout flows.