Skip to main content
Connect your AI assistant to the BYOM documentation so it can find a workflow, check a developer contract and link you to the source. The documentation MCP reads the public guides on this site through Mintlify’s hosted service. It has no access to company or store records and cannot approve Actions. The public server is available at https://docs.byom.co/mcp. It was checked on 2 October 2026 with a real remote HTTP MCP client: connection, tool discovery, retrieval across all 29 published articles and source-linked searches passed. Use the articles directly if your client cannot connect, and cite the current page when applying an answer.

​
Choose the right MCP

The documentation MCP needs no store credentials. Never paste Shopify tokens, BYOM credentials or customer records into a documentation search or feedback tool. Access to public docs does not grant access to the product.

​
Connect your assistant

Add a remote HTTP MCP server in your client’s connector or MCP settings:
Use a client that supports remote MCP over HTTP. The client performs the MCP initialisation handshake and discovers the tools with tools/list. Tool names are supplied by the server; discover them instead of hard-coding a name from another Mintlify site. Mintlify supports hosted-server discovery at /.well-known/mcp. Mintlify provides a JSON alias at /.well-known/mcp.json and tool descriptions through /.well-known/mcp/server-card.json. These routes are available. The platform may advertise an equivalent hosted alias; use https://docs.byom.co/mcp when configuring BYOM directly. A discovery card alone does not prove that your particular client has connected successfully. The server provides documentation search and a read-only virtual documentation filesystem. The filesystem is the public article corpus, not BYOM’s server or your computer. A separate feedback tool can submit a documentation-quality report; it does not perform a store operation. Read each discovered tool’s description before using it.

​
Use your preferred client

The More actions menu beside Copy page offers two different kinds of handoff. Open in ChatGPT, Open in Claude and Open in Perplexity provide context about the current page. Connect to Cursor and Connect to VS Code prepare the remote documentation MCP connection, which can retrieve across the public corpus. Review the connection your client proposes before adding it. For a current Codex CLI, the registration command is:
This command changes your local client configuration. It does not log in to BYOM, connect a store or verify that the remote server is healthy. After adding the server, ask a question from the examples below and check the returned source. Client features and account permissions vary; an unsupported client can still use Copy page or the article’s Markdown version. For current client-specific controls, see the official guides for Claude connectors, Claude Code, ChatGPT MCP apps, Cursor, VS Code and Gemini CLI.

​
Read without a connector

Copy an individual page as Markdown, or append .md to its article URL. The hosted site also provides a documentation index at /llms.txt and a full-text export at /llms-full.txt. The public /skill.md explains the main workflows and the boundaries an assistant should preserve. These are public reading formats; they do not require access to your merchant account.

​
Ask questions that lead to useful sources

For example:
  • “How does BYOM separate approval from execution? Link to the relevant guide.”
  • “Which MCP transport does the Shopify connector support, and what does a 202 notification mean?”
  • “What should I check when a tool is missing from my connector?”
  • “When can an operation be undone? Include the limits.”
  • “How do HQ and Workspace differ?”
Ask your assistant to cite the pages it used and preserve the limitations in those pages. For implementation work, read the linked contract and confirm the current tools and permissions in your enabled account. A documentation answer is not evidence that a feature is enabled for a particular company.

​
What is included

The public corpus covers the product, task guides, developer documentation, trust, availability and documentation updates. Private product source, internal plans and account-specific data are excluded. The public documentation is the source of truth for this server; it does not inspect BYOM’s private repositories.

​
If an answer or connection is missing

Check the server URL and your client’s remote-HTTP support first. If a recent page is absent from search, open the page directly and use its Copy page menu; search indexing may lag a documentation update. Do not repeatedly retry an unchanged failure. Report the page URL and a non-sensitive description to hello@byom.co. If the docs do not answer your question, ask the assistant to say what is missing. Confirm an undocumented endpoint, permission or availability claim with BYOM before relying on it. Reviewed 2 October 2026.