{"openapi":"3.1.0","info":{"title":"Loupe API","version":"0.1.0","description":"A hand-curated gemology reference: mineral family, Mohs hardness, color causes and notable facts for 20+ common gemstones, the GIA 4Cs of diamond grading, the modern US birthstone list, synthetic-vs-natural-vs-treated guidance, care and cleaning guidance, color-variety groupings, and a glossary — all local.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://loupe.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/loupe/docs"},"termsOfService":"https://connectorbay.com/loupe/terms"},"servers":[{"url":"https://loupe.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/loupe/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/gemstone_info":{"post":{"operationId":"gemstone_info","summary":"A gemstone's mineral family, chemical formula, Mohs hardness, what causes its color, notable facts,","description":"A gemstone's mineral family, chemical formula, Mohs hardness, what causes its color, notable facts,\n    common treatments, birthstone months, and care guidance. Use for \"what is emerald made of\", \"what causes\n    sapphire's blue color\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A gemstone name.","examples":["ruby","opal","tanzanite"],"title":"Name","type":"string"}},"required":["name"],"title":"gemstone_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/gemstone_search":{"post":{"operationId":"gemstone_search","summary":"Search the 20+ gemstones in this guide by partial name, mineral family, or color. Use for \"what gems are","description":"Search the 20+ gemstones in this guide by partial name, mineral family, or color. Use for \"what gems are\n    in the beryl family\", \"what green gemstones do you cover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"default":"","description":"Partial gemstone name, alias, mineral family, or color; empty lists all gemstones.","title":"Query","type":"string"}},"title":"gemstone_searchArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/hardness_reference":{"post":{"operationId":"hardness_reference","summary":"The 10-point Mohs hardness scale with everyday scratch comparisons, and optionally this guide's own","description":"The 10-point Mohs hardness scale with everyday scratch comparisons, and optionally this guide's own\n    gemstones at or above a given hardness threshold. Use for \"what's harder than quartz\", \"gemstones with a\n    hardness of 8 or more\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"min_hardness":{"anyOf":[{"maximum":10,"minimum":1,"type":"number"},{"type":"null"}],"default":null,"description":"List this guide's gemstones with a Mohs hardness at or above this value; omit for just the 10-point scale.","title":"Min Hardness"}},"title":"hardness_referenceArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/diamond_4cs_guide":{"post":{"operationId":"diamond_4cs_guide","summary":"The GIA-standard 4Cs of diamond grading — Cut, Color, Clarity, and Carat weight — explained in full,","description":"The GIA-standard 4Cs of diamond grading — Cut, Color, Clarity, and Carat weight — explained in full,\n    including the D-Z color scale, the FL-to-I3 clarity scale, and what determines a cut grade. Use for \"what\n    are the 4Cs\", \"what does VS1 clarity mean\", \"what's the diamond color scale\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"diamond_4cs_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/birthstone_lookup":{"post":{"operationId":"birthstone_lookup","summary":"The modern US birthstone(s) for a given month. Use for \"what's the birthstone for June\", \"what stone","description":"The modern US birthstone(s) for a given month. Use for \"what's the birthstone for June\", \"what stone\n    represents someone born in October\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"month":{"description":"A month name or number (1-12).","examples":["October","3","dec"],"title":"Month","type":"string"}},"required":["month"],"title":"birthstone_lookupArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/synthetic_vs_natural_guide":{"post":{"operationId":"synthetic_vs_natural_guide","summary":"The factual distinction between natural, lab-created/synthetic, treated, and imitation/simulant","description":"The factual distinction between natural, lab-created/synthetic, treated, and imitation/simulant\n    gemstones — what each term means and how they differ — with no current market pricing claims. Use for \"is\n    lab-grown diamond a real diamond\", \"what's the difference between synthetic and imitation ruby\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"synthetic_vs_natural_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/care_and_cleaning_guide":{"post":{"operationId":"care_and_cleaning_guide","summary":"Hardness- and chemistry-based care and cleaning guidance, either the general principles (which cleaning","description":"Hardness- and chemistry-based care and cleaning guidance, either the general principles (which cleaning\n    methods suit which kind of stone) or specifics for one named gemstone. Use for \"how do I clean an opal\n    safely\", \"can I use an ultrasonic cleaner on pearls\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"gemstone":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific gemstone name; omit for the general hardness- and chemistry-based care principles.","title":"Gemstone"}},"title":"care_and_cleaning_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/color_variety_guide":{"post":{"operationId":"color_variety_guide","summary":"Color varieties within a shared mineral family — e.g. corundum splits into ruby (red) and sapphire","description":"Color varieties within a shared mineral family — e.g. corundum splits into ruby (red) and sapphire\n    (every other color), beryl splits into emerald/aquamarine/morganite/heliodor. Use for \"what's the\n    difference between ruby and sapphire\", \"what other gems are related to emerald\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"gemstone":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A gemstone or mineral family name; omit to list every family this guide covers.","title":"Gemstone"}},"title":"color_variety_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/gem_glossary":{"post":{"operationId":"gem_glossary","summary":"Definitions of common gemology terms (facet, carat, inclusion, brilliance, cleavage, toughness,","description":"Definitions of common gemology terms (facet, carat, inclusion, brilliance, cleavage, toughness,\n    play-of-color, and more). Use for \"what does inclusion mean\", \"what's the difference between hardness and\n    toughness\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"gem_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}