Crystals MCP Server by RoxyAPI

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

사용해야 할까요

품질 및 안전성

A
설명 품질
98%
스키마 완전성
96%
이름 품질
98%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~5,881토큰 (도구 정의)
~4.4 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 4.59%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`claude_desktop_config.json` 파일에 다음을 추가하세요:

{
  "mcpServers": {
    "crystals": {
      "url": "https://roxyapi.com/mcp/crystals"
    }
  }
}

원격 엔드포인트

https://roxyapi.com/mcp/crystalsstreamable-http

할 수 있는 일

도구 목록

도구 (12)

🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢get_crystals_zodiac_sign(sign, lang, limit, offset, compact)

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.

입력 스키마

{
  "type": "object",
  "properties": {
    "sign": {
      "type": "string",
      "description": "Zodiac sign name, case-insensitive (e.g., pisces, Pisces, PISCES all work). Valid: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces.",
      "enum": [
        "aries",
        "taurus",
        "gemini",
        "cancer",
        "leo",
        "virgo",
        "libra",
        "scorpio",
        "sagittarius",
        "capricorn",
        "aquarius",
        "pisces"
      ],
      "example": "pisces"
    },
    "lang": {
      "type": "string",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.",
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "default": "en",
      "example": "en"
    },
    "limit": {
      "type": "integer",
      "description": "Maximum items to return per page. Range: 1-30, default 20.",
      "minimum": 1,
      "maximum": 30,
      "default": 20,
      "example": 20
    },
    "offset": {
      "type": "integer",
      "description": "Number of items to skip for pagination. Default 0.",
      "minimum": 0,
      "default": 0,
      "example": 0
    },
    "compact": {
      "type": "boolean",
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.",
      "default": false
    }
  },
  "required": [
    "sign"
  ],
  "examples": [
    {
      "sign": "pisces"
    }
  ]
}

출력 스키마

{
  "type": "object",
  "properties": {
    "sign": {
      "type": "string"
    },
    "total": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "crystals": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "imageUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "colors": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "name",
          "id",
          "imageUrl",
          "colors"
        ]
      }
    }
  },
  "required": [
    "sign",
    "total",
    "limit",
    "offset",
    "crystals"
  ]
}
🟢get_crystals_chakra(chakra, lang, limit, offset, compact)

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.

입력 스키마

{
  "type": "object",
  "properties": {
    "chakra": {
      "type": "string",
      "description": "Chakra name, case-insensitive (e.g., heart, Heart, HEART all work). Valid: Root, Sacral, Solar Plexus, Heart, Throat, Third Eye, Crown.",
      "enum": [
        "Root",
        "Sacral",
        "Solar Plexus",
        "Heart",
        "Throat",
        "Third Eye",
        "Crown"
      ],
      "example": "Heart"
    },
    "lang": {
      "type": "string",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.",
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "default": "en",
      "example": "en"
    },
    "limit": {
      "type": "integer",
      "description": "Maximum items to return per page. Range: 1-30, default 20.",
      "minimum": 1,
      "maximum": 30,
      "default": 20,
      "example": 20
    },
    "offset": {
      "type": "integer",
      "description": "Number of items to skip for pagination. Default 0.",
      "minimum": 0,
      "default": 0,
      "example": 0
    },
    "compact": {
      "type": "boolean",
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.",
      "default": false
    }
  },
  "required": [
    "chakra"
  ],
  "examples": [
    {
      "chakra": "Heart"
    }
  ]
}

출력 스키마

{
  "type": "object",
  "properties": {
    "chakra": {
      "type": "string"
    },
    "total": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "crystals": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "imageUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "colors": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "name",
          "id",
          "imageUrl",
          "colors"
        ]
      }
    }
  },
  "required": [
    "chakra",
    "total",
    "limit",
    "offset",
    "crystals"
  ]
}
🟢get_crystals_element(element, lang, limit, offset, compact)

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.

입력 스키마

