MGS Toolbox
Fantasy TTRPG data: metals, minerals, ingredients, potions, gems, craft rules, music catalogue.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"toolbox": {
"url": "https://michaelghelfistudios.com/api/v1/mcp"
}
}
}Remote-Endpunkte
https://michaelghelfistudios.com/api/v1/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (12)
🟢search_encyclopedia(q, kind, lang, limit)
Find metals, minerals, alchemical ingredients, potions and gems by name (case- and accent-insensitive; exact names first, then prefixes, then substrings, aliases included). Returns each hit with its kind, id, one-line summary and page url; call get_entry for the full data.
Eingabe-Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"minLength": 1,
"description": "The name or part of it."
},
"kind": {
"type": "string",
"description": "Restrict to some catalogues, comma-separated (e.g. \"metal,mineral\")."
},
"lang": {
"type": "string",
"enum": [
"en",
"fr",
"all"
],
"description": "Language of the texts: en (default), fr, or all for both."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"q"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_entry(kind, id, lang)
The full data of one metal, mineral, ingredient, potion or gem by its id (from search_encyclopedia or list_entries): properties, lore, page url, embed_url.
Eingabe-Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"metal",
"mineral",
"ingredient",
"potion",
"gem"
],
"description": "Which catalogue: metal, mineral, ingredient, potion or gem."
},
"id": {
"type": "string",
"description": "The entry id, e.g. \"iron\", \"rose_quartz\"."
},
"lang": {
"type": "string",
"enum": [
"en",
"fr",
"all"
],
"description": "Language of the texts: en (default), fr, or all for both."
}
},
"required": [
"kind",
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_entries(kind, filters, q, lang, limit, ...)
A page of one catalogue, filtered. Use it to answer "which minerals are cubic and gem-quality?", "legendary metals of the medieval era", "swamp ingredients with a fire essence". Combine with q for a name search inside the filter.
Eingabe-Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"metal",
"mineral",
"ingredient",
"potion",
"gem"
],
"description": "Which catalogue: metal, mineral, ingredient, potion or gem."
},
"filters": {
"type": "object",
"additionalProperties": {
"type": "string"
},
"description": "Field filters as {name: \"value\" | \"value1,value2\"} (any-of, case-insensitive). Names per catalogue: metal → category, era, rarity, fictional, tag; mineral → type, system, rarity, gem_quality, color, magic, planar_origin, origin; ingredient → category, rarity, environment, essence, tag; potion → essence; gem → color, rarity, temporary. list_facets gives the values."
},
"q": {
"type": "string"
},
"lang": {
"type": "string",
"enum": [
"en",
"fr",
"all"
],
"description": "Language of the texts: en (default), fr, or all for both."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200
},
"offset": {
"type": "integer",
"minimum": 0
}
},
"required": [
"kind"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪random_entry(kind, filters, lang)
One entry at random among those matching the filters: loot tables, "mineral of the day", a credible metal for a blacksmith, a foraging roll.
Eingabe-Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"metal",
"mineral",
"ingredient",
"potion",
"gem"
],
"description": "Which catalogue: metal, mineral, ingredient, potion or gem."
},
"filters": {
"type": "object",
"additionalProperties": {
"type": "string"
},
"description": "Field filters as {name: \"value\" | \"value1,value2\"} (any-of, case-insensitive). Names per catalogue: metal → category, era, rarity, fictional, tag; mineral → type, system, rarity, gem_quality, color, magic, planar_origin, origin; ingredient → category, rarity, environment, essence, tag; potion → essence; gem → color, rarity, temporary. list_facets gives the values."
},
"lang": {
"type": "string",
"enum": [
"en",
"fr",
"all"
],
"description": "Language of the texts: en (default), fr, or all for both."
}
},
"required": [
"kind"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_facets(kind)
Every distinct value of each filterable field of a catalogue (categories, rarities, crystal systems, environments, essences…) and its entry count.
Eingabe-Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"metal",
"mineral",
"ingredient",
"potion",
"gem"
],
"description": "Which catalogue: metal, mineral, ingredient, potion or gem."
}
},
"required": [
"kind"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪craft_rules(lang)
The rules of the crafting system (characters, essences, extraction, brewing, gem cutting, socketing) as titled HTML sections.
Eingabe-Schema
{
"type": "object",
"properties": {
"lang": {
"type": "string",
"enum": [
"en",
"fr",
"all"
],
"description": "Language of the texts: en (default), fr, or all for both."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_tracks(type, genre, mood, era, keyword, ...)
Published tracks of MGS Audio (music, ambiences, sound effects) with composer, album, moods, keywords, duration and page url. Metadata only: no audio file. "A battle theme" → genre: "Combat", type: "music"; "a forest ambience" → type: "ambience", genre: "Forest"; "something for a dungeon" → keyword: "dungeon".
Eingabe-Schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "Audio type(s), comma-separated: music, ambience, sfx…"
},
"genre": {
"type": "string",
"description": "Theme(s), comma-separated, case-insensitive: Combat, Forest, Dungeon, Taverns and Inns, Magic, Weather… (audio_taxonomy lists them)."
},
"mood": {
"type": "string",
"description": "Musical style(s), comma-separated: Orchestral, Celtic, Folk, Medieval, Metal…"
},
"era": {
"type": "string",
"description": "Era token(s), comma-separated."
},
"keyword": {
"type": "string",
"description": "Keyword(s), comma-separated, any of them."
},
"composer": {
"type": "string",
"description": "Composer id or slug."
},
"album": {
"type": "string",
"description": "Album id or slug."
},
"q": {
"type": "string",
"description": "Text search in title, description, keywords."
},
"duration_min": {
"type": "number",
"description": "Minimum duration, seconds."
},
"duration_max": {
"type": "number",
"description": "Maximum duration, seconds."
},
"sort": {
"type": "string",
"enum": [
"newest",
"oldest",
"title",
"duration",
"random"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50
},
"offset": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪random_track(type, genre, mood, era, keyword, ...)
One published track at random among those matching the filters.
Eingabe-Schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "Audio type(s), comma-separated: music, ambience, sfx…"
},
"genre": {
"type": "string",
"description": "Theme(s), comma-separated, case-insensitive: Combat, Forest, Dungeon, Taverns and Inns, Magic, Weather… (audio_taxonomy lists them)."
},
"mood": {
"type": "string",
"description": "Musical style(s), comma-separated: Orchestral, Celtic, Folk, Medieval, Metal…"
},
"era": {
"type": "string",
"description": "Era token(s), comma-separated."
},
"keyword": {
"type": "string",
"description": "Keyword(s), comma-separated, any of them."
},
"composer": {
"type": "string",
"description": "Composer id or slug."
},
"album": {
"type": "string",
"description": "Album id or slug."
},
"q": {
"type": "string",
"description": "Text search in title, description, keywords."
},
"duration_min": {
"type": "number",
"description": "Minimum duration, seconds."
},
"duration_max": {
"type": "number",
"description": "Maximum duration, seconds."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_track(id)
One track by id or slug, with its published alternative versions.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_composers
Every composer with published tracks, most prolific first, with their page url.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_albums(limit, offset)
Published albums with track count, page url and an embeddable player url.
Eingabe-Schema
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200
},
"offset": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪audio_taxonomy
The vocabulary of the track filters: every genre, mood, era and keyword in use.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Nachweis