M.Gemi

M.Gemi is a Boston-based direct-to-consumer footwear and leather-goods brand founded in 2015 by Maria Gangemi and Cheryl Kaplan, selling handcrafted Italian shoes and handbags made in small batches by family-owned workshops across Italy and released weekly. Its public API surface is not a developer program but an agent-commerce surface: the mgemi.com storefront publishes an /llms.txt and /agents.md agent instruction document, a Universal Commerce Protocol (UCP) merchant profile at /.well-known/ucp, and a live, unauthenticated Model Context Protocol endpoint at /api/ucp/mcp exposing 13 tools for catalog search, cart, checkout and order retrieval, alongside the read-only Shopify storefront product JSON endpoints its own agent instructions document. Customer identity is served by a Shopify Customer Account OpenID Connect discovery document on the store host.

M.Gemi publishes 2 APIs on the APIs.io network. Tagged areas include Company, Retail, E-Commerce, Fashion, and Footwear.

M.Gemi’s developer surface includes documentation, authentication, support, engineering blog, signup flow, and 16 more developer resources.

🌐 Visit website 📡 Source on GitHub

26.0/100 emerging ▬ flat Agent 25/100 agent aware saas Full breakdown ↓
scored 2026-09-01 · rubric v0.17.2

2 APIs 1 MCP Servers

Company Retail E-Commerce Fashion Footwear Direct to Consumer Agentic Commerce Universal Commerce Protocol MCP Shopify Catalog Checkout

Kin Score

Kin Score How this is scored →
scored 2026-09-01 · rubric v0.17.2

Composite quality — 26.0/100 · emerging

Contract Quality 0.0 / 21

Developer Ergonomics 5.2 / 17

Access Clarity 5.8 / 17

Operational Transparency 0.0 / 11

Contract Governance 1.9 / 10

Discoverability 6.5 / 9

Regulatory Posture 8.2 / 15

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

Stable Error Semantics 8 / 8

Request/Response Examples 0 / 7

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

Delegated User Identity 6 / 6

Protected Resource Metadata 0 / 5

Registration Without a Human 0 / 6

Agentic Commerce Surface 5 / 5

Regulatory Posture applies to this provider. Its tags matched the Payments regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.

The six quality facets above are damped to 85 points between them, because the conditional facet above carries the other 15. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 85% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.

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/m-gemi: 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 2

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

M.Gemi UCP Commerce MCP API

The Universal Commerce Protocol (UCP) shopping service for the M.Gemi store, exposed over Model Context Protocol at https://mgemi.com/api/ucp/mcp. An anonymous tools/list return...

M.Gemi Storefront Product JSON

The read-only Shopify storefront JSON surface for the M.Gemi catalog, documented by the store's own /llms.txt for agents that only need to read store data without transacting: /...

MCP Servers 1

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

Rate Limits 1

Documented rate limits and quota policies.

Scopes 1

OAuth scopes governing access to this provider's APIs.

M Gemi Scopes

OAuth 2.0 · no documented scopes

0 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

Agent Surfaces 4

MCP servers, agent skills, and machine-readable catalogs

LLMsTxt

MCPServer

WellKnown

AgentSkill

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

Conventions

Idempotency

Conformance

ErrorCatalog

Lifecycle

Access & Security 3

Authentication, authorization, and security posture

Authentication

Authentication

OAuthScopes

OAuthScopes

DomainSecurity

DomainSecurity

Operate 2

Status, limits, changes, and where to get help

RateLimits

RateLimits

Support

Support

Commercial 3

Pricing, plans, and the legal terms of use

Plans

Plans

TermsOfService

TermsOfService

PrivacyPolicy

PrivacyPolicy

Company 2

The organization behind the API

Website

Website

Blog

Blog

Source (apis.yml)

aid: m-gemi
name: M.Gemi
description: 'M.Gemi is a Boston-based direct-to-consumer footwear and leather-goods brand founded in 2015 by Maria Gangemi
  and Cheryl Kaplan, selling handcrafted Italian shoes and handbags made in small batches by family-owned workshops across
  Italy and released weekly. Its public API surface is not a developer program but an agent-commerce surface: the mgemi.com
  storefront publishes an /llms.txt and /agents.md agent instruction document, a Universal Commerce Protocol (UCP) merchant
  profile at /.well-known/ucp, and a live, unauthenticated Model Context Protocol endpoint at /api/ucp/mcp exposing 13 tools
  for catalog search, cart, checkout and order retrieval, alongside the read-only Shopify storefront product JSON endpoints
  its own agent instructions document. Customer identity is served by a Shopify Customer Account OpenID Connect discovery
  document on the store host.'
deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: false
  label: Hosted service · you call their endpoint
  confidence: medium
  source:
  - pricing
  generated: '2026-08-28'
  method: derived
image: https://cdn.shopify.com/s/files/1/0136/6648/4283/files/logomark2_d8d577da-e62c-4ca0-85a8-03466eb5c403.png?v=1632354360
url: https://raw.githubusercontent.com/api-evangelist/m-gemi/refs/heads/main/apis.yml
x-type: company
x-source: harvest:secondary-market
specificationVersion: '0.20'
created: '2026-08-25'
modified: '2026-08-25'
tags:
- Company
- Retail
- E-Commerce
- Fashion
- Footwear
- Direct to Consumer
- Agentic Commerce
- Universal Commerce Protocol
- MCP
- Shopify
- Catalog
- Checkout
tags_raw:
- Company
- Retail
- E-Commerce
- Fashion
- Footwear
- Direct to Consumer
- Agentic Commerce
- Universal Commerce Protocol
- Model Context Protocol
- Shopify
- Catalog
- Checkout
x-enrichment:
  date: '2026-08-25'
  status: enriched
  artifacts_added: 20
  pass: local-v1
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
apis:
- name: M.Gemi UCP Commerce MCP API
  description: The Universal Commerce Protocol (UCP) shopping service for the M.Gemi store, exposed over Model Context Protocol
    at https://mgemi.com/api/ucp/mcp. An anonymous tools/list returns 13 tools with full JSON Schema inputSchemas covering
    catalog search and lookup, product detail, cart create/read/update/cancel, and checkout create/read/update/complete/cancel
    plus order retrieval. Checkout completion requires contemporaneous buyer approval per the store agent instructions.
  humanURL: https://mgemi.com/llms.txt
  baseURL: https://mgemi.com/api/ucp/mcp
  tags:
  - Agentic Commerce
  - MCP
  - Universal Commerce Protocol
  - Checkout
  - Catalog
  tags_raw:
  - Agentic Commerce
  - Model Context Protocol
  - Universal Commerce Protocol
  - Checkout
  - Catalog
  properties:
  - type: MCPServer
    url: mcp/m-gemi-mcp.yml
  - type: Documentation
    url: https://mgemi.com/agents.md
  - type: Authentication
    url: authentication/m-gemi-authentication.yml
  - type: RateLimits
    url: rate-limits/m-gemi-rate-limits.yml
- name: M.Gemi Storefront Product JSON
  description: 'The read-only Shopify storefront JSON surface for the M.Gemi catalog, documented by the store''s own /llms.txt
    for agents that only need to read store data without transacting: /products.json, /products/{handle}.json, /collections/{handle}/products.json,
    /cart.js, /meta.json and /search. No authentication is required. The store publishes 2,407 products across 709 collections.'
  humanURL: https://mgemi.com/llms.txt
  baseURL: https://mgemi.com
  tags:
  - Catalog
  - Product
  - E-Commerce
  - Read Only
  tags_raw:
  - Catalog
  - Products
  - E-Commerce
  - Read Only
  properties:
  - type: Documentation
    url: https://mgemi.com/llms.txt
common:
- type: Website
  url: https://mgemi.com
- type: Documentation
  url: https://mgemi.com/agents.md
- type: LLMsTxt
  url: llms/m-gemi-llms.txt
- type: MCPServer
  url: mcp/m-gemi-mcp.yml
- type: WellKnown
  url: well-known/m-gemi-well-known.yml
- type: Authentication
  url: authentication/m-gemi-authentication.yml
- type: OAuthScopes
  url: scopes/m-gemi-scopes.yml
- type: Conventions
  url: conventions/m-gemi-conventions.yml
- type: Idempotency
  url: conventions/m-gemi-conventions.yml
- type: Conformance
  url: conformance/m-gemi-conformance.yml
- type: RateLimits
  url: rate-limits/m-gemi-rate-limits.yml
- type: ErrorCatalog
  url: errors/m-gemi-problem-types.yml
- type: Plans
  url: plans/m-gemi-plans-pricing.yml
- type: Lifecycle
  url: lifecycle/m-gemi-lifecycle.yml
- type: AgentSkill
  url: skills/_index.yml
- type: DomainSecurity
  url: security/m-gemi-domain-security.yml
- type: Support
  url: https://mgemi.com/pages/faq
- type: Blog
  url: https://mgemi.com/blogs/news
- type: SignUp
  url: https://mgemi.com/account/login
- type: TermsOfService
  url: https://mgemi.com/policies/terms-of-service
- type: PrivacyPolicy
  url: https://mgemi.com/policies/privacy-policy

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/m-gemi"

All providers

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

Every operation they expose

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

How their score was established

curl "https://apis.io/api/v1/providers/m-gemi/evidence"

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

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

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