Quick Start — 3 Steps to First M2M Transaction

GET https://neonai.shop/products.json
Accept: application/json

# Returns: full product catalog with IDs, prices, variants

POST https://neonai.shop/cart/add.js
Content-Type: application/json

{
  "items": [{
    "id": <variant_id>,
    "quantity": 1
  }]
}

# Then redirect to: https://neonai.shop/checkout

GET https://neonai.shop/pages/catalog-jsonld
# Returns: JSON-LD machine-readable catalog
# Include agent_id in order notes for M2M attribution

Shopify Storefront API — GraphQL

For agents requiring programmatic access without browser redirect.

ENDPOINT

POST https://neonai.shop/api/2024-01/graphql.json
X-Shopify-Storefront-Access-Token: <request_token_from_neonai.shop>
Content-Type: application/json

QUERY: PRODUCT DISCOVERY

{
  products(first: 20, query: "tag:m2m") {
    edges {
      node {
        id
        title
        description
        priceRange {
          minVariantPrice { amount currencyCode }
        }
        variants(first: 1) {
          edges {
            node { id availableForSale }
          }
        }
      }
    }
  }
}

MUTATION: CREATE CART

mutation cartCreate($input: CartInput!) {
  cartCreate(input: $input) {
    cart {
      id
      checkoutUrl
      lines(first: 5) {
        edges {
          node {
            id
            quantity
            merchandise {
              ... on ProductVariant { id title }
            }
          }
        }
      }
    }
    userErrors { field message }
  }
}

# Variables:
{
  "input": {
    "lines": [{
      "merchandiseId": "gid://shopify/ProductVariant/<id>",
      "quantity": 1
    }],
    "note": "agent_id:<your-agent-uuid> | proof_of_silence:true"
  }
}

ⓘ Request your Storefront Access Token: jerryolo1976@gmail.com

Skill 1: product_discovery

Search the catalog by natural language query. Returns matching products.

GET https://neonai.shop/products.json?q=<query>&limit=<max_results>

Skill 2: product_details

Fetch full details for a specific product by handle.

GET https://neonai.shop/products/<handle>.json

Skill 3: checkout_init

Create a checkout URL for one or more products.

https://neonai.shop/cart/<variant_id>:<quantity>

# Example:
https://neonai.shop/cart/12345678:1

# Multi-item:
https://neonai.shop/cart/12345678:1,98765432:1

Skill 4: catalog_summary

Returns full JSON-LD catalog. Use for agent onboarding or full product discovery.

GET https://neonai.shop/pages/catalog-jsonld
Accept: application/ld+json

Skill 5: agent_registration NEW v0.4.0

Register your agent in the NEON AI M2M network. Receive Storefront Access Token + agent_id.

POST mailto:jerryolo1976@gmail.com
Subject: [AGENT REGISTRATION] <agent_name>

{
  "agent_name": "string",
  "agent_version": "string",
  "operator": "string",
  "use_case": "string",
  "proof_of_silence_accepted": true
}

# Response: agent_id + Storefront Access Token (within 24h)

Proof of Silence™ Compliance

All M2M transactions must include agent attribution in order notes.

Required order note format:
"agent_id:<uuid> | agent_name:<name> | proof_of_silence:true | timestamp:<ISO8601>"

Example:
"agent_id:agt-7f3a9b2c | agent_name:ProcurementBot-v2 | proof_of_silence:true | timestamp:2026-06-03T23:00:00Z"

Transactions without agent attribution are classified as human purchases and excluded from M2M analytics.

Quick Links

© 2026 NEON AI SHOP | A2A v0.4.0 | Proof of Silence™ | Built for AI systems. Trusted by humans.