PPSSPP Debug MCP Server

Read from the package source without running it. The installed server may list more.

• _lifespan

  Startup: spawn idle GC + load manifest + register exposed scripts.

• ppsspp_analyze_log

  PURPOSE: Filter a PPSSPP log file for ERROR / WARNING / CRASH lines.

• ppsspp_assemble

  PURPOSE: Assemble MIPS instruction(s) and write the resulting bytes to memory.

• ppsspp_batch_cancelwrite action

  PURPOSE: Request cancellation of a queued or running background batch job.

• ppsspp_batch_list

  PURPOSE: Survey all background batch jobs currently retained by the registry — the list companion to ppsspp_batch_status / ppsspp_batch_cancel.

• ppsspp_batch_status

  PURPOSE: Poll the state and progress of a background batch job without touching the session.

• ppsspp_batch_step
• ppsspp_breakpoint
• ppsspp_convert_address

  PURPOSE: Convert an address between IDA and PPSSPP address spaces (offset ±0x08804000).

• ppsspp_disassemble

  PURPOSE: Disassemble N MIPS instructions at a given address.

• ppsspp_dump_clut

  PURPOSE: Dump the currently-bound CLUT palette as an image plus metadata.

• ppsspp_dump_texture

  PURPOSE: Dump the currently-bound GPU texture as an image plus metadata.

• ppsspp_evaluate

  PURPOSE: Evaluate a debugger expression (register names, hex literals, simple arithmetic).

• ppsspp_frame_snapshot

  PURPOSE: One-call paused scene snapshot — pause (unless already paused), capture pc + registers + optional named probes, then resume.

• ppsspp_get_pc

  PURPOSE: Safely read the current Program Counter.

• ppsspp_gpu_record

  PURPOSE: Capture the next rendered frame's GE command stream as a binary dump file.

• ppsspp_gpu_stats

  PURPOSE: Query GPU counters — fps, vblanks per second, timing info.

• ppsspp_health

  PURPOSE: Probe MCP server liveness and readiness without contacting PPSSPP. Use this before any session-dependent tool to verify the server is up.

• ppsspp_hold_buttons

  PURPOSE: Hold a combination of PSP buttons until a subsequent call changes the state.

• ppsspp_list_addresses

  PURPOSE: List the project's known address constants from addresses.yaml — the single source of truth; never guess hex addresses.

• ppsspp_list_scripts

  PURPOSE: List diagnostic scripts declared in .ppsspp-dfx/config/scripts.manifest.yaml.

• ppsspp_memory_info_search

  PURPOSE: Search PPSSPP's memory-tracking metadata for allocation/texture tags matching a string.

• ppsspp_memory_map

  PURPOSE: Get the PPSSPP memory region map (user / kernel / VRAM ranges).

• ppsspp_press_button

  PURPOSE: Simulate a single PSP button press for a duration.

• ppsspp_query
• ppsspp_read_memory
• ppsspp_reload_scripts

  PURPOSE: Manually reload the script manifest YAML and clear the script module cache.

• ppsspp_replay
• ppsspp_run_scriptwrite action

  PURPOSE: Invoke a manifest-registered diagnostic script by name with validated input.

• ppsspp_screenshot

  PURPOSE: Capture the framebuffer as an image (ImageContent) plus metadata.

• ppsspp_search_disasm

  PURPOSE: Loop-search disassembly for a substring, collecting matching instructions with context.

• ppsspp_send_analogwrite action

  PURPOSE: Send an analog stick position (x, y in [0, 255], 128 = center).

• ppsspp_session
• ppsspp_session_list

  PURPOSE: List all active PPSSPP sessions.

• ppsspp_smoke_test

  PURPOSE: Four-point session health check — iso_loaded, cpu_running, ws_connected, game_mode_valid.

• ppsspp_state_observer
• ppsspp_step

  PURPOSE: Aggregate CPU step + run-state control (into / over / out, pause, resume, reset, run_until, next_hle).

• ppsspp_trace_memory_access

  PURPOSE: One-call answer to 'what code reads/writes this address' — arm a memory breakpoint, wait for the hit, capture pc (+registers/backtrace), remove the breakpoint, and resume.

• ppsspp_wait_breakpoint

  PURPOSE: Block until a breakpoint hit (any kind) — replaces polling gpu_stats errors as a hit probe.

• ppsspp_wait_frames

  PURPOSE: Wait N frames (wall-clock sleep at 60 FPS by default) to let the emulator advance.

• ppsspp_write_memorywrite action

  PURPOSE: Write u8/u16/u32 or raw bytes to memory.

• ppsspp_write_registerwrite action

  PURPOSE: Set a CPU register (GPR/FPU/VFPU names, plus pc/hi/lo).

• register_all_tools

  Import every static tool module, triggering decorator registration.

• Code scan117 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitylocal package, no credentials required12/15
• Maintenanceno repository listed3/15
• Maintainer identityno repository or website to verify2/10

Grade history

• 2026-09-19restoreD → Cscore 65: No source repository listed
• 2026-09-19downgradeC → Dscore 46: Whole environment serialized (possible credential exfil); No source repository listed

PPSSPP Debug MCP Server: common questions

Is PPSSPP Debug MCP Server safe?

With care: it is graded C, so read the findings first (65/100). Read the PPSSPP Debug MCP Server safety report

How do I install PPSSPP Debug MCP Server?

It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.

Does PPSSPP Debug MCP Server need an API key?

Not as far as the registry entry and our scan can tell: no credentials are declared or required.

Is PPSSPP Debug MCP Server maintained?

The latest release is v0.1.4.