# Crystal Matcher MCP

> Crystal Matcher connects your AI agent to a catalog of 80+ crystals. Instead of guessing, you tell it your goal—whether that's calming anxiety, promoting love, or balancing a specific chakra. Your agent handles the deep research, instantly recommending stones and detailing their properties based on intent, element, or energetic need.

## Overview
- **Category:** wellness
- **Price:** Free
- **Tags:** crystals, meditation, chakras, healing, metaphysical, wellness

## Description

Finding the right crystal for a spiritual goal used to take hours of cross-referencing books and websites. You're trying to match an internal feeling—like needing focus or dealing with emotional burnout—to the correct stone, but the information is scattered everywhere. This MCP changes that. It gives your AI agent direct access to a comprehensive catalog of over 80 crystals. Your agent interprets what you need—be it protection, abundance, or heart healing—and pulls precise recommendations instantly. You don't have to manually filter by element or search chakra databases; simply ask for help. The system then handles the complex matching process and returns stones with their specific properties. It works entirely through Vinkius, giving your agent one stable connection point to access this deep knowledge base.

## Tools

### get_crystal_details
Pulls detailed information, including properties and uses, for a single specified crystal.

### filter_crystals_by_element
Narrows the entire catalog down to only those crystals linked to a specific natural element (like Water or Fire).

### find_crystals_by_chakra
Finds all recommended stones associated with one of the seven primary energy centers.

### query_crystals_by_intent
Recommends crystals based on a general spiritual or emotional goal, like promoting peace or increasing focus.

## Prompt Examples

**Prompt:** 
```
I am feeling very anxious and need grounding. Which crystals should I use?
```

**Response:** 
```
To help with grounding and anxiety, I recommend looking into stones associated with the Earth element or the Root chakra. Based on your need for grounding, you might consider using Black Tourmaline or Hematite, which are known for their stabilizing properties.
```

**Prompt:** 
```
List all crystals associated with the Heart chakra.
```

**Response:** 
```
I found several crystals for the Heart chakra, including Rose Quartz, Jade, and Emerald. These stones are primarily used to promote love, compassion, and emotional healing.
```

**Prompt:** 
```
Tell me more about the properties of Amethyst.
```

**Response:** 
```
**Amethyst**

- **Properties**: Calm, Clarity, Protection
- **Element**: Air
- **Chakra**: Third Eye

Amethyst is a powerful stone for spiritual protection and enhancing intuition.
```

## Capabilities

### Find crystals by emotional intent
Directly asks for stones that address a specific feeling or life goal, like grounding anxiety or attracting love.

### Identify crystals by chakra system
Retrieves lists of crystals associated with any of the seven main energy centers in the body.

### Filter stones by element type
Narrows down crystal recommendations to those linked to a specific natural element, such as Air or Earth.

### Get deep stone information
Retrieves detailed profiles on any single crystal, covering its properties and spiritual uses.

## Use Cases

### A client needs immediate anxiety relief.
Instead of having to manually check multiple databases for 'calming' stones, the agent processes your request using `query_crystals_by_intent`. It immediately returns Black Tourmaline and Hematite, noting their stabilizing properties—a quick answer you can trust.

### You're planning a chakra balance session.
You ask the agent to list everything for the Heart Chakra. The tool uses `find_crystals_by_chakra` and lists Rose Quartz, Jade, and Emerald, providing you with an immediate inventory of stones needed.

### A user is confused about elemental resonance.
You ask for crystals related to the 'Earth' element. The agent calls `filter_crystals_by_element` and provides a focused list, confirming which stones offer grounding support through that specific vibrational type.

### A student needs quick facts on one stone.
You need to confirm the properties of Amethyst. You use `get_crystal_details`, and the agent provides a structured breakdown: its element, associated chakra, and main uses—all in one place.

## Benefits

- Get instant, tailored recommendations. Instead of manually searching, ask for crystals based on your emotional intent and get precise results using the `query_crystals_by_intent` tool.
- Stay organized with energy work basics. Easily filter through all available stones by their element or by chakra using specific tools like `filter_crystals_by_element` and `find_crystals_by_chakra`.
- Deep dive into stone knowledge. Use the `get_crystal_details` function to retrieve comprehensive information on any single crystal, verifying its properties for your research.
- Stop guessing what works. The MCP gives you a systematic way to cross-reference goals (like 'sleep' or 'grounding') with proven natural elements and energy centers.
- Work faster than ever before. Your agent handles all the complicated catalog filtering, letting you focus only on interpreting the powerful suggestions.

## How It Works

The bottom line is you get expert-level crystal matching done in seconds without needing to know complex metaphysical terminology yourself.

1. You ask your agent a question about crystals, specifying your goal (e.g., 'I need something for the Throat chakra' or 'What helps with stress?').
2. The MCP translates that request into specific catalog queries, running searches against the element, chakra, or intent databases.
3. Your agent receives the results, presenting a curated list of recommended crystals along with their key properties and why they match your stated need.

## Frequently Asked Questions

**How do I use Crystal Matcher with a specific chakra?**
Use the `find_crystals_by_chakra` tool. Simply ask your agent to find crystals for the relevant chakra, and it will return a list of associated stones.

**Can Crystal Matcher help me with general mood issues?**
Yes. Use `query_crystals_by_intent` and specify your emotional goal (like 'calm' or 'focus'). The system will pull recommendations based on that intent.

**Do I need to use all the tools in Crystal Matcher?**
No. Your agent is designed to pick the right tool for your prompt. If you ask about a specific stone, it uses `get_crystal_details`; if you ask generally, it uses intent or chakra matching.

**Is Crystal Matcher better than searching Google?**
Yeah, because this MCP is structured. Instead of thousands of random articles, the system draws from a verified catalog and cross-references criteria like element and chakra simultaneously for accuracy.