{
  "type": "object",
  "properties": {
    "element": {
      "type": "string",
      "description": "Element name, case-insensitive (e.g., water, Water, WATER all work). Valid: Earth, Water, Fire, Air, Storm.",
      "enum": [
        "Earth",
        "Water",
        "Fire",
        "Air",
        "Storm"
      ],
      "example": "Water"
    },
    "lang": {
      "type": "string",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.",
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "default": "en",
      "example": "en"
    },
    "limit": {
      "type": "integer",
      "description": "Maximum items to return per page. Range: 1-30, default 20.",
      "minimum": 1,
      "maximum": 30,
      "default": 20,
      "example": 20
    },
    "offset": {
      "type": "integer",
      "description": "Number of items to skip for pagination. Default 0.",
      "minimum": 0,
      "default": 0,
      "example": 0
    },
    "compact": {
      "type": "boolean",
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.",
      "default": false
    }
  },
  "required": [
    "element"
  ],
  "examples": [
    {
      "element": "Water"
    }
  ]
}

출력 스키마

{
  "type": "object",
  "properties": {
    "element": {
      "type": "string"
    },
    "total": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "crystals": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "imageUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "colors": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "name",
          "id",
          "imageUrl",
          "colors"
        ]
      }
    }
  },
  "required": [
    "element",
    "total",
    "limit",
    "offset",
    "crystals"
  ]
}
🟢get_crystals_birthstone_month(month, lang, compact)

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.

입력 스키마

{
  "type": "object",
  "properties": {
    "month": {
      "type": "integer",
      "description": "Birth month as a number from 1 (January) to 12 (December).",
      "minimum": 1,
      "maximum": 12,
      "example": 2
    },
    "lang": {
      "type": "string",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.",
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "default": "en",
      "example": "en"
    },
    "compact": {
      "type": "boolean",
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.",
      "default": false
    }
  },
  "required": [
    "month"
  ],
  "examples": [
    {
      "month": 2
    }
  ]
}

출력 스키마

{
  "type": "object",
  "properties": {
    "month": {
      "type": "number"
    },
    "monthName": {
      "type": "string"
    },
    "total": {
      "type": "number"
    },
    "crystals": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "imageUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "colors": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "name",
          "id",
          "imageUrl",
          "colors"
        ]
      }
    }
  },
  "required": [
    "month",
    "monthName",
    "total",
    "crystals"
  ]
}
🟢get_crystals_search(lang, q, limit, offset, compact)

Search for healing crystals by keyword or name. Matches against crystal names, healing keywords, descriptions, and spiritual/emotional/physical meaning fields. Returns summary data for each crystal. Use the /crystals/{id} detail endpoint for full healing properties. Useful for building crystal search bars, keyword-based recommendation features, and healing property lookups.

입력 스키마

{
  "type": "object",
  "properties": {
    "lang": {
      "type": "string",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.",
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "default": "en",
      "example": "en"
    },
    "q": {
      "type": "string",
      "description": "Search query (2-50 characters). Matches against crystal names, keywords, descriptions, and meaning fields. Case-insensitive partial matching.",
      "minLength": 2,
      "maxLength": 50,
      "example": "love"
    },
    "limit": {
      "type": "integer",
      "description": "Maximum items to return per page. Range: 1-50, default 20.",
      "minimum": 1,
      "maximum": 50,
      "default": 20,
      "example": 20
    },
    "offset": {
      "type": "integer",
      "description": "Number of items to skip for pagination. Default 0.",
      "minimum": 0,
      "default": 0,
      "example": 0
    },
    "compact": {
      "type": "boolean",
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.",
      "default": false
    }
  },
  "required": [
    "q"
  ],
  "examples": [
    {
      "q": "love"
    }
  ]
}

출력 스키마

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "total": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "crystals": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "imageUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "colors": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "name",
          "id",
          "imageUrl",
          "colors"
        ]
      }
    }
  },
  "required": [
    "query",
    "total",
    "limit",
    "offset",
    "crystals"
  ]
}
🟢get_crystals_pairings_id(id, lang, compact)

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.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "URL-safe crystal identifier to find pairings for, case-insensitive (e.g., \"amethyst\", \"Amethyst\", \"rose-quartz\" all resolve).",
      "example": "amethyst"
    },
    "lang": {
      "type": "string",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.",
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "default": "en",
      "example": "en"
    },
    "compact": {
      "type": "boolean",
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.",
      "default": false
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "amethyst"
    }
  ]
}

