Skip to content

Crystals MCP Server by RoxyAPI

by roxyapi.com · remote · no sign-in to list tools · v1.0.1 · published by com.roxyapi

Crystal meanings, healing properties, chakra and birthstone lookups for AI agents.

Changes · 1

12 tools: 1 change things and 11 only read.

Scanned Oct 21, 2026

1 check matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http crystals https://roxyapi.com/mcp/crystals --header 'X-API-Key: <your-x-api-key>'

Findings

Matches of fixed checks, with the text they matched.

1 warn
  • The server marks "post_crystals_daily" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false}; The name "post_crystals_daily" says "post": a word for a change.

    What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

12 tools

Changes things 1Claude Code: ask
  • post_crystals_dailyGet the crystal of the day as a discovery teaser.1 finding

    Why it is in this group

    • The name "post_crystals_daily" says "post": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "post_crystals_daily" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false}; The name "post_crystals_daily" says "post": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Get the crystal of the day as a discovery teaser. Returns a deterministic crystal based on the current date (or a provided seed date), ensuring all users see the same crystal for any given day. Use the /crystals/{id} detail endpoint for complete spiritual, emotional, and physical healing properties. Perfect for daily guidance features, push notifications, wellness app widgets, and crystal journal integrations.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
Only reads 11Claude Code: allow
  • get_crystalsRetrieve healing crystals and gemstones with pagination.No findings

    Why it is in this group

    • The name "get_crystals" says "get": a word for reading.
    Description, as the server wrote it
    Retrieve healing crystals and gemstones with pagination. Supports optional filtering by chakra, zodiac sign, element, color, or planet. Returns minimal summary fields per crystal. Use the detail endpoint for full healing properties. Perfect for building crystal explorer apps, healing stone guides, and personalized crystal recommendation engines.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • get_crystals_birthstone_monthGet the traditional birthstone crystals for a given birth month.No findings

    Why it is in this group

    • The name "get_crystals_birthstone_month" says "get": a word for reading.
    Description, as the server wrote it
    Get the traditional birthstone crystals for a given birth month. Returns summary data for each crystal. Use the /crystals/{id} detail endpoint for full healing properties. Based on GIA-authoritative birthstone assignments. Perfect for birthday gift recommendations, personalized crystal suggestions, and birthstone jewelry applications.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • get_crystals_chakraGet healing crystals and gemstones that resonate with a specific chakra energy center.No findings

    Why it is in this group

    • The name "get_crystals_chakra" says "get": a word for reading.
    Description, as the server wrote it
    Get healing crystals and gemstones that resonate with a specific chakra energy center. Returns summary data for each crystal. Use the /crystals/{id} detail endpoint for full healing properties. Supports all 7 primary chakras: Root, Sacral, Solar Plexus, Heart, Throat, Third Eye, and Crown. Essential for crystal grid building, chakra balancing, and energy healing applications.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • get_crystals_colorsList all unique crystal colors available in the database.No findings

    Why it is in this group

    • The name "get_crystals_colors" says "get": a word for reading.
    Description, as the server wrote it
    List all unique crystal colors available in the database. Use these values with the color filter on GET /crystals to find crystals by color. Essential reference endpoint for building color-based browsing of healing stones, visual crystal pickers, and filtering UI. The values are filter identifiers and stay in English under every lang, so a translated picker still submits a color the filter accepts.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • get_crystals_elementGet healing crystals and gemstones associated with a specific natural element.No findings

    Why it is in this group

    • The name "get_crystals_element" says "get": a word for reading.
    Description, as the server wrote it
    Get healing crystals and gemstones associated with a specific natural element. Returns summary data for each crystal. Use the /crystals/{id} detail endpoint for full healing properties. Supports five elements: Earth, Water, Fire, Air, and Storm. Essential for elemental crystal selection, nature-based healing, and element-themed crystal grid applications.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • get_crystals_idGet complete healing properties and metaphysical data for a specific crystal or gemstone.No findings

    Why it is in this group

    • The name "get_crystals_id" says "get": a word for reading.
    Description, as the server wrote it
    Get complete healing properties and metaphysical data for a specific crystal or gemstone. Returns spiritual, emotional, and physical healing interpretations along with chakra associations, zodiac connections, elemental properties, and crystal pairing recommendations. Authoritative interpretations covering all major healing crystals.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • get_crystals_pairings_idGet crystals that pair well with a given crystal for enhanced healing combinations.No findings

    Why it is in this group

    • The name "get_crystals_pairings_id" says "get": a word for reading.
    Description, as the server wrote it
    Get crystals that pair well with a given crystal for enhanced healing combinations. Returns the source crystal along with its recommended companion stones and their properties. Essential for crystal grid building, healing combination recommendations, and crystal shop cross-sell features.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • get_crystals_planetsList all unique planetary associations available in the database.No findings

    Why it is in this group

    • The name "get_crystals_planets" says "get": a word for reading.
    Description, as the server wrote it
    List all unique planetary associations available in the database. Use these values with the planet filter on GET /crystals to find crystals by ruling planet. Essential reference endpoint for astrology app builders who want to recommend crystals based on planetary placements in a birth chart. The values are filter identifiers and stay in English under every lang, so a translated picker still submits a planet the filter accepts.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • get_crystals_randomGet a randomly selected healing crystal as a discovery teaser.No findings

    Why it is in this group

    • The name "get_crystals_random" says "get": a word for reading.
    Description, as the server wrote it
    Get a randomly selected healing crystal as a discovery teaser. Returns a different crystal on each request (non-deterministic). Use the /crystals/{id} detail endpoint for complete spiritual, emotional, and physical healing properties. Perfect for crystal discovery features, surprise crystal picks, crystal roulette games, and exploration widgets. For a deterministic daily crystal that is the same for all users on a given date, use the /daily endpoint instead.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • get_crystals_zodiac_signGet healing crystals and gemstones associated with a specific zodiac sign.No findings

    Why it is in this group

    • The name "get_crystals_zodiac_sign" says "get": a word for reading.
    Description, as the server wrote it
    Get healing crystals and gemstones associated with a specific zodiac sign. Returns summary data for each crystal. Use the /crystals/{id} detail endpoint for full healing properties. Supports all 12 zodiac signs from Aries through Pisces. Perfect for personalized crystal recommendations based on astrological birth chart data.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.0.1. Values in angle brackets are yours to fill in.

claude mcp add --transport http crystals https://roxyapi.com/mcp/crystals --header 'X-API-Key: <your-x-api-key>'

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__crystals__get_crystals_zodiac_sign",
      "mcp__crystals__get_crystals_chakra",
      "mcp__crystals__get_crystals_element",
      "mcp__crystals__get_crystals_birthstone_month",
      "mcp__crystals__get_crystals_search",
      "mcp__crystals__get_crystals_pairings_id",
      "mcp__crystals__get_crystals_random",
      "mcp__crystals__get_crystals_colors",
      "mcp__crystals__get_crystals_planets",
      "mcp__crystals__get_crystals",
      "mcp__crystals__get_crystals_id"
    ],
    "ask": [
      "mcp__crystals__post_crystals_daily"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as crystals. Review it before you use it.