Premium Grounding Developers

Premium Grounding makes grounding (earthing) bed sheets and accessories. This page is for developers and AI agents who want to read our catalog, build a cart or connect an assistant to the Premium Grounding store. Everything here is public and needs no API key.

Quick reference

Resource	URL
OpenAPI 3.1 specification	https://premiumgrounding.com/openapi.json
Storefront MCP server	POST https://premiumgrounding.com/api/mcp
Universal Commerce Protocol (UCP) MCP server	POST https://premiumgrounding.com/api/ucp/mcp
UCP merchant profile	/.well-known/ucp
Agent instructions	/agents.md
Store facts for language models	/llms.txt
OAuth 2.0 metadata	/.well-known/oauth-authorization-server

Quickstart

Search the catalog:

curl "https://premiumgrounding.com/search/suggest.json?q=grounding+sheet&resources[type]=product"

Get one product with every variant, live price and stock flag:

curl "https://premiumgrounding.com/products/grounding-earthing-sheet.js"

List the whole range:

curl "https://premiumgrounding.com/products.json?limit=250"

Add a variant to the session cart:

curl -X POST "https://premiumgrounding.com/cart/add.js" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"id":VARIANT_ID,"quantity":1}]}'

Discover the MCP tools:

curl -X POST "https://premiumgrounding.com/api/ucp/mcp" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Markets, currency and prices

Prices and availability depend on the buyer's country. Prefix any path with a market folder to get that market's currency, for example /en-au/products/grounding-earthing-sheet.js. Market folders include /en-au, /en-nz, /en-ca, /en-uk and /de-de. Always read prices live. Do not cache them or quote them from memory.

On .js endpoints, money values are integers in the currency's minor unit. On .json endpoints they are decimal strings.

Choosing the right variant

The grounding sheet has three options: bed size, plug type and warranty. Each product ships with a plug for one region (AUS/NZ, USA, CA, UK/SG or EU), so match the plug type to the buyer's country before adding to the cart. Sizes and product details are in llms.txt.

Authentication and scopes

Catalog, search, cart and MCP tool discovery are anonymous. Operations tied to a buyer's identity use OAuth 2.0 (authorization code with PKCE). The scopes are published in scopes_supported in the OAuth metadata and declared in the OpenAPI security scheme:

• dev.ucp.shopping.catalog.search:read: read-only catalog search
• dev.ucp.shopping.checkout:manage: create and manage a checkout for the buyer
• customer-account-api:full and customer-account-mcp-api:full: the signed-in buyer's account, such as orders
• openid, email: identity

Request the narrowest scope that covers the task.

WebMCP tools for browser agents

Pages on premiumgrounding.com register in-page tools through WebMCP (document.modelContext) for browsers that support it. They cover catalog search, product details and the cart, plus get_store_facts, which returns the store's published facts on product use, sizes, trial, returns, warranty and shipping. In a browser without WebMCP nothing is registered.

Checkout rule

An agent may search, compare and build a cart. Payment always needs the buyer's own approval at the moment of purchase. Do not complete a checkout without it.

Errors

Cart endpoints return structured JSON errors with a status, a message and a description of what to fix:

{"status":422,"message":"Cart Error","description":"Cannot find variant"}

MCP endpoints return JSON-RPC 2.0 error objects. A 404 on a catalog path means the resource does not exist, so do not retry it.

Testing

There is no separate sandbox. Read endpoints are safe to call. The cart is scoped to your own session cookie, so building and clearing a test cart affects nobody else. Please keep request rates modest and cache catalog structure (not prices) where you can.

Policies and store facts

For trial, returns, warranty and shipping terms, read llms.txt, the refund policy and the shipping page. Quote those sources directly.

Contact

Questions about integrating with Premium Grounding: contact@premiumgrounding.com.