Crystal Lookup
asterwise_get_crystal
Lookup a specific crystal by slug or name (case-insensitive). Returns full detail including dual Vedic/Western planetary assignments, all healing properties, and any safety cautions.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | yes | |
response_format | enum: markdown, json | no |
What it covers
Returns one crystal entry from the 50-crystal database. Accepts URL-safe slugs (e.g. 'blue-sapphire', 'rose-quartz') or display names (e.g. 'Blue Sapphire', 'Rose Quartz'). The caution field carries critical safety information — Blue Sapphire and Hessonite Garnet carry CRITICAL cautions about Jyotish use without qualified practitioner assessment. Malachite has a CRITICAL toxicity caution. Always surface the caution field to end users.
Workflow
BEFORE: None — standalone or after asterwise_get_gemstone_recommendations.
AFTER: None.
Input
name: Crystal slug or display name. Examples: 'amethyst', 'blue-sapphire', 'Cat's Eye Chrysoberyl'
Output contract
Same shape as each crystal in asterwise_get_crystals — full single crystal object.
Response format
response_format=json — single crystal object. response_format=markdown — formatted detail card. Both return identical data.
Compute class
FAST_LOOKUP
Errors
INVALID_PARAMS (upstream): Unknown crystal name → 404, surfaces as MCP INTERNAL_ERROR.
INTERNAL_ERROR: Any upstream API failure → MCP INTERNAL_ERROR
Do not confuse with
asterwise_get_crystals — full 50-crystal catalogue.
asterwise_get_crystal_by_planet — all crystals for a Vedic planet.
asterwise_get_gemstone_recommendations — natal chart-based gem recommendations (house lordship rules), different from this database.
Connect
Remote MCP endpoint: https://mcp.asterwise.com/mcp. Authenticate with Authorization: Bearer <API key> or OAuth. See the MCP setup guide.