Black Buffalo

Black Buffalo Inc. is an American smokeless tobacco alternative company founded in 2015 and headquartered in Chicago, Illinois, selling nicotine pouches, long cut dip and its nicotine-free ZERO line direct to adult consumers at blackbuffalo.com and through convenience and fuel retailers. Imperial Brands' U.S. subsidiary ITG Brands acquired the company in May 2026. Black Buffalo runs no developer program and publishes no OpenAPI, but its Shopify-hosted storefront exposes a substantial machine-readable surface from its own domain: an anonymously introspectable Storefront GraphQL API, TWO live Model Context Protocol servers whose tools/list both answer anonymously, a Universal Commerce Protocol merchant profile at /.well-known/ucp, OpenID Connect and RFC 8414 discovery for customer accounts, and a provider-authored /agents.md and /llms.txt that tell AI agents which surface to use, what claims they may not make about a regulated nicotine product, and that no agent may finalize payment without contemporaneous human approval.

Black Buffalo publishes 3 APIs on the APIs.io network. Tagged areas include Company, Consumer Packaged Goods, Nicotine Pouches, Smokeless Tobacco Alternative, and Ecommerce.

Black Buffalo’s developer surface includes documentation, authentication, FAQ, engineering blog, support, signup flow, and 25 more developer resources.

🌐 Visit website 📡 Source on GitHub

34.6/100 thin ▬ flat Agent 50/100 agent ready Full breakdown ↓
scored 2026-08-17 · rubric v0.11.0

3 APIs 1 MCP Servers

CompanyConsumer Packaged GoodsNicotine PouchesSmokeless Tobacco AlternativeEcommerceDirect to ConsumerRetailAgentic CommerceShopifyGraphQLModel Context ProtocolUniversal Commerce Protocol

Kin Score

Kin Score How this is scored →
scored 2026-08-17 · rubric v0.11.0

Composite quality — 34.6/100 · thin

Contract Quality 10.8 / 25

Developer Ergonomics 7.3 / 20

Commercial Clarity 6.8 / 20

Operational Transparency 0.0 / 13

Governance 1.5 / 12

Discoverability 8.2 / 10

Agent readiness — 50/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 12 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 0 / 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

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/black-buffalo: 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 3

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

MCP Servers 1

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

Scopes 1

OAuth scopes governing access to this provider's APIs.

Black Buffalo Scopes

4 scopes · authorizationCode

4 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Black Buffalo Agentic Access

0 operations

0 operations · 0 acting

AGENTIC

Resources

Get Started 2

Portal, sign-up, and the first successful call

SignUp

SignUp

Login

Documentation 2

Reference material describing how the API behaves

Documentation

Documentation

GraphQL

GraphQL

Agent Surfaces 5

MCP servers, agent skills, and machine-readable catalogs

LLMsTxt

WellKnown

MCPServer

AgenticAccess

AgentSkill

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

DataModel

Conventions

ErrorCatalog

Lifecycle

Conformance

Build 1

SDKs, sample code, and the tooling you integrate with

ToolCrosswalk

ToolCrosswalk

Access & Security 3

Authentication, authorization, and security posture

Authentication

Authentication

OAuthScopes

OAuthScopes

DomainSecurity

DomainSecurity

Operate 3

Status, limits, changes, and where to get help

FAQ

FAQ

ContactUs

ContactUs

Support

Support

Commercial 2

Pricing, plans, and the legal terms of use

TermsOfService

TermsOfService

PrivacyPolicy

PrivacyPolicy

Company 3

The organization behind the API

Website

Website

Blog

Blog

About

About

Other 5

Properties that don't map to a standard resource type

StoreLocator

RefundPolicy

ShippingPolicy

LoyaltyProgram

SecondaryMarket

Source (apis.yml)

