{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_h7fr8egk4bhd","handle":"brainerce","url":"https://wellknown.network/agents/brainerce","links":{"self":"https://wellknown.network/agents/brainerce/record.json","html":"https://wellknown.network/agents/brainerce","markdown":"https://wellknown.network/agents/brainerce/record.md","api":"https://wellknown.network/api/v1/agents/brainerce","status":"https://wellknown.network/api/v1/agents/brainerce/status","claim":"https://wellknown.network/agents/brainerce/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/brainerce/claim.json","badge":"https://wellknown.network/agents/brainerce/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air:brainerce.com:agent:brainerce","type":"application/a2a-agent-card+json"},"kind":"agent","declared":{"name":"brainerce","summary":"Brainerce is a headless commerce platform (checkout, payments, discounts, inventory and orders) for storefronts that a coding agent builds and connects over an SDK or a REST API. This card describes the capabilities Brainerce exposes to other agents. Brainerce does not run an A2A JSON-RPC task endp…","description":"Brainerce is a headless commerce platform (checkout, payments, discounts, inventory and orders) for storefronts that a coding agent builds and connects over an SDK or a REST API. This card describes the capabilities Brainerce exposes to other agents. Brainerce does not run an A2A JSON-RPC task endpoint; the machine interfaces are the public MCP server listed in interfaces below (read-only documentation and store introspection, the skills on this card) and the REST API described by the OpenAPI document, which is where catalog, cart, checkout, payment and order operations live.","publisher":{"name":null,"url":"https://brainerce.com"},"homepage":"https://brainerce.com/docs","repository":null,"version":"3.0.0","license":null,"protocols":["a2a"],"tags":[],"pricing":null,"endpoints":[{"url":"https://brainerce.com","type":"a2a","auth":"none","probeable":true}],"skills":[{"name":"get-sdk-docs","tags":[],"description":"Get Brainerce SDK documentation for a specific topic. Returns setup instructions, API usage, code examples, and best practices. Start with \"setup\" or \"critical-rules\", then request specific topics as needed."},{"name":"get-type-definitions","tags":[],"description":"Get TypeScript type definitions from the Brainerce SDK, segmented by domain. Use this when you need to understand the exact shape of objects like Product, Cart, Checkout, Order, etc."},{"name":"get-code-example","tags":[],"description":"Get a short, focused TypeScript snippet for a specific Brainerce SDK operation. Framework-neutral — no Next.js file paths, no Tailwind, no framework-specific imports. Use this when you need the exact shape of a tricky SDK call (payment confirmation, reservation countdown, OAuth redirect, variant selection, etc.). For full SDK reference by topic, use get-sdk-docs instead."},{"name":"get-store-info","tags":[],"description":"Fetch live store information from the Brainerce API using a sales channel ID. Returns the channel display name (what the user sees in their dashboard), parent store name, currency, and language. Use this to personalize the store being built — prefer the channel name for user-facing text since a single Brainerce store can have multiple sales channels."},{"name":"get-store-capabilities","tags":[],"description":"Get live store capabilities and configured features for a sales channel. Returns what payment providers, OAuth, shipping, discounts, and other features are set up. Use this to discover what your store supports and what pages/components to build."},{"name":"get-integration-guide","tags":[],"description":"Get the Brainerce integration guide for connecting any website to Brainerce. Returns step-by-step instructions with full API endpoints, request/response examples, and code snippets. Use \"core\" for the main guide (products, cart, checkout, payment, orders), \"optional\" for extra features (accounts, OAuth, promotions), or \"rules\" for validation, error codes, and edge cases."},{"name":"get-critical-rules","tags":[],"description":"Get the do's and don'ts for building a Brainerce store. Returns framework-neutral rules that cause production incidents if violated — SDK usage, state management, auth token handling, checkout invariants, i18n, and type safety. Call this before writing SDK code."},{"name":"get-business-flows","tags":[],"description":"Get the non-negotiable business flows for a Brainerce store. Returns ordered SDK call sequences for checkout, auth, password reset, OAuth, order confirmation, cart persistence, and inventory reservation. Framework-neutral — no file paths, no framework-specific code. Call this before implementing any of these flows."},{"name":"get-required-features","tags":[],"description":"Get the functional coverage checklist for a Brainerce store. Returns user-capability-level features (what users must be able to do) rather than pages or file paths. Every feature marked mandatory must exist in the finished build, even when the underlying capability is currently disabled — those features auto-hide and store owners enable them later. Pass a salesChannelId to tune the checklist to the live store; without it, returns the generic complete-store checklist."},{"name":"get-store-config","tags":[],"description":"Get how a specific storefront feature is actually CONFIGURED for this store — not just whether it's enabled (use get-store-capabilities for that). Returns real shipping destinations, payment provider details, OAuth provider list, tax classes, categories/brands/tags, and active discount banners. Call this before building a feature's UI once get-store-capabilities said it's enabled. Only works reliably against a TEST-mode sales channel — a LIVE channel rejects this server's request (no browser Or…"},{"name":"get-product-shape","tags":[],"description":"Get a real product's SHAPE — its option/variant structure and modifier groups (add-ons) — so a generated product page actually renders what this store sells instead of guessing. Call this before building a product-detail page; a product with modifier groups needs an add-on picker, a variable product needs an option selector, and get-store-capabilities alone cannot tell you that. Returns structure, not content: variant/option counts and a small sample, not every row."},{"name":"list-store-products","tags":[],"description":"Orientation: list a store's real products (id, name, slug, and whether each has variants or modifier groups) so you know WHICH product to inspect with get-product-shape before generating its page. Minimal fields on purpose — this is a lookup, not a catalog dump."}],"tools":["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"],"extra":null,"attribution":{"kind":"a2a_card","name":"a2a_card","summary":"a2a_card","version":"a2a_card","description":"a2a_card","homepageUrl":"a2a_card","publisherUrl":"a2a_card"}},"derived":{"capabilities":[{"slug":"commerce.payments","name":"Payments","confidence":1,"provenance":"derived"},{"slug":"commerce.ecommerce","name":"E-commerce Operations","confidence":1,"provenance":"derived"},{"slug":"data.apis","name":"API Access","confidence":0.814,"provenance":"derived"}],"categories":["commerce","data"],"language":null},"observed":{"status":"unknown","statusReason":"Not checked yet.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[{"at":"2026-09-09T03:22:42.204Z","kind":"a2a_card","ok":true,"httpStatus":200,"latencyMs":101,"error":null,"detail":{"name":"brainerce","signed":false,"version":"3.0.0","cardPath":"/.well-known/agent-card.json","skillCount":12}}],"tools":null,"package":null},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"a2a_card","key":"https://brainerce.com/.well-known/agent-card.json","url":"https://brainerce.com/.well-known/agent-card.json","firstSeenAt":"2026-09-09T02:23:50.331Z","fetchedAt":"2026-09-09T02:23:50.331Z","normalizedAt":"2026-09-09T02:23:50.331Z"}]},"firstSeenAt":"2026-09-09T02:23:50.331Z","updatedAt":"2026-09-09T02:23:50.490Z"}