Hero Bread

Hero Bread is an American food-technology company that makes low-net-carb, high-fiber, zero-sugar baked goods — sliced breads, tortillas, buns, rolls and bagels — sold direct-to-consumer from hero.co and through grocery and foodservice retail. It is not a developer-tools company and publishes no developer portal, OpenAPI description or API documentation. It does, however, operate a live agent-commerce surface on its own storefront subdomain: shop.hero.co serves an llms.txt and an agents.md, a Universal Commerce Protocol (UCP) merchant profile at /.well-known/ucp, and an unauthenticated MCP endpoint at /api/ucp/mcp exposing thirteen catalog, cart, checkout and order tools — a Shopify platform capability exposed on the merchant's own host against the merchant's own catalog.

Hero Bread publishes 1 API on the APIs.io network. Tagged areas include Company, Food and Beverage, Consumer Packaged Goods, Retail, and E-Commerce.

Hero Bread’s developer surface includes documentation, support, engineering blog, pricing, authentication, and 20 more developer resources.

🌐 Visit website 📡 Source on GitHub

24.6/100 emerging ▬ flat Agent 28/100 agent aware Full breakdown ↓
scored 2026-08-25 · rubric v0.14.0

1 APIs 1 MCP Servers

Company Food and Beverage Consumer Packaged Goods Retail E-Commerce Agent CommerceModel Context ProtocolUniversal Commerce Protocol Shopify Direct to Consumer

Kin Score

Kin Score How this is scored →
scored 2026-08-25 · rubric v0.14.0

Composite quality — 24.6/100 · emerging

Contract Quality 0.0 / 25

Developer Ergonomics 6.1 / 20

Access Clarity 7.6 / 20

Operational Transparency 0.0 / 13

Contract Governance 2.2 / 12

Discoverability 8.7 / 10

Agent readiness — 28/100 · agent aware

Machine-Readable Contract 0 / 18

Agentic Access Contract 0 / 10

Documented Reversibility 0 / 6

MCP Server 12 / 12

Machine-Readable Auth 10 / 10

Idempotency 9 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 5 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Delegated User Identity 6 / 6

Protected Resource Metadata 5 / 5

Registration Without a Human 0 / 6

Agentic Commerce Surface 5 / 5

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/hero-bread: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 1

Individual APIs this provider publishes, each with its own machine-readable definition.

Hero Bread Storefront Agent Commerce (UCP/MCP)

The agent-facing commerce interface for the Hero Bread online store. An MCP server at https://shop.hero.co/api/ucp/mcp implements the Universal Commerce Protocol shopping servic...

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Rate Limits 1

Documented rate limits and quota policies.

Scopes 1

OAuth scopes governing access to this provider's APIs.

Hero Bread Scopes

4 scopes · authorizationCode

4 scopes

SCOPES

Resources

Get Started 1

Portal, sign-up, and the first successful call

Login

Documentation 1

Reference material describing how the API behaves

Documentation

Documentation

Agent Surfaces 4

MCP servers, agent skills, and machine-readable catalogs

MCPServer

LLMsTxt

WellKnown

AgentSkill

Design & Contract 6

Pagination, idempotency, versioning, errors, and events

Conventions

Idempotency

ErrorCatalog

DataModel

Conformance

Lifecycle

Build 2

SDKs, sample code, and the tooling you integrate with

ToolCrosswalk

ToolCrosswalk

Packages

Packages

Access & Security 3

Authentication, authorization, and security posture

Authentication

Authentication

OAuthScopes

OAuthScopes

DomainSecurity

DomainSecurity

Operate 2

Status, limits, changes, and where to get help

Support

Support

RateLimits

RateLimits

Commercial 4

Pricing, plans, and the legal terms of use

Pricing

TermsOfService

PrivacyPolicy

Plans

Company 2

The organization behind the API

Website

Website

Blog

Blog

Source (apis.yml)

aid: hero-bread
name: Hero Bread
description: 'Hero Bread is an American food-technology company that makes low-net-carb, high-fiber, zero-sugar baked goods
  — sliced breads, tortillas, buns, rolls and bagels — sold direct-to-consumer from hero.co and through grocery and foodservice
  retail. It is not a developer-tools company and publishes no developer portal, OpenAPI description or API documentation.
  It does, however, operate a live agent-commerce surface on its own storefront subdomain: shop.hero.co serves an llms.txt
  and an agents.md, a Universal Commerce Protocol (UCP) merchant profile at /.well-known/ucp, and an unauthenticated MCP endpoint
  at /api/ucp/mcp exposing thirteen catalog, cart, checkout and order tools — a Shopify platform capability exposed on the
  merchant''s own host against the merchant''s own catalog.'
