Bombas

Bombas is a New York City based direct-to-consumer comfort apparel brand founded in 2013 by David Heath and Randy Goldberg, selling socks, underwear, t-shirts and slippers on a one-purchased-equals-one-donated model that has powered more than 200 million donated items through a network of over 4,000 giving partners serving people experiencing homelessness. The company is privately held, was funded on Shark Tank in 2014, and runs its ecommerce on Shopify Plus. Bombas does not publish a first-party developer program or REST API, but its storefront at shop.bombas.com exposes a real agent-facing commerce surface: a published llms.txt / agents.md, a Universal Commerce Protocol (UCP) merchant profile at /.well-known/ucp, and a live MCP endpoint at /api/ucp/mcp implementing the UCP Shopping Service, alongside OAuth 2.0 / OpenID Connect discovery for Shopify customer accounts.

Bombas publishes 1 API on the APIs.io network. Tagged areas include Company, Retail, Ecommerce, Apparel, and Direct to Consumer.

Bombas’ developer surface includes documentation, support, signup flow, and 6 more developer resources.

🌐 Visit website 📡 Source on GitHub
20.3/100 emerging ▬ flat Agent 0/100 human only Full breakdown ↓
scored 2026-08-05 · rubric v0.9.1
1 APIs 1 MCP Servers
CompanyRetailEcommerceApparelDirect to ConsumerCommerceAgentic CommerceUniversal Commerce ProtocolModel Context ProtocolShopify

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-05 · rubric v0.9.1
Composite quality — 20.3/100 · emerging
Contract Quality 0.0 / 25
Developer Ergonomics 2.6 / 20
Commercial Clarity 6.8 / 20
Operational Transparency 0.7 / 13
Governance 1.5 / 12
Discoverability 8.7 / 10
Agent readiness — 0/100 · human only
Machine-Readable Contract 0 / 18
Agentic Access Contract 0 / 10
MCP Server 0 / 12
Machine-Readable Auth 0 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 0 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
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/bombas: 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.

Bombas Commerce (UCP Shopping)

The agent-facing commerce surface of the Bombas Shopify storefront. The store publishes a Universal Commerce Protocol merchant profile at https://shop.bombas.com/.well-known/ucp...

MCP Servers 1

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

bombas-mcp.yml

MCP SERVER

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Bombas Authentication

oauth2/openIdConnect/custom-header · 3 schemes

SECURITY

Bombas Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Bombas Scopes

4 scopes · authorizationCode

4 scopes

SCOPES

Resources

Get Started 1

Portal, sign-up, and the first successful call

SignUp
SignUp

Documentation 1

Reference material describing how the API behaves

Documentation
Documentation

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization

Access & Security 1

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity

Operate 1

Status, limits, changes, and where to get help

Support
Support

Commercial 2

Pricing, plans, and the legal terms of use

TermsOfService
TermsOfService
 PrivacyPolicy
PrivacyPolicy

Company 1

The organization behind the API

Website
Website

Other 1

Properties that don't map to a standard resource type

SecondaryMarket
SecondaryMarket

Source (apis.yml)

apis.yml Raw ↑ 
aid: bombas
name: Bombas
description: 'Bombas is a New York City based direct-to-consumer comfort apparel brand founded in 2013 by David Heath and
  Randy Goldberg, selling socks, underwear, t-shirts and slippers on a one-purchased-equals-one-donated model that has powered
  more than 200 million donated items through a network of over 4,000 giving partners serving people experiencing homelessness.
  The company is privately held, was funded on Shark Tank in 2014, and runs its ecommerce on Shopify Plus. Bombas does not
  publish a first-party developer program or REST API, but its storefront at shop.bombas.com exposes a real agent-facing commerce
  surface: a published llms.txt / agents.md, a Universal Commerce Protocol (UCP) merchant profile at /.well-known/ucp, and
  a live MCP endpoint at /api/ucp/mcp implementing the UCP Shopping Service, alongside OAuth 2.0 / OpenID Connect discovery
  for Shopify customer accounts.'
url: https://raw.githubusercontent.com/api-evangelist/bombas/refs/heads/main/apis.yml
image: https://avatars.githubusercontent.com/u/30065139?v=4
x-type: company
x-source: harvest:secondary-market
x-tier: stub
x-tier-reason: harvest
specificationVersion: '0.20'
created: '2026-07-31'
modified: '2026-07-31'
tags:
- Company
- Retail
- Ecommerce
- Apparel
- Direct to Consumer
- Commerce
- Agentic Commerce
- Universal Commerce Protocol
- Model Context Protocol
- Shopify
apis:
- aid: bombas:commerce
  name: Bombas Commerce (UCP Shopping)
  description: The agent-facing commerce surface of the Bombas Shopify storefront. The store publishes a Universal Commerce
    Protocol merchant profile at https://shop.bombas.com/.well-known/ucp declaring UCP versions 2026-04-08 and 2026-01-23,
    the dev.ucp.shopping service over an MCP transport at https://shop.bombas.com/api/ucp/mcp, and the checkout, cart, fulfillment,
    discount and payment-handler capabilities. The MCP endpoint implements the UCP Shopping Service OpenRPC contract of 13
    methods covering catalog search, cart, checkout and order retrieval. tools/list is gated behind a UCP-Agent profile URI,
    so tool input schemas come from the published OpenRPC schema the merchant profile itself points at, not from live introspection.
  humanURL: https://shop.bombas.com/agents.md
  baseURL: https://shop.bombas.com/api/ucp/mcp
  tags:
  - Commerce
  - Agentic Commerce
  - Model Context Protocol
  - Universal Commerce Protocol
  - Checkout
  - Cart
  - Catalog
  properties:
  - type: MCPServer
    url: mcp/bombas-mcp.yml
  - type: LLMsTxt
    url: llms/bombas-llms.txt
  - type: WellKnown
    url: well-known/bombas-well-known.yml
  - type: Authentication
    url: authentication/bombas-authentication.yml
  - type: OAuthScopes
    url: scopes/bombas-scopes.yml
  - type: Conventions
    url: conventions/bombas-conventions.yml
  - type: Idempotency
    url: conventions/bombas-conventions.yml
  - type: ErrorCatalog
    url: errors/bombas-problem-types.yml
  - type: DataModel
    url: data-model/bombas-data-model.yml
  - type: Lifecycle
    url: lifecycle/bombas-lifecycle.yml
  - type: Conformance
    url: conformance/bombas-conformance.yml
  - type: AgentSkill
    url: skills/_index.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: DomainSecurity
  url: security/bombas-domain-security.yml
- type: Website
  url: https://bombas.com/
- type: Documentation
  url: https://shop.bombas.com/agents.md
- type: GitHubOrganization
  url: https://github.com/bombas
- type: Support
  url: https://shop.bombas.com/pages/help
- type: SignUp
  url: https://shop.bombas.com/account/login
- type: TermsOfService
  url: https://shop.bombas.com/policies/terms-of-service
- type: PrivacyPolicy
  url: https://shop.bombas.com/policies/privacy-policy
- type: SecondaryMarket
  url: https://forgeglobal.com/bombas_stock/
x-enrichment:
  date: '2026-07-31'
  status: enriched
  artifacts_added: 19
  pass: local-v1