# BFF Robots — Agent Integration Manual

This document describes how AI agents can browse, search, and facilitate purchases at BFF Robots (https://www.bffrobots.com).

## Overview

BFF Robots is a custom humanoid robot manufacturer. Customers choose a robot design from our marketplace or create their own via AI image-to-3D generation. We manufacture and ship real, walking, talking robots.

**Important:** All purchases require explicit human buyer approval at checkout. Agents MUST NOT complete payment without confirmed buyer consent.

## Typical Agent Flow

1. **Discover** — `GET /.well-known/ucp` to confirm capabilities and supported tools
2. **Search** — Use `search_catalog` MCP tool to find robots matching buyer intent
3. **Inspect** — Use `get_product` to retrieve full details, images, and pricing
4. **Checkout** — Use `create_checkout` to generate a Stripe checkout URL
5. **Handoff** — Present the checkout URL to the human buyer for payment approval
6. **Complete** — Buyer completes payment on Stripe; agent receives confirmation

## MCP Endpoint

```
POST https://www.bffrobots.com/api/ucp/mcp
Content-Type: application/json
```

JSON-RPC 2.0 format. No authentication required for catalog browsing. Checkout creation requires a valid user session token in the `X-Session-Token` header.

## Available MCP Tools

### search_catalog
Search marketplace robots by natural language query.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_catalog",
    "arguments": {
      "query": "blue security robot under $3000",
      "robot_type": "mini",
      "max_price": 3000,
      "limit": 10
    }
  }
}
```

### get_product
Get full product details for a specific robot model.

```json
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "get_product",
    "arguments": {
      "model_id": 690005
    }
  }
}
```

### create_checkout
Create a Stripe checkout session for a robot purchase.

```json
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "create_checkout",
    "arguments": {
      "model_id": 690005,
      "robot_type": "humanoid",
      "customer_email": "buyer@example.com",
      "success_url": "https://example.com/success",
      "cancel_url": "https://example.com/cancel"
    }
  }
}
```

### get_store_info
Get store policies, shipping information, and contact details.

```json
{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "get_store_info",
    "arguments": {}
  }
}
```

### list_tools
Discover all available tools.

```json
{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/list",
  "params": {}
}
```

## Product Pricing

| Robot Type | Price | Height | DOF | Key Features |
|---|---|---|---|---|
| Mini | $2,509.99 | 60cm | 18 | AI speech, companion, home use |
| Humanoid | $15,009.99 | 130cm | 21 | Full walking, AI learning, business use |
| Android | $20,009.99 | 160cm | 24 | Ultra-realistic, advanced AI, premium |

All prices in USD. Shipping: $150 flat rate. Lead time: 30–60 days.

## Read-Only Browsing Endpoints

These endpoints require no authentication and return JSON:

- All marketplace listings: `GET /api/trpc/marketplace.getListings`
- Single product: `GET /api/trpc/marketplace.getListing?input={"id":MODEL_ID}`
- Search: `GET /api/trpc/marketplace.getListings?input={"searchQuery":"QUERY"}`

## Rules for Agents

1. **Human approval required** — Never complete a payment without explicit buyer confirmation
2. **Rate limits** — Back off on HTTP 429 responses; retry after 60 seconds
3. **Currency** — All prices are in USD
4. **Availability** — Check `is_listed` field; unlisted products cannot be purchased
5. **Custom models** — Buyers can also create custom robots at https://www.bffrobots.com/create

## Store Metadata

- Main site: https://www.bffrobots.com
- Marketplace: https://www.bffrobots.com/marketplace
- Sitemap: https://www.bffrobots.com/sitemap.xml
- Agentic sitemap: https://www.bffrobots.com/sitemap_agentic_discovery.xml
- llms.txt: https://www.bffrobots.com/llms.txt
- llms-full.txt: https://www.bffrobots.com/llms-full.txt
- OpenAPI spec: https://www.bffrobots.com/api/openapi.json