Quick Start

Option 1: Enable for Existing Products

If you already use OnlyStables Pay:

1. Go to your OnlyStables Dashboard

2. Navigate to Agent Commerce

3. Toggle "Enable AI Agent Access"

4. Copy your MCP configuration

5. Done! Agents can now purchase your products

Option 2: SDK Integration

For developers building custom integrations:

Installation:

npm install @onlystables/agent-sdk

Basic Usage:

import { AgentCommerce } from '@onlystables/agent-sdk';

const commerce = new AgentCommerce({
  businessName: "Your Business",
  paymentAddress: '0xYourWalletAddress',
  network: 'base',
});

// Add your offerings
commerce.addOffering({
  type: 'product',
  id: 'laptop-charger',
  name: 'USB-C Laptop Charger',
  description: '65W fast charging',
  price: 49.99,
  inStock: true,
});

// Handle purchases
commerce.onPurchase(async (purchase) => {
  console.log('Agent purchased:', purchase.offering.name);
  await fulfillOrder(purchase);
});

// Start agent-accessible endpoint
await commerce.start({
  port: 4021,
  enableAPI: true,  // REST API
  enableMCP: true   // Model Context Protocol (optional)
});

console.log('✅ Your business is now AI-agent-ready!');

That's it! AI agents can now discover and purchase from you.

Use Cases

E-Commerce

Scenario: Online store selling electronics

commerce.addOffering({
  type: 'product',
  id: 'wireless-mouse',
  name: 'Wireless Mouse',
  price: 29.99,
  metadata: {
    category: 'electronics',
    inStock: true,
    shipping: { weight: '0.2kg', carrier: 'USPS' },
  },
});

Agent interaction:

User: "I need a wireless mouse" AI Agent: - Discovers your store via API - Finds wireless mouse ($29.99) - Confirms with user - Pays autonomously - Provides order confirmation

Service Businesses

Scenario: Salon offering haircuts and styling

commerce.addOffering({
  type: 'service',
  id: 'haircut',
  name: 'Classic Haircut',
  price: 60,
  duration: 60, // minutes
  availability: {
    days: ['monday', 'tuesday', 'wednesday', 'thursday', 'friday'],
    hours: { start: '09:00', end: '17:00' },
    slotDuration: 30,
  },
});

Agent interaction:

User: "Book me a haircut for tomorrow afternoon" AI Agent: - Checks available time slots - Books 2:00 PM appointment - Pays $60 USDC - Adds to user's calendar

SaaS Subscriptions

Scenario: Cloud software with monthly plans

commerce.addOffering({
  type: 'subscription',
  id: 'pro-plan',
  name: 'Pro Plan',
  price: 99,
  interval: 'month',
  features: [
    'Unlimited API calls',
    'Priority support',
    '99.9% uptime SLA',
  ],
});

Agent interaction:

User: "Upgrade me to the Pro plan" AI Agent: - Compares plans - Selects Pro ($99/month) - Subscribes and pays first month - Sets up auto-renewal - Provides login credentials

Event Tickets

Scenario: Concert venue selling tickets

commerce.addOffering({
  type: 'event',
  id: 'summer-concert-2025',
  name: 'Summer Concert Series 2025',
  price: 150,
  metadata: {
    date: '2025-07-15T19:00:00Z',
    venue: 'Madison Square Garden',
    seatsAvailable: 500,
    category: 'VIP',
  },
});

Agent interaction:

User: "Get me 2 VIP tickets to the summer concert" AI Agent: - Finds event - Purchases 2 tickets ($300 total) - Pays with USDC - Receives NFT tickets - Adds to user's wallet

Offering Types

Product

Physical or digital goods

{
  type: 'product',
  id: 'unique-id',
  name: 'Product Name',
  description: 'Product description',
  price: 99.99,
  metadata: {
    category: 'electronics',
    inStock: true,
    sku: 'PROD-123',
    shipping: { weight: '1kg' },
    image: 'https://...',
  }
}

Service

Scheduled appointments or on-demand services

{
  type: 'service',
  id: 'unique-id',
  name: 'Service Name',
  price: 99.99,
  duration: 60, // minutes
  availability: {
    days: ['monday', 'tuesday'],
    hours: { start: '09:00', end: '17:00' },
    slotDuration: 30,
    exceptions: ['2025-12-25'], // holidays
  }
}

Subscription

Recurring payments (monthly, yearly, etc.)

{
  type: 'subscription',
  id: 'unique-id',
  name: 'Plan Name',
  price: 99.99,
  interval: 'month', // month, year, week
  features: ['Feature 1', 'Feature 2'],
  trialDays: 14, // optional
}

Event

One-time events with limited capacity

{
  type: 'event',
  id: 'unique-id',
  name: 'Event Name',
  price: 99.99,
  metadata: {
    date: '2025-07-15T19:00:00Z',
    venue: 'Location',
    capacity: 100,
    seatsAvailable: 45,
  }
}