Primary

Primary (Primary Kids, Inc.) is a direct-to-consumer children's apparel brand selling simple, slogan-free, mix-and-match clothing "in all colors, for all kids" — babies through age 14, plus adult sizes, swimwear, school uniforms and licensed Sesame Street collaborations. The company operates a Shopify-hosted online store at primary.com and is a portfolio company of Homebrew. Primary has no first-party developer API, but its storefront is agent-accessible: it serves a live hosted Shopify Storefront MCP server (catalog search, product lookup, cart, checkout, policy/FAQ lookup) and exposes Shopify's Customer Account API (OAuth2/OIDC) for customer-scoped operations, along with a published llms.txt agent-instructions document.

Primary is profiled on the APIs.io network. Tagged areas include Company, Consumer, Retail, E-Commerce, and Apparel.

Primary’s developer surface includes authentication and 7 more developer resources.

🌐 Visit website 📡 Source on GitHub

10.3/100 minimal ▬ flat Agent 19/100 agent aware Full breakdown ↓
scored 2026-09-08 · rubric v0.20.0

AccessSelf serve

0 APIs 1 MCP Servers

Company Consumer Retail E-Commerce Apparel Children Shopify Agents

Kin Score

Kin Score How this is scored →
scored 2026-09-08 · rubric v0.20.0

Composite quality — 10.3/100 · minimal

Contract Quality 0.0 / 25

Developer Ergonomics 2.4 / 20

Access Clarity 0.0 / 20

Operational Transparency 0.0 / 13

Contract Governance 2.2 / 12

Discoverability 5.7 / 10

Agent readiness — 19/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 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

Delegated User Identity 6 / 6

Protected Resource Metadata 0 / 5

Registration Without a Human 0 / 6

Agentic Commerce Well-Known Document 0 / 5

Create-or-Update Ergonomics could not be measured. We hold no machine-readable contract for this provider to read, so there is nothing to measure a write surface against. Excluded rather than scored zero: never-measured and measured-empty are different facts. Publishing an OpenAPI is what makes this facet — and several others — scorable at all.

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from github.com/api-evangelist/primary: open an issue to ask a question, or submit a pull request to add artifacts. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

MCP Servers 1

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

Primary Shopify Storefront MCP

MCP SERVER

Security Posture 2

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

Primary Authentication

oauth2/openIdConnect · 1 scheme

SECURITY

Primary Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Primary Scopes

4 scopes · authorizationCode

4 scopes

SCOPES

Resources

Agent Surfaces 3

MCP servers, agent skills, and machine-readable catalogs

MCPServer

MCPServer

LLMsTxt

LLMsTxt

WellKnown

WellKnown

Design & Contract 1

Pagination, idempotency, versioning, errors, and events

Conformance

Conformance

Access & Security 3

Authentication, authorization, and security posture

Authentication

Authentication

OAuthScopes

OAuthScopes

DomainSecurity

DomainSecurity

Company 1

The organization behind the API

Website

Website

Source (apis.yml)

aid: primary
name: Primary
description: 'Primary (Primary Kids, Inc.) is a direct-to-consumer children''s apparel brand selling simple, slogan-free,
  mix-and-match clothing "in all colors, for all kids" — babies through age 14, plus adult sizes, swimwear, school uniforms
  and licensed Sesame Street collaborations. The company operates a Shopify-hosted online store at primary.com and is a portfolio
  company of Homebrew. Primary has no first-party developer API, but its storefront is agent-accessible: it serves a live
  hosted Shopify Storefront MCP server (catalog search, product lookup, cart, checkout, policy/FAQ lookup) and exposes Shopify''s
  Customer Account API (OAuth2/OIDC) for customer-scoped operations, along with a published llms.txt agent-instructions document.'
url: https://raw.githubusercontent.com/api-evangelist/primary/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- homebrew
x-tier: stub
x-tier-reason: portfolio-lead
deliveryModel:
  model: unknown
  open_source: false
  commercial: false
  callable_host: false
  label: Delivery model not determined — needs a product licence on record
  confidence: low
  source:
  - none
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  generated: '2026-07-22'
  method: derived
specificationVersion: '0.23'
created: '2026-07-17'
modified: '2026-07-20'
tags:
- Company
- Consumer
- Retail
- E-Commerce
- Apparel
- Children
- Shopify
- Agents
tags_raw:
- Company
- Consumer
- Retail
- Ecommerce
- Apparel
- Children
- Shopify
- Agent
image: https://www.primary.com/favicon.ico
apis: []
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Website
  url: https://www.primary.com
- type: MCPServer
  name: Primary Shopify Storefront MCP
  url: mcp/primary-mcp.yml
- type: LLMsTxt
  url: llms/primary-llms.txt
- type: WellKnown
  url: well-known/primary-well-known.yml
- type: Authentication
  url: authentication/primary-authentication.yml
- type: OAuthScopes
  url: scopes/primary-scopes.yml
- type: Conformance
  url: conformance/primary-conformance.yml
- type: DomainSecurity
  url: security/primary-domain-security.yml
x-enrichment:
  date: '2026-07-20'
  status: enriched
  artifacts_added: 9
  pass: local-v1

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/primary"

All providers

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

Every operation they expose

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

How their score was established

curl "https://apis.io/api/v1/providers/primary/evidence"

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

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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