aid: black-buffalo
name: Black Buffalo
description: 'Black Buffalo Inc. is an American smokeless tobacco alternative company founded in 2015 and headquartered in
  Chicago, Illinois, selling nicotine pouches, long cut dip and its nicotine-free ZERO line direct to adult consumers at blackbuffalo.com
  and through convenience and fuel retailers. Imperial Brands'' U.S. subsidiary ITG Brands acquired the company in May 2026.
  Black Buffalo runs no developer program and publishes no OpenAPI, but its Shopify-hosted storefront exposes a substantial
  machine-readable surface from its own domain: an anonymously introspectable Storefront GraphQL API, TWO live Model Context
  Protocol servers whose tools/list both answer anonymously, a Universal Commerce Protocol merchant profile at /.well-known/ucp,
  OpenID Connect and RFC 8414 discovery for customer accounts, and a provider-authored /agents.md and /llms.txt that tell
  AI agents which surface to use, what claims they may not make about a regulated nicotine product, and that no agent may
  finalize payment without contemporaneous human approval.'
url: https://raw.githubusercontent.com/api-evangelist/black-buffalo/refs/heads/main/apis.yml
x-type: company
x-source: harvest:secondary-market
x-tier: profiled
x-tier-reason: enrichment-pipeline
image: https://cdn.shopify.com/s/files/1/2258/8521/files/Black-Buffalo-Social-Sharing-Image.jpg?v=1738521407
specificationVersion: '0.20'
created: '2026-08-07'
modified: '2026-08-07'
tags:
- Company
- Consumer Packaged Goods
- Nicotine Pouches
- Smokeless Tobacco Alternative
- Ecommerce
- Direct to Consumer
- Retail
- Agentic Commerce
- Shopify
- GraphQL
- Model Context Protocol
- Universal Commerce Protocol
apis:
- aid: black-buffalo:storefront-graphql
  name: Black Buffalo Storefront GraphQL API
  description: The Shopify Storefront GraphQL API as served from Black Buffalo's own domain. Introspection is anonymous —
    the full schema (424 types, 35 query fields, 41 mutations, 28 Relay connections) was retrieved without a Storefront access
    token on 2026-08-07. Covers the product catalog, collections, cart and checkout preparation, editorial content, store
    policies and customer accounts.
  humanURL: https://shopify.dev/docs/api/storefront
  baseURL: https://blackbuffalo.com/api/2026-04/graphql.json
  tags:
  - GraphQL
  - Ecommerce
  - Catalog
  - Cart
  properties:
  - type: GraphQL
    url: graphql/black-buffalo-storefront.graphql
  - type: GraphQLManifest
    url: graphql/black-buffalo-graphql.yml
  - type: DataModel
    url: data-model/black-buffalo-data-model.yml
- aid: black-buffalo:storefront-mcp
  name: Black Buffalo Storefront MCP Server
  description: A live Model Context Protocol server on Black Buffalo's storefront host. An anonymous JSON-RPC tools/list returned
    five tools with full JSON Schema input contracts — search_catalog, get_product_details, get_cart, update_cart and search_shop_policies_and_faqs.
  humanURL: https://blackbuffalo.com/agents.md
  baseURL: https://blackbuffalo.com/api/mcp
  tags:
  - MCP
  - Agents
  - Ecommerce
  properties:
  - type: MCPServer
    url: mcp/black-buffalo-mcp.yml
  - type: ToolCrosswalk
    url: mcp/black-buffalo-tool-crosswalk.yml
