Developers & API

BHPB Developer Portal & API Documentation

Welcome to the BHPB (Baggy Pants for Snowboarding) Developer Portal. bhpb.shop provides standardized, machine-readable interfaces designed for autonomous AI agents (Claude Code, Cursor, Ora), shopping assistants, and developers.

1. OpenAPI Specification & Agent Manifests

2. Public Storefront REST API (Free Tier, Self-Serve)

Catalog endpoints are publicly accessible without authentication, billing requirements, or rate friction:

  • GET /products.json – Lists all published products, prices, variants, sizing options, and inventory statuses. Supports pagination via limit (1–250) and page.
  • GET /products/{handle}.json – Full product specifications and media for a specific item (e.g. illuminati, gsou-snow, pinky, orbit).
  • GET /collections.json – Lists all collections.
  • GET /collections/{handle}/products.json – Filtered products within a specific collection.

3. Scoped Permissions & Authentication (RFC 9728)

Declared machine-readable security scopes for least-privilege agent access:

  • products:read – Public read-only catalog browsing. Open access, no API key required.
  • cart:write – Session-scoped cart creation and checkout preparation via Storefront API or UCP protocol.

4. Sandbox & Testing Environment

For headless and agentic experimentation, developers can test against the free public Storefront GraphQL mock sandbox at https://mock.shop (no signup needed). Live test carts can also be validated on bhpb.shop using test promo code BHPB10.

5. Model Context Protocol (MCP)

BHPB exposes its Universal Commerce Protocol MCP server at https://bhpb.shop/api/ucp/mcp, allowing compliant agents to discover catalog items, inspect sizing guides, and manage shopping sessions under buyer authorization.