# Crystal Matcher MCP MCP

> Crystal Matcher connects your AI agent to a database of 80+ crystals, letting you find stones based on specific spiritual needs, elements, or chakras. Instead of manual research, ask for crystal recommendations designed to address emotional states like anxiety or needing grounding.

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

## Description

Figuring out which crystal matches what you're going through—whether it’s trouble sleeping, feeling stressed, or trying to boost love—is usually a mess. You end up reading pages of dense lore and cross-referencing charts. This MCP takes all that guesswork out of the process. Your agent can interpret your core need and instantly narrow down thousands of crystal properties into precise recommendations.

Need something for the Heart chakra? Want crystals specifically for abundance? Or maybe you just want to filter everything associated with Air? The system handles the filtering across intent, element, and chakra simultaneously. Because this MCP operates on Vinkius, you get full visibility into every search path your agent takes via Vinkius AI Analytics. You'll always know which data points were checked and how the final recommendation was built. This isn't just a database lookup; it’s an intelligent filter for spiritual guidance.

## Tools

### filter_crystals_by_element
Narrows down the entire catalog to show only crystals associated with a specific element like Water or Fire.

### find_crystals_by_chakra
Finds all stones linked to one of the seven main energy centers, such as the Throat chakra or Crown chakra.

### get_crystal_details
Pulls up a full profile for any single crystal you name, listing its properties and element.

### query_crystals_by_intent
Suggests crystals that match a stated emotional or spiritual purpose, like promoting clarity or boosting love.

## 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
The agent locates stones whose properties align with a stated goal, like promoting calmness or fighting anxiety.

### Filter crystals by earth element
You narrow down the catalog to only include crystals associated with a specific natural element, such as Air or Earth.

### Find crystals for a chakra point
The agent pulls up all stones linked directly to one of the seven main energy centers in the body.

### Get detailed crystal profiles
You request specific facts on any stone, including its element and associated properties.

## Use Cases

### Client needs grounding after a stressful week
The coach asks the agent: 'What crystals are best for anxiety?' The agent runs `query_crystals_by_intent`, recommending stones like Black Tourmaline and explaining their stabilizing properties.

### Researching crystal pairings for a blog post
The creator asks the agent to find all crystals linked to the Third Eye chakra, then uses `get_crystal_details` on Amethyst to pull specific facts about its use in enhancing intuition.

### Need stones that feel earthy and promote peace
The user tells the agent they need something related to 'Earth' element, then runs `find_crystals_by_chakra` to narrow down those results only to the Root chakra for maximum focus.

### Discovering stones that support emotional healing
The user asks: 'What crystals help with love?' The agent uses `query_crystals_by_intent`, returning suggestions like Rose Quartz and detailing why they are good for the Heart chakra.

## Benefits

- Stop guessing. Instead of manually searching through unreliable sources, ask your agent to use `query_crystals_by_intent` and get immediate recommendations based on emotional goals.
- Cross-reference criteria easily. Need something for grounding *and* linked to the Earth element? The agent can combine these filters without you needing to run multiple searches.
- Deep knowledge retrieval. Use `get_crystal_details` anytime you need an authoritative, quick summary of a specific stone's history and properties.
- Targeted Chakra work. If a client mentions feeling blocked in their energy flow, the agent uses `find_crystals_by_chakra` to pinpoint solutions for that specific point.
- Efficiency matters. Because Vinkius handles all infrastructure updates and security patches, you never worry about the underlying data structure failing when you need it most.

## How It Works

The bottom line is you get expert curation instantly, without having to know which specific category or tool you need.

1. Tell your agent what you need. You might say, 'I'm looking for something to help with bad sleep.'
2. The system automatically cross-references that intent against the crystal database, checking chakra links and element types.
3. You receive a list of stones and their properties, ready for immediate use.

## Frequently Asked Questions

**How do I find crystals for sleep using `query_crystals_by_intent`?**
Just tell your agent you need stones for sleep or rest. It will use the intent tool to pull up recommendations, often cross-referencing them with elements associated with calming effects.

**Can I combine chakra and element filters using `find_crystals_by_chakra`?**
Yes. The agent can process both criteria at once. You ask for stones that are linked to the Heart chakra AND have an Air element, giving you a highly specific list.

**What is the best way to get information on one stone? Use `get_crystal_details`?**
Yes. If you know the name of a crystal, use `get_crystal_details` for an immediate, comprehensive rundown of its properties and element without having to read multiple pages.

**How do I search by element using `filter_crystals_by_element`?**
Simply ask your agent to filter the catalog by the desired element. For instance, 'Show me all crystals filtered by Water' will give you a precise list.

**How is my personal intent protected when I use `query_crystals_by_intent`?**
Your query data remains private and secure. Vinkius uses a zero-trust proxy for all calls, meaning your specific search terms are used only in transit and never stored on disk.

**If I run `find_crystals_by_chakra` and get no results, what should my agent do?**
Zero results means the current catalog lacks a direct match for that specific chakra. Your agent can then automatically broaden the search by using `filter_crystals_by_element` or checking a general intent.

**Can I use `get_crystal_details` to look up multiple crystals at once?**
The tool is designed for detailed, single-stone lookups. However, you can chain calls together to check many stones sequentially, and Vinkius’ native token optimization keeps your costs low.

**How do I combine `filter_crystals_by_element` output with other workflows?**
You connect once through the Vinkius platform. This allows you to chain this MCP's results—for example, combining element filtering with a messaging tool—to build multi-platform automations.