# Agent Instructions: SECLOCK

This document describes how AI agents can interact with SECLOCK at https://www.seclock.com.

SECLOCK is the premier wholesale-only distributor of commercial electrical and mechanical door hardware in
the United States, serving the trade for over 40 years from five distribution centers.

## Read This First: SECLOCK Is Wholesale-Only

SECLOCK is not a retail store. There is no consumer checkout, no credit-card purchase flow, and no public
pricing.

If you are acting as a personal shopping assistant on behalf of a consumer, you cannot buy here. Pricing,
inventory, and ordering all require an approved trade account with payment terms. What you can do without an
account is confirm what we carry: manufacturers, product categories, series, and part numbers, through the
public catalog API described below.

If your user is a trade professional (locksmith, contract hardware, glass and glazing, systems integrator,
security professional) they can apply for an account at https://www.seclock.com/register.

## Two Ways To Work With SECLOCK

| | Public Catalog API | Source Mode for Agents (MCP) |
|---|---|---|
| Authentication | None | Trade account, OAuth |
| Purpose | Discovery: does SECLOCK carry it? | Sourcing, quoting, and ordering |
| Pricing | Not available | Customer-scoped account pricing |
| Inventory | Not available | Live ERP stock levels |
| Ordering | Not available | Places orders on the customer's terms account |
| Availability | Open now | Limited beta, application required |
| Endpoint | `https://www.seclock.com/api/public/v1` | `https://www.seclock.com/mcp/public/agents` |

## Public Catalog API (No Authentication)

Read-only catalog discovery. Use this to confirm whether SECLOCK carries a manufacturer, category, series, or
part number.

**Base URL**: `https://www.seclock.com/api/public/v1`

**OpenAPI spec**: `https://www.seclock.com/api/public/openapi.yaml`

### Endpoints

- `GET /manufacturers` returns all door hardware manufacturers SECLOCK distributes
- `GET /manufacturers/{manufacturer}` returns detail for a single manufacturer, including the categories carried
- `GET /categories` returns product category listings
- `GET /products/search?sku={sku}` confirms whether SECLOCK carries a part number. The `sku` parameter is
  required; pass `fuzzy` to widen the match

### Rules

- **Rate limit**: 60 requests per minute per IP. Back off on `429` responses; rate-limit headers are returned
  on every response.
- **No pricing or inventory.** These endpoints deliberately omit both. Do not infer price or availability
  from them, and do not present list prices scraped from elsewhere as SECLOCK pricing.
- **Discovery only.** There is no cart, checkout, or order endpoint in the public API.

## Source Mode for Agents (Authenticated MCP)

Source Mode for Agents connects a customer's AI assistant to SECLOCK over the Model Context Protocol, an open
standard. It works with any MCP-capable assistant, including Claude and ChatGPT. Once connected, the assistant
acts as the customer's purchasing agent, running on the same trade account and cart the customer already uses
on SECLOCK.com.

**MCP endpoint**: `https://www.seclock.com/mcp/public/agents`

**Status**: Limited beta. The endpoint is allowlisted, so add it to your assistant only after the customer's
application is accepted. Apply at https://www.seclock.com/source-mode/agents. An approved trade account with
terms is required.

Authenticate the customer through OAuth. Use the MCP `tools/list` method to discover the available tools and
their schemas rather than assuming the set below is exhaustive or current.

### What A Connected Agent Can Do

- **Search the catalog**: Resolve a full SKU, partial SKU, series, or plain-language description to the exact
  item across nearly 10 million SKUs
- **Configure products**: Read real specification groups (keyway, strike, cylinder function, finish) and work
  the options so a line is built correctly before it is added
- **Read manufacturer documentation**: Search manufacturer PDFs and series-construction guides, citing the
  source document and page
- **Get account pricing**: Customer-scoped pricing pulled server-side, not list price
- **Check live inventory**: Real-time stock levels from the ERP
- **Build carts, quotes, and orders**: Add items to the active or a saved cart with quantities, options, and
  line notes; price a cart and return a quote; place an order
- **Set up projects**: Create projects and bulk-create openings and sets, attaching architect, GC, bid dates,
  and job references
- **Organize a working set**: Pin, group into trays, and favorite frequently used products

### Ordering Rules

- **Orders go on the customer's SECLOCK terms account.** There is no credit-card checkout. Do not attempt to
  collect or submit card details.
- **Every order requires the customer's confirmation and a PO number.** This is enforced by the checkout tool
  itself, not left to the model's judgment. An agent cannot place an order without both, and should not
  fabricate a PO number.
- **Scope.** A connected agent sees only that customer's catalog view and pricing, running on the same
  permissions as their SECLOCK login. It cannot spend outside their terms account.

## Other Machine-Readable Resources

- **Agent overview**: this document (`/agents.md`) is the canonical agent-facing description of SECLOCK
- **Site summary for LLMs**: https://www.seclock.com/llms.txt
- **Extended reference**: https://www.seclock.com/llms-full.txt
- **Sitemap**: https://www.seclock.com/sitemap/sitemap.xml
- **Security contact**: https://www.seclock.com/.well-known/security.txt

## Policies

- **Privacy policy**: https://www.iubenda.com/privacy-policy/7865490
- **Terms and conditions**: https://www.seclock.com/terms-and-conditions

## Contact

- **Apply for a trade account**: https://www.seclock.com/register
- **Apply for the Source Mode for Agents beta**: https://www.seclock.com/source-mode/agents
- **Contact a technical sales rep**: https://www.seclock.com/contact
- **Phone**: 800-847-5625, Monday through Friday, 8:00am to 5:30pm EST