출력 스키마

{
  "type": "object",
  "properties": {
    "crystal": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "count": {
      "type": "number"
    },
    "pairings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "imageUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "type": "string"
          },
          "chakras": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "keywords": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "name",
          "id",
          "imageUrl",
          "description",
          "chakras",
          "keywords"
        ]
      }
    }
  },
  "required": [
    "crystal",
    "name",
    "count",
    "pairings"
  ]
}
🟢post_crystals_daily(lang, seed, date, compact)

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.

입력 스키마

{
  "type": "object",
  "properties": {
    "lang": {
      "type": "string",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.",
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "default": "en",
      "example": "en"
    },
    "seed": {
      "type": "string",
      "example": "user123",
      "description": "Optional seed for reproducible readings. Same seed + same date = same crystal every time. Pass any unique identifier (userId, email hash, session token). Omit for anonymous daily readings."
    },
    "date": {
      "type": "string",
      "format": "date",
      "example": "2026-03-06",
      "description": "Date for the reading in YYYY-MM-DD format. Defaults to today (UTC). Useful for viewing past daily readings or pre-generating future ones."
    },
    "compact": {
      "type": "boolean",
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.",
      "default": false
    }
  },
  "examples": [
    {}
  ]
}

출력 스키마

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string"
    },
    "seed": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "imageUrl": {
      "type": [
        "string",
        "null"
      ]
    },
    "description": {
      "type": "string"
    },
    "chakras": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "zodiacSigns": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      }
    },
    "affirmation": {
      "type": "string"
    }
  },
  "required": [
    "date",
    "seed",
    "name",
    "id",
    "imageUrl",
    "description",
    "chakras",
    "zodiacSigns",
    "affirmation"
  ]
}
🟢get_crystals_random(lang, compact)

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.

입력 스키마

{
  "type": "object",
  "properties": {
    "lang": {
      "type": "string",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.",
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "default": "en",
      "example": "en"
    },
    "compact": {
      "type": "boolean",
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.",
      "default": false
    }
  },
  "examples": [
    {}
  ]
}

출력 스키마

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "imageUrl": {
      "type": [
        "string",
        "null"
      ]
    },
    "description": {
      "type": "string"
    },
    "chakras": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "zodiacSigns": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      }
    },
    "affirmation": {
      "type": "string"
    }
  },
  "required": [
    "name",
    "id",
    "imageUrl",
    "description",
    "chakras",
    "zodiacSigns",
    "affirmation"
  ]
}
🟢get_crystals_colors(lang, compact)

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.

입력 스키마

{
  "type": "object",
  "properties": {
    "lang": {
      "type": "string",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.",
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "default": "en",
      "example": "en"
    },
    "compact": {
      "type": "boolean",
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.",
      "default": false
    }
  },
  "examples": [
    {}
  ]
}

출력 스키마

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number"
    },
    "colors": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "count",
    "colors"
  ]
}
🟢get_crystals_planets(lang, compact)

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.

입력 스키마

{
  "type": "object",
  "properties": {
    "lang": {
      "type": "string",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.",
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "default": "en",
      "example": "en"
    },
    "compact": {
      "type": "boolean",
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.",
      "default": false
    }
  },
  "examples": [
    {}
  ]
}

출력 스키마

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number"
    },
    "planets": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "count",
    "planets"
  ]
}
🟢get_crystals(lang, chakra, zodiac, element, color, ...)

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.

입력 스키마

