{ "specVersion": "1.0", "host": { "displayName": "Brainerce", "identifier": "did:web:brainerce.com", "documentationUrl": "https://brainerce.com/docs" }, "entries": [ { "identifier": "urn:air:brainerce.com:skill:cold-start", "displayName": "Brainerce cold start", "type": "application/ai-skill+md", "url": "https://brainerce.com/skill.md", "description": "The single entry point for a coding agent that knows nothing about Brainerce except this URL. Resolves which of the three SDK modes applies, gets a connection id, and routes to the right skill file for the job.", "tags": ["headless-commerce", "ecommerce", "storefront", "sdk", "cold-start"], "capabilities": ["mode-resolution", "connection-id", "skill-routing", "storefront-scaffold"], "representativeQueries": [ "build me an online store", "I want to start selling online, where do I begin", "connect this design to Brainerce", "what is Brainerce and how do I integrate it" ], "trustManifest": { "identity": "did:web:brainerce.com", "identityType": "did" } }, { "identifier": "urn:air:brainerce.com:mcp:docs", "displayName": "Brainerce docs MCP server", "type": "application/mcp-server-card+json", "url": "https://mcp-docs.brainerce.com/mcp", "version": "3.0.0", "description": "Public MCP server carrying the Brainerce SDK reference, type definitions, business flows and critical rules, plus live introspection of one connected store. Streamable HTTP transport, no authentication; a legacy SSE endpoint is available at https://mcp-docs.brainerce.com/sse. This URL speaks JSON-RPC rather than serving a static server card, so connect to it, do not fetch it.", "tags": ["mcp", "sdk", "documentation", "store-introspection", "developer"], "capabilities": [ "get-sdk-docs", "get-type-definitions", "get-code-example", "get-store-info", "get-store-capabilities", "get-integration-guide", "get-critical-rules", "get-business-flows", "get-required-features", "get-store-config", "get-product-shape", "list-store-products" ], "representativeQueries": [ "connect an MCP server for Brainerce documentation", "give my coding agent the live Brainerce SDK reference", "what products and variants are in my Brainerce store", "what are the Brainerce critical rules and business flows" ], "trustManifest": { "identity": "did:web:brainerce.com", "identityType": "did" } }, { "identifier": "urn:air:brainerce.com:registry:skills", "displayName": "Brainerce skill manifest", "type": "application/ai-registry+json", "url": "https://brainerce.com/skills.manifest.json", "description": "Machine-readable index of every Brainerce skill and reference file, with path, byte size, name and description. Fetch this first to see the whole agent surface and budget context before reading any single file.", "tags": ["registry", "manifest", "index", "skills"], "capabilities": ["file-index", "size-budgeting", "surface-enumeration"], "representativeQueries": [ "list every Brainerce skill file", "what agent documentation does Brainerce publish", "how large are the Brainerce skill files" ], "trustManifest": { "identity": "did:web:brainerce.com", "identityType": "did" } }, { "identifier": "urn:air:brainerce.com:bundle:skills", "displayName": "Brainerce skills bundle", "type": "application/gzip", "url": "https://brainerce.com/skills.tgz", "description": "Every file the skill manifest lists, as one gzipped tarball, so an agent can take the whole reference in a single request instead of one fetch per file.", "tags": ["bundle", "archive", "skills", "offline"], "capabilities": ["bulk-download"], "representativeQueries": [ "download all the Brainerce skill files at once", "get the Brainerce agent documentation as one archive" ], "trustManifest": { "identity": "did:web:brainerce.com", "identityType": "did" } }, { "identifier": "urn:air:brainerce.com:docs:llms", "displayName": "Brainerce docs index (llms.txt)", "type": "text/markdown", "url": "https://brainerce.com/llms.txt", "description": "Index of every Brainerce page written for a reader rather than a crawler: the developer docs and the merchant help centre, each with its URL and a one-line summary.", "tags": ["llms-txt", "documentation", "help-centre", "index"], "capabilities": ["docs-index", "help-article-lookup"], "representativeQueries": [ "list every Brainerce documentation page", "where are the Brainerce developer docs", "find the Brainerce help article about shipping" ], "trustManifest": { "identity": "did:web:brainerce.com", "identityType": "did" } }, { "identifier": "urn:air:brainerce.com:api:brainerce", "displayName": "Brainerce REST API", "type": "application/vnd.oai.openapi+json;version=3.0", "url": "https://brainerce.com/openapi.json", "description": "OpenAPI 3.0 description of the public Brainerce REST API: catalog, cart, checkout, payments, orders, customers, discounts and shipping, for callers that would rather speak HTTP than install the SDK.", "tags": ["api", "openapi", "rest", "commerce"], "capabilities": ["catalog", "cart", "checkout", "orders", "customers", "discounts", "shipping"], "representativeQueries": [ "what REST endpoints does Brainerce expose", "the OpenAPI spec for the Brainerce API", "how do I list products over the Brainerce REST API", "call Brainerce from a language with no SDK" ], "trustManifest": { "identity": "did:web:brainerce.com", "identityType": "did" } }, { "identifier": "urn:air:brainerce.com:skill:storefront-build", "displayName": "Build a Brainerce storefront", "type": "application/ai-skill+md", "url": "https://brainerce.com/skills/brainerce-storefront-build/SKILL.md", "description": "The ordered build path for a storefront on Brainerce, in whatever framework the project already uses: store capabilities, catalog, cart, checkout, and the rules that cause production incidents when skipped.", "tags": ["storefront", "scaffold", "nextjs", "remix", "astro", "developer"], "capabilities": ["storefront-scaffold", "capability-discovery", "catalog-wiring", "cart", "checkout"], "representativeQueries": [ "how do I add a checkout to my Next.js store", "build a storefront with Brainerce", "I have a Brainerce connection id, wire up the shop", "add commerce to this site" ], "trustManifest": { "identity": "did:web:brainerce.com", "identityType": "did" } }, { "identifier": "urn:air:brainerce.com:skill:sdk", "displayName": "Brainerce SDK reference", "type": "application/ai-skill+md", "url": "https://brainerce.com/skills/brainerce-sdk/SKILL.md", "description": "The real shape of the Brainerce storefront SDK: method names, arguments, return types and the TypeScript definitions behind them. Read before writing any call you are not certain of.", "tags": ["sdk", "typescript", "reference", "types", "developer"], "capabilities": ["method-signatures", "type-definitions", "BrainerceClient", "getProducts"], "representativeQueries": [ "what arguments does getProducts take", "what does the Brainerce product type look like", "is there an SDK method for loading a category", "what comes back from the Brainerce cart methods" ], "trustManifest": { "identity": "did:web:brainerce.com", "identityType": "did" } }, { "identifier": "urn:air:brainerce.com:skill:checkout-flows", "displayName": "Brainerce checkout and auth flows", "type": "application/ai-skill+md", "url": "https://brainerce.com/skills/brainerce-checkout-flows/SKILL.md", "description": "The fixed sequences that must not be improvised: checkout, registration and email verification, login, password reset, cart persistence, inventory reservation and order confirmation.", "tags": ["checkout", "payments", "authentication", "orders", "developer"], "capabilities": ["checkout-sequence", "payment-success", "order-confirmation", "inventory-reservation", "cart-persistence", "login"], "representativeQueries": [ "the payment succeeded but no order appeared", "what order do the Brainerce checkout calls go in", "my inventory reservation keeps expiring", "the cart empties when the page refreshes" ], "trustManifest": { "identity": "did:web:brainerce.com", "identityType": "did" } }, { "identifier": "urn:air:brainerce.com:skill:integration-verify", "displayName": "Verify a Brainerce integration", "type": "application/ai-skill+md", "url": "https://brainerce.com/skills/brainerce-integration-verify/SKILL.md", "description": "Audits a finished storefront against the mandatory-feature checklist and the critical rules, walking the actual code rather than trusting that a file exists, and reports what is missing, unreachable or wrong.", "tags": ["audit", "checklist", "pre-launch", "quality", "developer"], "capabilities": ["feature-checklist", "critical-rules-audit", "pre-launch-review"], "representativeQueries": [ "is my Brainerce integration complete", "did I miss anything before launch", "review this storefront before I ship it to the client", "why is this feature not working in my store" ], "trustManifest": { "identity": "did:web:brainerce.com", "identityType": "did" } }, { "identifier": "urn:air:brainerce.com:skill:store-architecture", "displayName": "Brainerce catalog and shipping architecture", "type": "application/ai-skill+md", "url": "https://brainerce.com/skills/brainerce-store-architecture/SKILL.md", "description": "How a catalog should be structured and audited: what becomes a variant, a custom field, a category or a tag. Also owns shipping zones and rates, sales-channel publishing, and subscription plans.", "tags": ["catalog", "variants", "categories", "shipping", "subscriptions", "merchant"], "capabilities": ["variant-vs-field", "categories-vs-tags", "shipping-zones", "shipping-rates", "sales-channels", "subscriptions"], "representativeQueries": [ "should this be a variant or a custom field", "categories or tags for organising my shop", "set up my shipping zones and what shipping costs", "which countries do I ship to" ], "trustManifest": { "identity": "did:web:brainerce.com", "identityType": "did" } }, { "identifier": "urn:air:brainerce.com:skill:product-onboarding", "displayName": "Add products to a Brainerce store", "type": "application/ai-skill+md", "url": "https://brainerce.com/skills/brainerce-product-onboarding/SKILL.md", "description": "Adding a product properly, from creating it through category, tags, stock and publishing, plus duplicating a near-identical product and correcting inventory after a stock take.", "tags": ["products", "inventory", "publishing", "csv-import", "merchant"], "capabilities": ["create-product", "stock-count", "categorise", "publish", "duplicate-product", "csv-import"], "representativeQueries": [ "add a new product to my shop", "fix the stock count after a stock take", "bulk import my products from a CSV", "put this item in the shop" ], "trustManifest": { "identity": "did:web:brainerce.com", "identityType": "did" } }, { "identifier": "urn:air:brainerce.com:skill:launch-a-sale", "displayName": "Run a sale on a Brainerce store", "type": "application/ai-skill+md", "url": "https://brainerce.com/skills/brainerce-launch-a-sale/SKILL.md", "description": "Setting up a discount and confirming it is live, centred on the choice between an automatic cart discount and a coupon code the shopper types. Also covers loyalty points and gift cards, which are stored value rather than discounts.", "tags": ["discounts", "coupons", "promotions", "loyalty", "gift-cards", "merchant"], "capabilities": ["automatic-discount", "coupon-code", "free-shipping-offer", "loyalty-points", "gift-card"], "representativeQueries": [ "take 20% off everything this weekend", "create a promo code for my store", "set up a Black Friday sale", "how do I sell a gift card" ], "trustManifest": { "identity": "did:web:brainerce.com", "identityType": "did" } }, { "identifier": "urn:air:brainerce.com:skill:order-handling", "displayName": "Work a Brainerce order", "type": "application/ai-skill+md", "url": "https://brainerce.com/skills/brainerce-order-handling/SKILL.md", "description": "Taking a single order from question to action: look it up, read its state, then fulfil it, move its status or cancel it, including the pay-before-fulfil gate and the cases where an order must not be touched.", "tags": ["orders", "fulfilment", "shipping", "refunds", "merchant"], "capabilities": ["order-lookup", "fulfil", "add-tracking", "cancel-order", "mark-as-paid"], "representativeQueries": [ "where is order 1042", "mark this order as shipped and add a tracking number", "can I cancel this order", "a customer is asking what happened to their order" ], "trustManifest": { "identity": "did:web:brainerce.com", "identityType": "did" } }, { "identifier": "urn:air:brainerce.com:skill:analytics", "displayName": "Brainerce store analytics", "type": "application/ai-skill+md", "url": "https://brainerce.com/skills/brainerce-analytics/SKILL.md", "description": "Turns a plain question about a store into the right reporting call and answers with a number plus what it means, instead of counting rows by hand.", "tags": ["analytics", "reporting", "revenue", "statistics", "merchant"], "capabilities": ["revenue-report", "order-counts", "average-order-value", "best-sellers", "trend-comparison", "ratings"], "representativeQueries": [ "how much money did my store make this month", "what are my best selling products", "how does this month compare to last month", "what is my average order value" ], "trustManifest": { "identity": "did:web:brainerce.com", "identityType": "did" } }, { "identifier": "urn:air:brainerce.com:skill:daily-summary", "displayName": "Brainerce daily store briefing", "type": "application/ai-skill+md", "url": "https://brainerce.com/skills/brainerce-daily-summary/SKILL.md", "description": "One short morning briefing for a store owner: what sold, what came in overnight, and what needs attention today, assembled into a single readable answer.", "tags": ["daily-summary", "briefing", "standup", "merchant"], "capabilities": ["morning-report", "overnight-orders", "low-stock-warning"], "representativeQueries": [ "how is the store doing today", "did any orders come in overnight", "catch me up on yesterday", "what do I need to deal with today" ], "trustManifest": { "identity": "did:web:brainerce.com", "identityType": "did" } }, { "identifier": "urn:air:brainerce.com:skill:store-health", "displayName": "Brainerce store health sweep", "type": "application/ai-skill+md", "url": "https://brainerce.com/skills/brainerce-store-health/SKILL.md", "description": "Sweeps a store for the things that quietly go wrong — products left as drafts, items out of stock, promotions never switched off, orders stuck waiting on someone — and hands back a short list to fix.", "tags": ["audit", "housekeeping", "drafts", "out-of-stock", "merchant"], "capabilities": ["draft-products", "out-of-stock", "expired-discounts", "stuck-orders"], "representativeQueries": [ "check my store, is everything ok", "which products did I leave as drafts", "do I have expired discounts still running", "what is broken in my shop" ], "trustManifest": { "identity": "did:web:brainerce.com", "identityType": "did" } }, { "identifier": "urn:air:brainerce.com:skill:custom-fields", "displayName": "Brainerce custom fields and metafields", "type": "application/ai-skill+md", "url": "https://brainerce.com/skills/brainerce-custom-fields/SKILL.md", "description": "Structured extra data a product carries beyond its built-in fields: the definition-versus-value split, which of the fifteen types to pick, and the two flags that decide whether a field is buyer-facing or filterable.", "tags": ["custom-fields", "metafields", "product-specs", "filters", "merchant", "developer"], "capabilities": ["field-definition", "field-value", "buyer-facing-flag", "filterable-flag"], "representativeQueries": [ "add a materials spec to all my products", "where do I put care instructions on a product", "let customers type an engraving when they order", "make this product field filterable on my shop" ], "trustManifest": { "identity": "did:web:brainerce.com", "identityType": "did" } }, { "identifier": "urn:air:brainerce.com:skill:content-and-navigation", "displayName": "Brainerce storefront content and navigation", "type": "application/ai-skill+md", "url": "https://brainerce.com/skills/brainerce-content-and-navigation/SKILL.md", "description": "The words on a storefront that are not product copy: static pages, FAQs, footers, the header and its navigation, announcement bars, the blog, and the SEO around them, with the exact dashboard routes for each.", "tags": ["content", "pages", "navigation", "blog", "seo", "merchant"], "capabilities": ["static-pages", "faq", "footer", "navigation-menu", "announcement-bar", "blog", "seo-metadata"], "representativeQueries": [ "where do I write my About page", "how do I add a shipping policy page", "put an announcement banner across the top of my store", "how do I get my store found on Google" ], "trustManifest": { "identity": "did:web:brainerce.com", "identityType": "did" } } ] }