Claude MarketplacesSubmit

Brainfaq Mcp

labarilem/brainfaq-mcp

Provides a complete debugging environment for Brainfuck programs through six MCP tools. You can load code with configurable tape size and cell value limits, step through execution instruction by instruction, run until completion or input wait, and inspect memory state with windowing. The server handles all eight Brainfuck operations, validates bracket matching, detects overflow and underflow, and manages input/output buffers. Reach for this when you need an LLM to debug or analyze Brainfuck code, whether you're learning esoteric languages, building interpreters, or just need to figure out why your bracket loops aren't behaving.

tools: 6
transport: STDIO
last updated: Jan 17, 2026

Tools

6 tools

Public tool metadata for what this MCP can expose to an agent.

load_codeReset the debugger and load new Brainfuck source code. Supports configurable tape size, min/max cell values, and initial input.

Reset the debugger and load new Brainfuck source code. Supports configurable tape size, min/max cell values, and initial input.

No parameter schema in public metadata yet.

stepExecute a specified number of instructions (default 1) with detailed state output.

Execute a specified number of instructions (default 1) with detailed state output.

No parameter schema in public metadata yet.

runRun the program until it finishes or waits for input, with optional instruction limit.

Run the program until it finishes or waits for input, with optional instruction limit.

No parameter schema in public metadata yet.

add_inputAppend characters to the input buffer when the program is waiting for input.

Append characters to the input buffer when the program is waiting for input.

No parameter schema in public metadata yet.

get_stateGet the current interpreter state (memory, pointers, output) with optional windowing.

Get the current interpreter state (memory, pointers, output) with optional windowing.

No parameter schema in public metadata yet.

read_outputGet the complete output string generated so far.

Get the complete output string generated so far.

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly

Agent CaffeineSponsoredClose your lid, come back to finished work

SnugSponsoredThe clipboard manager for the AI era Promote your product hereReach 125k+ visitors monthly

WaxSponsoredBlock anything with supervision, without erasing your iPhone Promote your product hereReach 125k+ visitors monthly

knobsSponsoredSee your site on any phone, any day, in any language

Readme

brainfaq-mcp

MCP server for the Brainfuck programming language that allows your favourite LLM to debug Brainfuck programs.

Usage

Use this command to run the MCP server:

npx brainfaq-mcp

To use it in VS Code, add the following JSON snippet to .vscode/mcp.json (create the file if you don't have it):

{
  "servers": {
    "brainfaq-mcp": {
      "command": "npx",
      "args": ["brainfaq-mcp"]
    }
  }
}

The MCP can be added to other IDEs with LLM agents support (e.g. Cursor) in similar ways. Check their documentation and configure them to run npx brainfaq-mcp. It will start the MCP server in stdio mode.

Features

MCP Tools

View the full README on GitHub

Details

Repository: github.com/labarilem/brainfaq-mcp
Package: brainfaq-mcp
Transport: STDIO
Registry: MCP registry, active