- aid: black-buffalo:ucp-commerce
  name: Black Buffalo UCP Agentic Commerce API
  description: Black Buffalo implements the Universal Commerce Protocol for agent-driven commerce. The merchant profile at
    /.well-known/ucp declares UCP 2026-04-08 and 2026-01-23, the dev.ucp.shopping MCP service endpoint, the cart / checkout
    / fulfillment / discount / order / catalog capabilities and two payment handlers (Google Pay and Shopify card). Unusually,
    this endpoint's tools/list answers ANONYMOUSLY — thirteen tools with full JSON Schema input contracts, spanning the whole
    cart-to-completed-order lifecycle. Checkout completion still requires contemporaneous buyer approval.
  humanURL: https://ucp.dev/2026-04-08/specification/overview/
  baseURL: https://blackbuffalo.com/api/ucp/mcp
  tags:
  - UCP
  - Agentic Commerce
  - MCP
  - Checkout
  properties:
  - type: MCPServer
    url: mcp/black-buffalo-mcp.yml
  - type: AgenticAccess
    url: agentic-access/black-buffalo-agentic-access.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Website
  url: https://blackbuffalo.com/
- type: Documentation
  url: https://blackbuffalo.com/agents.md
- type: LLMsTxt
  url: llms/black-buffalo-llms.txt
- type: WellKnown
  url: well-known/black-buffalo-well-known.yml
- type: MCPServer
  url: mcp/black-buffalo-mcp.yml
- type: ToolCrosswalk
  url: mcp/black-buffalo-tool-crosswalk.yml
- type: AgenticAccess
  url: agentic-access/black-buffalo-agentic-access.yml
- type: GraphQL
  url: graphql/black-buffalo-storefront.graphql
- type: DataModel
  url: data-model/black-buffalo-data-model.yml
- type: Authentication
  url: authentication/black-buffalo-authentication.yml
- type: OAuthScopes
  url: scopes/black-buffalo-scopes.yml
- type: Conventions
  url: conventions/black-buffalo-conventions.yml
- type: ErrorCatalog
  url: errors/black-buffalo-problem-types.yml
- type: Lifecycle
  url: lifecycle/black-buffalo-lifecycle.yml
- type: Conformance
  url: conformance/black-buffalo-conformance.yml
- type: AgentSkill
  url: skills/_index.yml
- type: DomainSecurity
  url: security/black-buffalo-domain-security.yml
- type: FAQ
  url: https://blackbuffalo.com/pages/faq
- type: Blog
  url: https://blackbuffalo.com/blogs/stories
- type: About
  url: https://blackbuffalo.com/pages/our-story
- type: ContactUs
  url: https://blackbuffalo.com/pages/contact
- type: Support
  url: https://blackbuffalo.com/pages/contact
- type: StoreLocator
  url: https://blackbuffalo.com/a/locator/
- type: SignUp
  url: https://blackbuffalo.com/account/register
- type: Login
  url: https://blackbuffalo.com/account/login
- type: TermsOfService
  url: https://blackbuffalo.com/policies/terms-of-service
- type: PrivacyPolicy
  url: https://blackbuffalo.com/policies/privacy-policy
- type: RefundPolicy
  url: https://blackbuffalo.com/policies/refund-policy
- type: ShippingPolicy
  url: https://blackbuffalo.com/policies/shipping-policy
- type: LoyaltyProgram
  url: https://blackbuffalo.com/pages/rewards
- type: SecondaryMarket
  url: https://equityzen.com/company/blackbuffalo/
x-enrichment:
  date: '2026-08-07'
  status: enriched
  artifacts_added: 27
  pass: local-v1
x-coverage:
  state: covered
  reason: null
  detail: Contract discovery succeeded. Black Buffalo runs no developer program and publishes no OpenAPI, but three machine-readable
    surfaces answered anonymously from its own domain — Storefront GraphQL introspection, an MCP server at /api/mcp and a
    UCP commerce MCP server at /api/ucp/mcp whose tools/list returned all thirteen tools including complete_checkout.
  evidence:
  - url: https://blackbuffalo.com/api/2026-04/graphql.json
    status: 200
  - url: https://blackbuffalo.com/api/ucp/mcp
    status: 200
  - url: https://blackbuffalo.com/api/mcp
    status: 200
  - url: https://blackbuffalo.com/.well-known/ucp
    status: 200
  - url: https://blackbuffalo.com/openapi.json
    status: 404
  checked: '2026-08-07'