black-buffalo-mcp.yml
Black Buffalo serves TWO live MCP endpoints from its own storefront host, and — unlike most Shopify merchants profiled in this catalog — BOTH answer an anonymous JSON-RPC tools/list with HTTP 200 and full JSON Schema input contracts. The Shopify Storefront MCP server at /api/mcp returned five read/cart tools. The Universal Commerce Protocol MCP server at /api/ucp/mcp returned thirteen tools covering the entire catalog → cart → checkout → completed-order lifecycle, including complete_checkout. Only resources/list and prompts/list are gated behind a UCP agent profile URI.
One-click install for Cursor, VS Code, Claude, and 20+ other MCP clients, powered by API Commons MCP Install — visit install.apicommons.org for more information.
Documentation
Documentation link · transport
Tools
search_catalog— Search for products from the online store using natural language queries, specific filter criteria, or both; at least one of query or filters must be provided. Results are paginated — use pagination.cursor to fetch further pages. The response conforms to dev.ucp.shopping.catalog.search.lookup_catalog— Resolve multiple product or variant identifiers in one request. Accepts Product IDs (gid://shopify/Product/...) and Variant IDs (gid://shopify/ProductVariant/...); results are grouped by product and each variant carries an inputs array showing which identifier matched it.get_product— Retrieve complete product detail by identifier — one product with a relevant set of variants, exact pricing and real-time availability. Supports interactive option selection through the selected and preferences parameters for variant narrowing.create_cart— Creates a new cart.get_cart— Get the cart contents.update_cart— Perform updates to a cart.cancel_cart— Cancels a cart.create_checkout— Creates a checkout. Returns checkout details including line items, totals, and any applicable discounts or taxes. The checkout object accepts payment.instruments with billing_address and an opaque credential token (card or wallet).get_checkout— Returns details about the checkout, including line items, totals, and any applicable discounts or taxes. The id is a Shopify global id of the form gid://shopify/Checkout/abc123.update_checkout— Updates a checkout and returns the recalculated checkout details.complete_checkout— Completes a checkout and returns the checkout result — order ID, Thank You Page URL, or any errors encountered. This is the money-moving tool.cancel_checkout— Cancels a checkout.get_order— Get the details of an order.search_catalog— Search for products from the online store using natural language queries, filters, or both. Paginated; response conforms to dev.ucp.shopping.catalog.search.get_product_details— Look up a product by ID. Pass options to select a specific variant for the product card; without options the first available variant is returned.get_cart— Get the cart including items, shipping options, discount info and checkout url for a given cart id.update_cart— Consolidated cart mutation — add/remove/update line items, buyer information, delivery addresses, selected delivery options, discount codes, gift cards and notes in one call. When creating a new cart only add_items is required.search_shop_policies_and_faqs— Get facts about the store's policies, products or services — return policy, shipping policy, phone number, hours of operation.
About MCP
The Model Context Protocol (MCP) is an open protocol Anthropic introduced for connecting LLM-based agents to external tools and data sources. Providers publish MCP servers that expose their API surface as structured, discoverable tools — an MCP-compatible client (Claude Desktop, Cursor, Cline, Continue, etc.) can connect to the server and call its tools without any per-provider integration code.
Browse every MCP server on the APIs.io network or compare with the broader Agent Skill surfaces of the same providers.
Work with this as data
Every MCP server here is available over the APIs.io API and to AI agents over MCP.