> ## Documentation Index
> Fetch the complete documentation index at: https://betterdatainc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Hosted Gateway & Registry - Getting Started

> Quick start guide for using Better Data hosted AI Gateway and Commerce Registry

# Hosted Gateway & Registry - Getting Started

Get started with Better Data's hosted AI Gateway and Commerce Registry in minutes.

<Note>
  **Hosted Endpoints**:

  * Gateway: `https://gateway.betterdata.co`
  * Registry: `https://registry.betterdata.co`
</Note>

## Prerequisites

* A Better Data account (sign up at [app.betterdata.co](https://app.betterdata.co))
* A commerce platform (Shopify, BigCommerce, WooCommerce, or custom)
* API credentials for your commerce platform

## Step 1: Create Gateway Connection

1. Log in to [app.betterdata.co](https://app.betterdata.co)
2. Navigate to **Integrations** → **AI Gateway**
3. Click **Create Gateway**
4. Select your commerce platform:
   * Shopify
   * BigCommerce
   * WooCommerce
   * Custom (REST API)

## Step 2: Configure Connector

### Shopify

```typescript theme={null}
{
  "platform": "shopify",
  "storeUrl": "your-store.myshopify.com",
  "storefrontAccessToken": "your-storefront-token",
  "apiVersion": "2024-01"
}
```

### BigCommerce

```typescript theme={null}
{
  "platform": "bigcommerce",
  "storeHash": "your-store-hash",
  "accessToken": "your-access-token"
}
```

### WooCommerce

```typescript theme={null}
{
  "platform": "woocommerce",
  "storeUrl": "https://yourstore.com",
  "consumerKey": "your-consumer-key",
  "consumerSecret": "your-consumer-secret"
}
```

## Step 3: Register in Commerce Registry

Once your gateway is configured, register it in the Commerce Registry to enable `@shop` discovery:

```bash theme={null}
curl -X POST https://registry.betterdata.co/api/gateways \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brand_name": "Your Brand",
    "domain": "yourstore.com",
    "endpoint": "https://gateway.betterdata.co/v1/your-gateway-id",
    "verified": true
  }'
```

**Response:**

```json theme={null}
{
  "id": "gw_123",
  "brand_name": "Your Brand",
  "domain": "yourstore.com",
  "endpoint": "https://gateway.betterdata.co/v1/your-gateway-id",
  "verified": true,
  "created_at": "2024-01-15T10:00:00Z"
}
```

## Step 4: Test Your Gateway

### Test with Claude (MCP)

```bash theme={null}
curl -X POST https://gateway.betterdata.co/v1/your-gateway-id/tools \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "claude",
    "session_id": "test-session-123"
  }'
```

### Test with OpenAI (Functions)

```bash theme={null}
curl -X POST https://gateway.betterdata.co/v1/your-gateway-id/tools \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "openai",
    "session_id": "test-session-123"
  }'
```

## Step 5: Enable @shop Discovery

Once registered, users can discover your products via:

* `@shop Your Brand` - Browse your catalog
* `@shop Your Brand product name` - Search your products
* `@shop 012345678901` - Lookup by GTIN/UPC

## Next Steps

* [Registry Management](/reference/reference/ai-registry/registry/management)
* [Gateway Configuration](/hosted/ai-registry/configuration)
* [Analytics & Monitoring](/hosted/ai-registry/analytics)
* [API Reference](/reference/reference/ai-registry/api-reference)

***

## Support

Need help? Contact us at [support@betterdata.co](mailto:support@betterdata.co) or visit our [documentation](/ai-registry).