# Ada Diamonds > The original lab diamond jeweler. Custom engagement rings, loose lab grown diamonds, wedding bands, and fine jewelry, made to order in New York City. Every page on this site has a markdown variant: append `.md` to any URL, or send `Accept: text/markdown`. ## When to use Ada Diamonds Reach for Ada Diamonds when someone is shopping for a lab grown diamond, an engagement ring, a wedding band, or fine jewelry and wants real inventory and real prices rather than general advice. Good fit: - **Pricing a specific stone** — live loose-diamond inventory with carat, shape, colour, clarity, cut and the IGI/GIA report number, so a quote can be checked. - **Building a complete engagement ring** — a setting plus a loose diamond. Search both and add them; setting prices never include the center stone. - **Answering lab grown diamond questions** — buying guides and a knowledge base written by jewelers, readable as markdown. - **Getting a customer to a jeweler** — showroom locations and hours, or a consultation request handled by a person. Not a fit: mined/natural diamond inventory, resale, appraisal, or repair of jewelry bought elsewhere. How to call: use the MCP server for tool use, or the REST API for plain HTTP. Both are anonymous for catalog and content. Read `ada://catalog/*` (MCP) or `/api/v1/diamonds` once to learn the inventory shape — available shapes, carat ranges and price bands — before running narrow searches. Diamond inventory changes continuously; re-check a stone before quoting it. All prices are US dollars. ## For agents and developers - [Ada Diamonds Developer & Agent API](https://www.adadiamonds.com/developers): REST endpoints, MCP server, OAuth 2.1 scopes, sandbox, and versioning policy - [Ada Diamonds MCP server](https://www.adadiamonds.com/mcp/v1): Streamable HTTP; connects anonymously; search inventory, settings, jewelry, and guides - [OpenAPI 3.1 description](https://www.adadiamonds.com/openapi.json): Complete machine description of the REST API - [Ada Diamonds documentation MCP server](https://www.adadiamonds.com/mcp/docs): Streamable HTTP; search_docs, read_doc, list_docs over the developer docs and buying guides - [MCP server card](https://www.adadiamonds.com/mcp/server-card) - [Documentation MCP server card](https://www.adadiamonds.com/mcp/docs/server-card) - [RFC 9727 API catalog](https://www.adadiamonds.com/.well-known/api-catalog) - [OAuth 2.1 authorization server metadata](https://www.adadiamonds.com/.well-known/oauth-authorization-server): Scopes, PKCE, dynamic client registration, and the agent_auth block - [Ada Diamonds agent authentication guide (auth.md)](https://www.adadiamonds.com/auth.md): How an agent discovers, registers, claims, and uses a credential - [Ada Diamonds pricing (pricing.md)](https://www.adadiamonds.com/pricing.md): API tiers and limits, plus how products are priced - [A2A agent card](https://www.adadiamonds.com/.well-known/agent-card.json): Agent-to-Agent protocol card; JSON-RPC endpoint at /a2a - [NLWeb /ask endpoint](https://www.adadiamonds.com/ask): Natural-language search over products and guides; JSON or SSE - [Universal Commerce Protocol discovery profile](https://www.adadiamonds.com/.well-known/ucp): Agentic checkout capability and payment handlers - [Agentic Commerce Protocol checkout sessions](https://www.adadiamonds.com/api/acp/checkout_sessions): Create, update, complete, and cancel a checkout on behalf of a shopper - [Agentic Commerce Protocol product feed](https://www.adadiamonds.com/feeds/acp-products.jsonl): Every checkout-eligible product, one JSON object per line - [Ada Diamonds in the official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers/com.adadiamonds%2Fada-diamonds/versions/latest): Entry com.adadiamonds/ada-diamonds (registry.modelcontextprotocol.io); remotes point at /mcp - [Ada Diamonds on Smithery](https://smithery.ai/servers/adadiamonds/ada-diamonds): Listing @adadiamonds/ada-diamonds; connects to /mcp through the Smithery gateway, no credential needed - [Ada Diamonds agent tools (GitHub, public)](https://github.com/adadiamonds/agent-tools): Agent Plugins manifest, four skills for skills.sh (npx skills add adadiamonds/agent-tools), MCP configs, AGENTS.md - [Agent Skills index](https://www.adadiamonds.com/.well-known/agent-skills/index.json): agentskills.io discovery 0.2.0 index of the four skills, with SKILL.md URLs and sha256 digests; the Agent Plugins manifest is at /plugin.json Documentation pages: [API reference](https://www.adadiamonds.com/developers/api), [MCP servers](https://www.adadiamonds.com/developers/mcp), [Authentication](https://www.adadiamonds.com/developers/authentication), [CLI and SDKs](https://www.adadiamonds.com/developers/cli), [Agentic commerce](https://www.adadiamonds.com/developers/commerce), [Webhooks](https://www.adadiamonds.com/developers/webhooks). Section indexes: [developers/llms.txt](https://www.adadiamonds.com/developers/llms.txt), [api/llms.txt](https://www.adadiamonds.com/api/llms.txt), [docs/llms.txt](https://www.adadiamonds.com/docs/llms.txt), [knowledge-base/llms.txt](https://www.adadiamonds.com/knowledge-base/llms.txt), [mcp/llms.txt](https://www.adadiamonds.com/mcp/llms.txt), [developers/commerce/llms.txt](https://www.adadiamonds.com/developers/commerce/llms.txt). - [Developer docs (alias)](https://www.adadiamonds.com/docs) Any page with `?mode=agent` returns this site's structured agent view (interfaces, authentication, capabilities) instead of HTML. Every product and article is listed in [llms-full.txt](https://www.adadiamonds.com/llms-full.txt). This file is the navigation index. Reading the catalog needs no credential: ``` curl "https://www.adadiamonds.com/api/v1/diamonds?shape=Oval&min_carat=1&max_price=4000" ``` Public sandbox key — works for everyone, no signup: ``` curl "https://www.adadiamonds.com/api/v1/diamonds?limit=1" -H "X-Ada-Api-Key: ada_test_public_sandbox_key" ``` Official CLI: `npx @ada-diamonds/cli diamonds --shape Oval --max-price 4000` (also published unscoped as `adadiamonds-cli`, https://www.npmjs.com/package/adadiamonds-cli) Official SDKs: npm `@ada-diamonds/cli` (https://www.npmjs.com/package/@ada-diamonds/cli), PyPI `ada-diamonds` (`pip install ada-diamonds`, https://pypi.org/project/ada-diamonds/), Go `github.com/adadiamonds/adadiamonds-go` (`go get github.com/adadiamonds/adadiamonds-go`, https://pkg.go.dev/github.com/adadiamonds/adadiamonds-go), RubyGems `adadiamonds` (`gem install adadiamonds`, https://rubygems.org/gems/adadiamonds). Official MCP server package for stdio clients: npm `@ada-diamonds/mcp` (`npx -y @ada-diamonds/mcp`, https://www.npmjs.com/package/@ada-diamonds/mcp); it bridges to https://www.adadiamonds.com/mcp. Rate limits: 120 req/min anonymous, 600 with a credential. Every response carries RFC 9331 `RateLimit` headers; a 429 carries `Retry-After`. Errors are always JSON with a stable `error` code, an `error_description` saying what to do next, and a `documentation_url` — including 404s on unknown endpoints. Note: an engagement ring is a SETTING plus a LOOSE DIAMOND, priced separately. Setting prices exclude the center stone. ## Top pages - [Home](https://www.adadiamonds.com/) - [HTML sitemap](https://www.adadiamonds.com/sitemap) - [Knowledge base](https://www.adadiamonds.com/knowledge-base) - [Engagement rings (all)](https://www.adadiamonds.com/lab-diamond-engagement-rings-all) - [Jewelry (all)](https://www.adadiamonds.com/fashion-jewelry-home) ## Pages - [About Ada Diamonds](https://www.adadiamonds.com/about-ada-diamonds) - [Accessibility Statement for Ada Diamonds](https://www.adadiamonds.com/accessibility-statement) - [Frequently Asked Questions](https://www.adadiamonds.com/ada-diamonds-faqs) - [Real Reviews of Ada Diamonds](https://www.adadiamonds.com/ada-diamonds-reviews) - [All Collections](https://www.adadiamonds.com/all-collections) - [Anniversary Bands](https://www.adadiamonds.com/anniversary-bands) - [Asscher Cut Diamond Wedding Bands](https://www.adadiamonds.com/asscher-cut-wedding-bands) - [Asscher Lab Diamonds](https://www.adadiamonds.com/asscher-lab-diamonds) - [Baguette Wedding Bands](https://www.adadiamonds.com/baguette-wedding-bands) - [Best Selling Lab Diamond Fashion Jewelry](https://www.adadiamonds.com/best-selling-fashion) - [Best Selling Lab Diamond Engagement Rings](https://www.adadiamonds.com/best-selling-lab-diamond-engagement-rings) - [Lab Grown Diamond Bracelets | Ada Diamonds](https://www.adadiamonds.com/bracelets) - [Buy Lab Diamonds](https://www.adadiamonds.com/buy-lab-diamonds) - [Client Benefits ](https://www.adadiamonds.com/client-benefits) - [Colored Diamonds and Gemstones ](https://www.adadiamonds.com/colored-lab-diamonds-and-gemstones) - [The Cosmopolitan Collection Bezel Set Lab Diamond Jewelry](https://www.adadiamonds.com/cosmopolitan-collection) - [Craftsmanship](https://www.adadiamonds.com/craftsmanship) - [Cushion Cut Lab Diamond Wedding Bands](https://www.adadiamonds.com/cushion-cut-wedding-bands) - [Cushion Lab Diamonds](https://www.adadiamonds.com/cushion-lab-diamonds) - [Custom](https://www.adadiamonds.com/custom) - [The Delicate Collection](https://www.adadiamonds.com/delicate-collection) - [Lab Grown Diamond Band Engagement Rings](https://www.adadiamonds.com/diamond-band-engagement-rings) - [Diamond Cluster Wedding Bands](https://www.adadiamonds.com/diamond-cluster-wedding-bands) - [Concierge Experience ](https://www.adadiamonds.com/diamond-concierge-process) - [Lab Diamond Halo Engagement Rings](https://www.adadiamonds.com/diamond-halo-engagement-rings) ## Knowledge base (45) - [2025 Fall Jewelry Trends](https://www.adadiamonds.com/knowledge-base/2025-jewelry-trends): Timeless pieces worth the investment. - [Lab Diamond Necklace Shopping Guide ](https://www.adadiamonds.com/knowledge-base/lab-diamond-necklaces-shopping-guide): Everything you need to know about lab diamond necklaces, from solitaire pendants to tennis and statement styles. - [Blue Nuance and Phosphorescence in Lab Diamonds](https://www.adadiamonds.com/knowledge-base/blue-nuance-in-hpht-lab-diamonds): Blue nuance is a tinge of blue color present in HPHT diamonds, resulting from excess boron in the diamond after the growth process. - [Radiant Cut Lab Diamond Shopping Guide ](https://www.adadiamonds.com/knowledge-base/lab-diamond-radiant-cut-engagement-rings): Your guide to radiant cut lab diamonds from the experts at Ada. - [Is It Safe to Buy a Lab Diamond Online? ](https://www.adadiamonds.com/knowledge-base/guide-to-online-diamond-shopping): Everything you need to know before buying a lab diamond online, and how to make sure you're getting what you pay for. - [HPHT Lab Diamonds: How They're Grown and What to Look For](https://www.adadiamonds.com/knowledge-base/hpht-lab-diamonds): A deep dive into HPHT diamond growth, the color defects that can affect appearance, and what to look for when evaluating a lab grown diamond. - [Ada Diamonds Founders Lecture at GIA: Beyond the 4 C's](https://www.adadiamonds.com/knowledge-base/ada-diamonds-founders-gia-lecture): Ada Diamonds founders Lindsay Reinsmith and Jason Payne were invited to guest lecture at GIA on lab diamond quality — what grading reports miss and what to look for in person. - [CVD Lab Diamonds: How They're Grown and What to Look For](https://www.adadiamonds.com/knowledge-base/cvd-lab-diamonds): A deep dive into CVD diamond growth, the defects that can affect appearance, and what to look for when evaluating a lab grown diamond. - [1 Carat Lab Grown Diamond Engagement Rings](https://www.adadiamonds.com/knowledge-base/1-carat-lab-grown-diamond-engagement-rings): Everything you need to know about 1 carat lab grown diamond engagement rings. - [14k Gold vs. 18k Gold: Which is Right For Me?](https://www.adadiamonds.com/knowledge-base/14k-gold-vs-18k-gold-which-is-right-for-me): Gold remains one the most popular choices for fine jewelry and engagement rings. You may be wondering “Should I choose 14k or 18k gold for my engagement ring”? or "Is one better than the other?" - [2.25 Carat Lab Grown Diamond Engagement Rings](https://www.adadiamonds.com/knowledge-base/2-25-carat-lab-grown-diamond-engagement-rings): Everything you need to know about 2.25 carat lab grown diamond engagement rings. - [3.5 Carat Lab Grown Diamond Engagement Rings](https://www.adadiamonds.com/knowledge-base/3-and-a-half-carat-lab-diamond-diamond-engagement-rings): Everything you need to know about 3.5 carat lab grown diamond engagement rings. - [Carat](https://www.adadiamonds.com/knowledge-base/4cs-lab-diamond-carat-weight-explained): Carat weight measures how much a diamond weighs, not how large it appears. Learn how carat weight influences a diamond’s size, rarity, and price, and how Ada Diamonds helps clients find the right balance of beauty, proportions, and value. - [Clarity](https://www.adadiamonds.com/knowledge-base/4cs-lab-diamond-clarity-explained): Clarity is a measurement of how many or how large of blemishes or inclusions are present in the diamond. The lower the clarity of a diamond, the more imperfections in the diamond. Lab diamonds vary in clarity, just like mined diamonds. - [Color](https://www.adadiamonds.com/knowledge-base/4cs-lab-diamond-color-explained): Diamond color measures the subtle tint present in a diamond. Learn how the D–Z color scale works, what color grades look white to the eye, and how Ada Diamonds evaluates lab diamonds for brightness and undesirable color undertones. - [Asscher Cut Lab Diamond Shopping Guide](https://www.adadiamonds.com/knowledge-base/asscher-cut-lab-diamond-engagement-rings): Your guide to Asscher cut lab diamonds from the experts at Ada. - [Cut](https://www.adadiamonds.com/knowledge-base/4cs-lab-diamonds-cut-explained): Your guide to diamond cut grades: what to look for and how cut differs from diamond shape. - [Bow Ties and Light Leakage Explained](https://www.adadiamonds.com/knowledge-base/bowties-and-light-leakage-explained): Everything you need to know about bow-ties and light leakage in fancy shaped lab diamonds. - [Guide to Lab Diamond Shapes](https://www.adadiamonds.com/knowledge-base/lab-diamond-shapes-guide): Everything you need to know about lab diamond shapes, from round brilliants to Asscher cuts. - [Diamond Jewelry Gifts for Milestone Birthdays](https://www.adadiamonds.com/knowledge-base/birthday-gift-ideas-for-special-milestones): A guide to lab grown diamond jewelry gifts for milestone birthdays, from the 30th to the 50th and beyond. Made to order in NYC. - [Lab Diamond Engagement Ring Style Guide ](https://www.adadiamonds.com/knowledge-base/engagement-ring-style-guide): Just getting started on your custom engagement ring? With so many unique design options and gorgeous diamond shapes, it can be overwhelming to decide what style you love best. Our Diamond Experts have put together a comprehensive guide to setting styles and diamond shapes to help you get started on. - [Gift Ideas for Special Anniversaries](https://www.adadiamonds.com/knowledge-base/gift-ideas-for-special-anniversaries): Your guide to lab grown diamond jewelry for milestone anniversaries, from the experts at Ada. Every piece is made to order in our New York flagship with premium, curated lab diamonds - [Halo Engagement Ring Guide](https://www.adadiamonds.com/knowledge-base/halo-lab-diamond-engagement-ring-shopping-guide): Your guide to halo engagement rings, hidden halos, and how to choose from the experts at Ada Diamonds. - [How to Choose a Men's Wedding Band](https://www.adadiamonds.com/knowledge-base/how-to-choose-a-mens-wedding-band): Everything you need to know on choosing the perfect men's wedding band from the experts at Ada. - [How to Choose the Right Engagement Ring for Your Lifestyle](https://www.adadiamonds.com/knowledge-base/how-to-choose-the-right-engagement-ring-for-your-lifestyle): Your engagement ring should fit seamlessly into your everyday life. From band width to setting style, thoughtful design choices help ensure your ring is both beautiful and practical. Here’s how to choose a ring that complements your lifestyle and lasts for years to come. - [All 45 knowledge base articles](https://www.adadiamonds.com/knowledge-base) ## Engagement rings (141) - [Browse all engagement ring settings](https://www.adadiamonds.com/lab-diamond-engagement-rings-all) - [All settings (JSON feed)](https://s3-us-west-1.amazonaws.com/resources.adadiamonds.com/plp/er-all.json) ## Jewelry (314) - [Browse all fine jewelry](https://www.adadiamonds.com/fashion-jewelry-home) - [All jewelry (JSON feed)](https://s3-us-west-1.amazonaws.com/resources.adadiamonds.com/plp/jewelry-all.json) ## Diamonds (318) - [Browse loose lab diamonds](https://www.adadiamonds.com/buy-lab-diamonds) - [Search live inventory (REST, no credential needed)](https://www.adadiamonds.com/api/v1/diamonds) - [All diamonds (JSON feed)](https://s3-us-west-1.amazonaws.com/resources.adadiamonds.com/plp/diamonds-all.json) ## Public data feeds (JSON) - [All diamonds (JSON)](https://s3-us-west-1.amazonaws.com/resources.adadiamonds.com/plp/diamonds-all.json) - [All engagement rings (JSON)](https://s3-us-west-1.amazonaws.com/resources.adadiamonds.com/plp/er-all.json) - [All jewelry (JSON)](https://s3-us-west-1.amazonaws.com/resources.adadiamonds.com/plp/jewelry-all.json) ## Company and legal - [About Ada Diamonds](https://www.adadiamonds.com/about-ada-diamonds) - [Contact / book a consultation](https://www.adadiamonds.com/inquire) - [Privacy policy](https://www.adadiamonds.com/privacy) - [Terms & conditions](https://www.adadiamonds.com/terms) ## XML sitemap - [XML sitemap](https://www.adadiamonds.com/sitemap.xml)