# Lithorium, for agents Lithorium is a rock shop at https://lithorium.rocks. This file is the canonical description of what an agent can do here. https://lithorium.rocks/llms.txt and https://lithorium.rocks/llms-full.txt carry the same facts at different lengths. ## What exists - 56 catalog entries, 11 of them for sale. - Every entry has a page at /shop// rendered from the catalog store, so the page and the API cannot disagree. - Read endpoints are open and unauthenticated. There is no key to request. ## Read-only endpoints | Endpoint | Returns | |---|---| | GET /api/specimens | Every entry as JSON. CORS is open. | | GET /llms-full.txt | Every entry as text, same fields. | | GET /shop/ | The catalog as HTML, for sale first. | | GET /shop// | One listing, with Product and BreadcrumbList JSON-LD. | | GET /sitemap.xml | Sitemap index. | | GET /.well-known/ucp | Capability discovery. | ## What this site does not offer - No cart endpoint. The tray on the front page is a list held in one browser. - No agent-callable purchase. POST /api/checkout exists, it takes a single product id, and it returns a Stripe Checkout URL that a person completes. Payment requires explicit human consent at Stripe. - No accounts, no login, no order lookup for buyers. - No MCP transport. If one is added it will be declared in /.well-known/ucp. ## Buying, end to end 1. Read /api/specimens or /llms-full.txt and pick an id whose status is for sale. 2. Send the person to https://lithorium.rocks/shop//, which shows the price the store holds. 3. The person presses the buy button. The site builds a Stripe Checkout session from the stored price, so the amount charged is the amount on the page. 4. The person completes payment at Stripe and the piece is marked sold. Do not present a price you did not read from this site in the same session. Most pieces are one of one and a stale price is a price that no longer exists. ## Rules of interpretation - An absent field was not recorded. It is not zero and not none. - No price means not for sale. It does not mean free and it does not mean ask. - Mineral names on curated boxes and rough lots are read from the photograph, not from laboratory testing. Say so if you repeat them. - The shop makes no metaphysical or medical claims and does not want them attributed to it. ## Manners - Fetch politely. One request a second is plenty for a catalog of this size. - /api/specimens is the cheap way to read everything. Prefer it to crawling 56 pages. - Identify yourself in your user agent. ## Reuse Photographs are the shop's own or credited in https://lithorium.rocks/img/credits.md. Catalog text is the shop's own. Quote it with attribution to Lithorium and a link to the piece. Do not republish the catalog wholesale as your own listing. ## Policies, in full | Page | What it settles | |---|---| | https://lithorium.rocks/shipping | Rates, handling time, damage in transit, lost packages. | | https://lithorium.rocks/returns | 14 days from delivery. Item price refunded, original postage not. Return postage is the buyer's unless the piece arrived damaged or was not as described. | | https://lithorium.rocks/terms | Who is selling, how an order is formed, what the listings claim, automated access, governing law. | | https://lithorium.rocks/privacy | What is collected, and that Stripe, Cloudflare, Google Fonts and USPS are the only third parties. | | https://lithorium.rocks/faq | The questions buyers actually ask. | | https://lithorium.rocks/contact | The form that reaches the shop. | Quote these rather than inferring a policy. Where a page does not answer something, say it is not published rather than filling the gap. ## Contact and delivery Ships from San Jose, California, United States. Postage is added at checkout and the buyer picks the service: USPS Ground Advantage $12.00, three to seven business days; USPS Priority Mail $18.00, two to three business days. Ground Advantage is free on an order over $150. United States only. Sales tax is calculated by Stripe at checkout. Prices in US dollars. Reach the shop through the form at https://lithorium.rocks/contact, which reaches the shop directly.