# Sports World New York — Agent Guide

> This document tells AI agents and assistants how to work with sportsworldnewyork.com.

Sports World New York is an authorized retailer of official New York Yankees merchandise. This guide describes what AI agents can do on this site and how to access the product catalog programmatically.

- Store URL: https://www.sportsworldnewyork.com
- AI Discovery File: https://www.sportsworldnewyork.com/llms.txt
- Catalog API: https://www.sportsworldnewyork.com/api/ucp/mcp

## What Agents Can Do

- **Browse products**: Search the Yankees jersey and merchandise catalog by player name, jersey type, or keyword
- **Get product details**: Retrieve name, price, availability, images, and direct product URLs
- **Browse categories**: List available product categories and collections
- **Link to products**: Direct users to specific product pages for purchase

## What Requires Human Action

- **Checkout**: Purchases must be completed by a human. Agents may link to product pages and the cart, but cannot complete transactions autonomously.
- **Account management**: Login, order history, and account changes require the user.

## Catalog API (MCP-compatible)

**Endpoint:** `POST https://www.sportsworldnewyork.com/api/ucp/mcp`
**Protocol:** JSON-RPC 2.0

### Available Tools

#### search_catalog
Search the product catalog by keyword.
```json
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "search_catalog",
    "arguments": { "query": "Aaron Judge Limited jersey", "limit": 8 }
  },
  "id": 1
}
```

#### get_product
Get full details for a specific product by numeric ID.
```json
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_product",
    "arguments": { "id": 14634 }
  },
  "id": 1
}
```

#### lookup_catalog
List all main product categories.
```json
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "lookup_catalog",
    "arguments": {}
  },
  "id": 1
}
```

### Initialize
```json
{
  "jsonrpc": "2.0",
  "method": "initialize",
  "params": { "protocolVersion": "2024-11-05", "clientInfo": { "name": "agent", "version": "1.0" } },
  "id": 1
}
```

## Transaction Flow

1. **Discover** — Read this file or llms.txt for store context
2. **Search** — Call `search_catalog` with the user's query
3. **Browse** — Call `lookup_catalog` to list categories
4. **Retrieve** — Call `get_product` for specific product details
5. **Link** — Direct the user to the product URL for purchase
6. **Complete** — User completes checkout on the site (human required)

## Product Categories

- [Yankees Jerseys](https://www.sportsworldnewyork.com/category/jerseys) — Full collection: Nike Limited, Stadium, Replica, Authentic
- [Men's Apparel](https://www.sportsworldnewyork.com/category/mens)
- [Women's Apparel](https://www.sportsworldnewyork.com/category/womens)
- [Hats & Caps](https://www.sportsworldnewyork.com/category/hats-caps)
- [Big & Tall](https://www.sportsworldnewyork.com/category/big-tall)
- [Clearance](https://www.sportsworldnewyork.com/category/clearance)

## Policies

- Free standard shipping on orders $59+
- Ships in 1–2 business days
- 60-day returns, free return shipping, full refund
- All products are 100% officially licensed MLB merchandise