About Black Souls MCP
Black Souls MCP is an MCP server published by yk4464 in the Agents category: local MCP for BLACK SOULS: agents read RGSS3 objects and drive the native input loop.
The repository has 5 stars and 2 forks, with the last commit 3 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/yk4464/black-souls-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (37)
black_souls_advance_dialogueAdvance active dialogue until it ends or a choice appears, optionally selecting a choice.
Parameters not published.
black_souls_battle_actionSubmit one battle input, not a whole turn: pick an available command (attack / skill / magic if listed / guard / item / flee / equip_change), a list index, and an enemy target if needed. Use black_souls_battle_options for actual commands and exact indices; disabled commands and unusable entries are refused. A subsequent action slot or ATB wait may remain before execution. Returns battle_outcome (v
Parameters not published.
black_souls_battle_optionsRead actual actor commands (including enablement, escape and equipment), visible skill/item lists with usable flags, and targetable enemies. magic exists only if a second skill group appears; during ATB charge no actor is ready. Indices match the game windows and feed black_souls_battle_action.
Parameters not published.
black_souls_eval_statusCheck scenario completion conditions against live game state. Used by the eval runner; returns pass/fail per condition.
Parameters not published.
black_souls_get_eventInspect an event
Parameters not published.
black_souls_get_full_mapRequest map tiles, passability, regions, terrain tags, and events up to radius 20. The scan runs inside one game frame: radius 6 is cheap, radius 20 freezes the game for about a second, so prefer 12 or less.
Parameters not published.
black_souls_get_inventoryRead the party
Parameters not published.
black_souls_get_mapRead the current nearby map tiles, passability, and events directly from RGSS3.
Parameters not published.
black_souls_get_party_detailRead detailed party stats, equipment, and learned skills.
Parameters not published.
black_souls_get_scene_detailRead deeper state for the active map, battle, or menu scene.
Parameters not published.
Show all 37 tools
black_souls_get_stateRead current scene, player, party, message, windows, and battle state directly from RGSS3.
Parameters not published.
black_souls_get_switchesRead RPG Maker boolean switches by ID. Request up to 64 IDs per call.
Parameters not published.
black_souls_get_variablesRead RPG Maker game variable values by ID. Request up to 64 IDs per call.
Parameters not published.
black_souls_goals_readRead the persistent objective hierarchy and active goal.
Parameters not published.
black_souls_goals_set_activeChoose the gameplay goal currently being pursued, or clear it.
Parameters not published.
black_souls_goals_writeCreate or update a persistent gameplay goal.
Parameters not published.
black_souls_healthComprehensive bridge health check with diagnosis and recommended recovery action.
Parameters not published.
black_souls_inputInject one allowlisted virtual RPG Maker input into the normal game input loop. Use dash_up/down/left/right for Shift-style running and text_skip (repeat as needed) for Ctrl-style rapid text advance.
Parameters not published.
black_souls_input_sequenceInject up to 200 allowlisted inputs and frame waits as one ordered sequence. Composite dash directions hold the run modifier with movement; repeated text_skip mirrors holding Ctrl through dialogue or settlement text.
Parameters not published.
black_souls_interactWalk up to and interact with a nearby event, optionally selected by ID.
Parameters not published.
black_souls_killForcefully terminate the running BLACK SOULS process. Safe to call when game is not running.
Parameters not published.
black_souls_launchLaunch the independent BLACK SOULS MCP edition and wait for its in-game bridge. The window is minimized after launch by default so real keyboard input cannot leak into the game; inputs keep working through the background wake path.
Parameters not published.
black_souls_list_savesList independent MCP-edition save slots and metadata without modifying them.
Parameters not published.
black_souls_loadLoad a save slot from the title screen or the in-game menu and return the resulting state.
Parameters not published.
black_souls_memory_deleteDelete one long-term memory entry.
Parameters not published.
black_souls_memory_readRead long-term game knowledge, optionally filtered by category.
Parameters not published.
black_souls_memory_writeStore or update one long-term game knowledge entry.
Parameters not published.
black_souls_navigateMove to a target tile using automatic pathfinding over current passability data.
Parameters not published.
black_souls_saveTrigger an in-game save to a specific slot (0-indexed) by injecting menu navigation inputs. Only works from Scene_Map.
Parameters not published.
black_souls_scratchpad_readRead the AI agent
Parameters not published.
black_souls_scratchpad_writeUpdate notes, flags, or recent actions in the session scratchpad.
Parameters not published.
black_souls_select_gameChoose which game every other tool operates on: bs1 = BLACK SOULS, bs2 = BLACK SOULS II. Omit game to list both with their prepared copies and the current choice. The choice persists across server restarts; switching is refused while the current game is still running.
Parameters not published.
black_souls_session_log_appendAppend a significant gameplay event to the persistent session log.
Parameters not published.
black_souls_session_log_readRead the most recent persistent session log entries.
Parameters not published.
black_souls_situationGet a concise snapshot of the current game situation, contextual action suggestions, and warnings.
Parameters not published.
black_souls_statusInspect the selected game (see black_souls_select_game), its prepared copy, and the live RGSS3 bridge status.
Parameters not published.
black_souls_waitWait until a game condition becomes true before proceeding.
Parameters not published.
Ask AI
Ask AI about Black Souls MCP
Powered by Claude
Security checks
6 checks have not been run yet.