{"pageKey":"Developers","slug":"developers-ai-agents-mcp","locale":"en-US","localeResolved":"en-US","fallbackApplied":false,"version":"developers-ai-agents-mcp@2026-03-20T08:14:24.291Z","lastModified":"2026-03-20T08:14:24.291Z","canonicalUrl":"https://www.merchandaise.com/en-us/developers/ai-agents-mcp","payload":{"slug":"developers-ai-agents-mcp","purpose":"llm-developers-ai-agents-mcp","title":"AI agents and MCP tools for merchandise automation | MerchandAise","description":"Explore MerchandAise AI agent and MCP tool discovery for custom merchandise workflows, assistant authorization, approved operations, and LLM-ready integration feeds.","sections":[{"heading":"What this page covers","paragraphs":["This is the dedicated discovery page for AI agent builders evaluating MerchandAise MCP-compatible tool access. It explains the public server card, the assistant-authorized tools list, and the launch review path.","For the human and LLM-facing product-creation promise, pair this MCP guide with /ai-custom-product-designer: describe or upload an idea, let AI design or adapt it, verify manufacturable options, and move into supplier-backed quote or configurator handoff.","Use it when an assistant needs structured access to merchandise discovery, quoting, or approved operations without bypassing human governance."]},{"heading":"AI agent and MCP surfaces","items":[{"title":"MCP server card and authorized tools","description":"Plan AI-agent integrations on the browser-safe MCP guide page, use the AI custom product designer pillar for intent-to-product context, then use the public server-card JSON for machine discovery and assistant-authorized endpoints for tool listing and execution. Human guide: Read MCP implementation guide (/en-us/developers/ai-agents-mcp#implementation-checklist). Machine-readable contract: Public MCP server-card JSON (/en-us/.well-known/mcp/server-card). Access: public. Public discovery document for machine clients. The tools list and tool execution endpoints still require assistant authorization at /api/v1/mcp/tools. Canonical page: /developers/ai-agents-mcp. Canonical section: /developers/ai-agents-mcp#mcp-tools."},{"title":"Assistant tooling API docs","description":"Read the assistant/tooling OpenAPI docs that support design sessions, tool use, and integration reviews. Community, supplier, and enterprise contracts are listed separately. Human guide: Open assistant tooling docs (/en-us/developers/api-integrations). Machine-readable contract: Assistant tooling OpenAPI JSON (/api/docs/openapi.json). Access: public. Public machine-readable OpenAPI for assistant/tooling APIs; use the domain-specific contracts below for community, supplier, and enterprise implementation. Canonical page: /developers/ai-agents-mcp. Canonical section: /developers/ai-agents-mcp#api-docs."}]},{"heading":"Production implementation checklist","items":[{"title":"Step 1: Start with the server card and authorized tools list","description":"Use the public MCP server card to identify the server, then request assistant authorization before reading the current tools list, expected inputs, and execution boundaries."},{"title":"Step 2: Design assistant authorization deliberately","description":"Map which assistant actions can be read-only, which need user confirmation, and which require workspace or enterprise approval before execution."},{"title":"Step 3: Test agent behavior before launch","description":"Validate prompts, tool calls, failure states, observability, and approval handoffs in staging before enabling live merchandise workflows."}]},{"heading":"Production safeguards","items":[{"title":"Server card is public, tools are authorized","description":"The MCP server card is public for planning, while tool listing and execution require matching assistant authorization and workspace controls."},{"title":"Human review for sensitive operations","description":"Quoting, ordering, supplier, and enterprise actions should keep approval checkpoints instead of relying only on autonomous tool calls."},{"title":"LLM-friendly source of truth","description":"The page has canonical metadata, structured data, a dedicated LLM feed, and stable links so assistants can cite the current integration surface."}]},{"heading":"Before an AI agent workflow goes live","paragraphs":["Keep MCP server discovery separate from tools-list and execution readiness. Production agent workflows need authorization, review boundaries, and explicit human-control points."],"items":[{"title":"Map tool access by risk","description":"Separate read-only discovery, quoted recommendations, supplier-sensitive operations, and order-affecting actions before enabling execution."},{"title":"Design human confirmation paths","description":"Define which user, supplier, or enterprise approvals are required before an assistant can mutate merchandise, pricing, or fulfillment state."},{"title":"Run prompt and tool-call QA","description":"Test refusal behavior, bad inputs, stale tool definitions, telemetry, and recovery paths before live assistant traffic reaches the MCP surface."}]},{"heading":"FAQ","items":[{"title":"What is the MerchandAise MCP tools endpoint for?","description":"It lets authorized assistants retrieve MCP-compatible tool definitions for approved MerchandAise capabilities. The server card is public, while the tools list and execution require authorization."},{"title":"Can an AI agent place orders automatically?","description":"Production agent workflows should preserve the required approval, authentication, and workspace controls before any sensitive operation is executed."},{"title":"Is there a dedicated LLM feed for this page?","description":"Yes. The page exposes a focused LLM feed at /llm/developers/ai-agents-mcp with the canonical summary, tool links, safeguards, and implementation checklist."}]},{"heading":"Planning an agent workflow?","paragraphs":["Share the assistant use case, target users, approval model, and required tools. We will recommend the right MCP, API, and governance pattern."],"items":[{"title":"Talk to integrations team","description":"/en-us/contact?intent=agent-mcp-review"},{"title":"View AI product designer","description":"/en-us/ai-custom-product-designer"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}