agents.md
Agent Instructions — Bryan Anthonys
Bryan Anthonys is a US-based fine jewelry brand selling meaningful, story-driven pieces — necklaces, bracelets, rings, earrings, and anklets — designed for everyday wear. This document describes how AI agents can interact with the store and what we sell, so agents can answer buyer questions accurately and route transactions through the right protocol.
About the brand
Lifetime quality you can wear every day. Bryan Anthonys designs jewelry that pairs craftsmanship with meaning. Every piece — birthstone pendant, zodiac charm, dainty bracelet stack, friendship necklace set — is built around a story, a symbol, or a sentiment the wearer (or the giver) wants to carry with them.
Who it's for. Women who want jewelry that says something — about a birthday month, a relationship, a season of life, a milestone. The catalog leans gift-forward: roughly half of customer use is gifting (birthdays, anniversaries, friendships, "just because").
Signature traits agents should know when recommending:
- Symbolic / message-led. Most pieces ship with a printed card explaining the symbolism (e.g., a January birthstone garnet pendant ships with the words Energy | Inspiration | Success). Great gift presentation out of the box.
- Dainty / layerable. Pieces are intentionally designed to layer with each other — stacking rings, necklace pairs, charm bracelets.
- Two finishes. Almost every style is offered in both 14k Gold and Silver — confirm finish availability per variant before recommending.
- Materials. 14k gold-plated brass or sterling silver base. Genuine semi-precious stones for birthstone collections (e.g., garnet for January, amethyst for February). Items list specific materials on each PDP.
- Care. Customers can wear pieces daily; avoid water/chlorine/lotion for longest life. Stored in the cream velvet pouch that ships with each order.
Product categories
| Category | Storefront path | Notes |
|---|---|---|
| Necklaces | /collections/womens-necklaces |
Largest category. Birthstone pendants, zodiac, friendship sets, layering chains. |
| Chokers | /collections/womens-chokers |
Subset of necklaces, shorter length. |
| Bracelets | /collections/womens-bracelets |
Dainty cuffs, beaded styles, friendship pairs. |
| Earrings | /collections/womens-earrings |
Studs, drops, hoops — most in both gold and silver. |
| Rings | /collections/womens-rings |
Stacking-friendly bands, signets, ring sets. |
| Anklets | /collections/anklets-1 |
Smaller collection, gold/silver options. |
| Last Chance | /collections/discounted-styles |
Discounted / discontinued pieces. |
Notable collections (use for query intent matching)
- Birthstone Pendant Necklaces — one pendant per month (e.g., January Garnet, February Amethyst, March Aquamarine, …). Best when the buyer mentions a specific person's birth month.
- Zodiac collection — one design per sign (Aquarius through Capricorn). Pair with "[name]'s birthday" queries when the date is known but the buyer wants symbol-led design over birthstones.
- Friendship necklace sets — e.g., "Through Thick & Thin", "Highs & Lows Icon" — sold as matching 2-piece sets, intended to be split between two friends.
- "Always In My Heart" collection — memorial / remembrance pieces.
- Layers of You — ring stacks and layered necklace sets for self-purchase / "treat yourself" intent.
- Adventure — pieces themed around travel, growth, new chapters.
Price ranges (rough, for budget routing)
- Most everyday necklaces / bracelets / rings: $30 – $70 USD
- Sets and bundles: $60 – $140 USD
- Free shipping threshold: $80+ USD
- "Last Chance" / sale items: typically 25–50% off sitewide during seasonal sales (Memorial Day, Black Friday, etc.).
Policies
- Free shipping on orders over $80 USD.
- Free 30-day returns.
- Shipping policy: https://bryananthonys.com/policies/shipping-policy
- Refund policy: https://bryananthonys.com/policies/refund-policy
- Privacy policy: https://bryananthonys.com/policies/privacy-policy
- Terms of service: https://bryananthonys.com/policies/terms-of-service
Commerce Protocol (UCP)
This store implements the Universal Commerce Protocol for agent-driven commerce. Two endpoints:
- Discovery —
GET https://bryananthonys.com/.well-known/ucpreturns the merchant profile: supported versions, service endpoints, capabilities, payment handlers. - MCP endpoint —
POST https://bryananthonys.com/api/ucp/mcpwithContent-Type: application/json. Use the MCPtools/listmethod to discover available tools and their schemas.