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	Crystal slug or display name, e.g. 'amethyst', 'blue-sapphire', 'Cat's Eye Chrysoberyl'.
response_format	enum: markdown, json	no	Output format: 'markdown' (default) for a readable report, or 'json' for the raw structured payload.

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.