image: https://cdn.sanity.io/images/85daklna/production/028e6f6b81bdfad5074d500c93636f8f18866203-2000x1670.webp
url: https://raw.githubusercontent.com/api-evangelist/hero-bread/refs/heads/main/apis.yml
x-type: company
x-source: harvest:secondary-market
x-tier: profiled
x-tier-reason: agent-commerce-surface
specificationVersion: '0.20'
created: '2026-08-22'
modified: '2026-08-22'
tags:
- Company
- Food and Beverage
- Consumer Packaged Goods
- Retail
- E-Commerce
- Agent Commerce
- Model Context Protocol
- Universal Commerce Protocol
- Shopify
- Direct to Consumer
apis:
- aid: hero-bread:hero-bread-ucp-mcp
  name: Hero Bread Storefront Agent Commerce (UCP/MCP)
  description: The agent-facing commerce interface for the Hero Bread online store. An MCP server at https://shop.hero.co/api/ucp/mcp
    implements the Universal Commerce Protocol shopping service (dev.ucp.shopping) with thirteen tools spanning catalog search
    and lookup, cart create/read/ update/cancel, checkout create/read/update/complete/cancel, and order read. tools/list answers
    anonymously; tools/call requires a resolvable UCP agent profile and, for transactional tools, a Shopify agent JWT. complete_checkout
    requires an idempotency key and, per the store's own published rules, explicit contemporaneous buyer approval before payment.
  humanURL: https://shop.hero.co/agents.md
  baseURL: https://shop.hero.co/api/ucp/mcp
  tags:
  - Agent Commerce
  - Catalog
  - Cart
  - Checkout
  - Orders
  properties:
  - type: Documentation
    url: https://shop.hero.co/agents.md
  - type: MCPServer
    url: mcp/hero-bread-mcp.yml
  - type: LLMsTxt
    url: llms/hero-bread-llms.txt
  - type: Authentication
    url: authentication/hero-bread-authentication.yml
  - type: OAuthScopes
    url: scopes/hero-bread-scopes.yml
  - type: Conventions
    url: conventions/hero-bread-conventions.yml
  - type: Idempotency
    url: conventions/hero-bread-conventions.yml
  - type: ErrorCatalog
    url: errors/hero-bread-problem-types.yml
  - type: DataModel
    url: data-model/hero-bread-data-model.yml
  - type: Conformance
    url: conformance/hero-bread-conformance.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Website
  url: https://www.hero.co/
- type: Documentation
  url: https://shop.hero.co/agents.md
- type: Support
  url: https://www.hero.co/contact
- type: Blog
  url: https://www.hero.co/blog
- type: Pricing
  url: https://www.hero.co/products
- type: Login
  url: https://shop.hero.co/account/login
- type: TermsOfService
  url: https://www.hero.co/terms
- type: PrivacyPolicy
  url: https://www.hero.co/privacy
- type: MCPServer
  url: mcp/hero-bread-mcp.yml
- type: ToolCrosswalk
  url: mcp/hero-bread-tool-crosswalk.yml
- type: LLMsTxt
  url: llms/hero-bread-llms.txt
- type: WellKnown
  url: well-known/hero-bread-well-known.yml
- type: AgentSkill
  url: skills/_index.yml
- type: Authentication
  url: authentication/hero-bread-authentication.yml
- type: OAuthScopes
  url: scopes/hero-bread-scopes.yml
- type: Conventions
  url: conventions/hero-bread-conventions.yml
- type: Idempotency
  url: conventions/hero-bread-conventions.yml
- type: ErrorCatalog
  url: errors/hero-bread-problem-types.yml
- type: DataModel
  url: data-model/hero-bread-data-model.yml
- type: Conformance
  url: conformance/hero-bread-conformance.yml
- type: Lifecycle
  url: lifecycle/hero-bread-lifecycle.yml
- type: Plans
  url: plans/hero-bread-plans-pricing.yml
- type: RateLimits
  url: rate-limits/hero-bread-rate-limits.yml
- type: Packages
  url: packages/hero-bread-packages.yml
- type: DomainSecurity
  url: security/hero-bread-domain-security.yml
x-enrichment:
  date: '2026-08-22'
  status: enriched
  artifacts_added: 25
  pass: local-v1
x-coverage:
  state: covered
  reason: agent-commerce-surface-live
  detail: Hero Bread ships no developer program, but its storefront host shop.hero.co serves a live, anonymously-discoverable
    UCP merchant profile and an MCP endpoint whose tools/list returned 13 real tools with JSON Schema input contracts.
  evidence:
  - url: https://shop.hero.co/.well-known/ucp
    status: 200
  - url: https://shop.hero.co/api/ucp/mcp
    status: 200
  - url: https://shop.hero.co/llms.txt
    status: 200
  - url: https://www.hero.co/.well-known/agent-card.json
    status: 404
  checked: '2026-08-22'

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/hero-bread"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/hero-bread/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/hero-bread/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.