{
  "type": "object",
  "properties": {
    "lang": {
      "type": "string",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.",
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "default": "en",
      "example": "en"
    },
    "chakra": {
      "type": "string",
      "description": "Filter by chakra association, case-insensitive. Valid values: Root, Sacral, Solar Plexus, Heart, Throat, Third Eye, Crown.",
      "enum": [
        "Root",
        "Sacral",
        "Solar Plexus",
        "Heart",
        "Throat",
        "Third Eye",
        "Crown"
      ],
      "example": "Heart"
    },
    "zodiac": {
      "type": "string",
      "description": "Filter by zodiac sign, case-insensitive. Valid values: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces.",
      "enum": [
        "aries",
        "taurus",
        "gemini",
        "cancer",
        "leo",
        "virgo",
        "libra",
        "scorpio",
        "sagittarius",
        "capricorn",
        "aquarius",
        "pisces"
      ],
      "example": "pisces"
    },
    "element": {
      "type": "string",
      "description": "Filter by elemental association, case-insensitive. Valid values: Earth, Water, Fire, Air, Storm.",
      "enum": [
        "Earth",
        "Water",
        "Fire",
        "Air",
        "Storm"
      ],
      "example": "Water"
    },
    "color": {
      "type": "string",
      "description": "Filter by crystal color (partial match, case-insensitive). E.g., \"pink\", \"green\", \"blue\", \"purple\". Use GET /colors for valid values.",
      "example": "pink"
    },
    "planet": {
      "type": "string",
      "description": "Filter by planetary association (partial match, case-insensitive). E.g., \"Venus\", \"Moon\", \"Jupiter\". Use GET /planets for valid values.",
      "example": "Venus"
    },
    "limit": {
      "type": "integer",
      "description": "Maximum items to return per page. Range: 1-100, default 20.",
      "minimum": 1,
      "maximum": 100,
      "default": 20,
      "example": 20
    },
    "offset": {
      "type": "integer",
      "description": "Number of items to skip for pagination. Default 0.",
      "minimum": 0,
      "default": 0,
      "example": 0
    },
    "compact": {
      "type": "boolean",
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.",
      "default": false
    }
  },
  "examples": [
    {}
  ]
}

출력 스키마

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "crystals": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "id": {
            "type": "string"
          },
          "imageUrl": {
            "type": [
              "string",
              "null"
            ]
          },
          "colors": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            }
          },
          "chakras": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "name",
          "id",
          "imageUrl",
          "colors",
          "chakras"
        ]
      }
    }
  },
  "required": [
    "total",
    "limit",
    "offset",
    "crystals"
  ]
}
🟢get_crystals_id(id, lang, compact)

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.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "URL-safe crystal identifier, case-insensitive (e.g., \"amethyst\", \"Amethyst\", \"rose-quartz\" all resolve). Must match an entry in the database.",
      "example": "amethyst"
    },
    "lang": {
      "type": "string",
      "description": "Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English.",
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru",
        "zh-Hans",
        "zh-Hant"
      ],
      "default": "en",
      "example": "en"
    },
    "compact": {
      "type": "boolean",
      "description": "Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {\"__cols\":[names],\"__rows\":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.",
      "default": false
    }
  },
  "required": [
    "id"
  ],
  "examples": [
    {
      "id": "amethyst"
    }
  ]
}

출력 스키마

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "imageUrl": {
      "type": [
        "string",
        "null"
      ]
    },
    "description": {
      "type": "string"
    },
    "meaning": {
      "type": "object",
      "properties": {
        "spiritual": {
          "type": [
            "string",
            "null"
          ]
        },
        "emotional": {
          "type": "string"
        },
        "physical": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "spiritual",
        "emotional",
        "physical"
      ]
    },
    "chakras": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "zodiacSigns": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      }
    },
    "planet": {
      "type": [
        "string",
        "null"
      ]
    },
    "elements": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      }
    },
    "colors": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      }
    },
    "hardness": {
      "type": "number"
    },
    "numericalVibration": {
      "type": "number"
    },
    "keywords": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      }
    },
    "birthMonth": {
      "type": [
        "number",
        "null"
      ]
    },
    "affirmation": {
      "type": "string"
    },
    "pairsWith": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "name",
    "id",
    "imageUrl",
    "description",
    "meaning",
    "chakras",
    "zodiacSigns",
    "planet",
    "elements",
    "colors",
    "hardness",
    "numericalVibration",
    "keywords",
    "birthMonth",
    "affirmation",
    "pairsWith"
  ]
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 12개
검증됨버전이 기록되지 않음도구 12개