{"repo":"cliffhall/puzzlebox","free":true,"listed":false,"github":"https://github.com/cliffhall/puzzlebox","clone":"git clone https://github.com/cliffhall/puzzlebox.git","description":"An MCP server that hosts finite state machines as dynamic resources that multiple clients can subscribe to and be updated when their state changes.","language":"TypeScript","stars":31,"topics":[],"license":"MIT","category":"mcp-servers","readme_excerpt":"puzzlebox Coordinating agents with state machines An MCP server that hosts finite state machines as dynamic resources that clients can subscribe to and be updated when their state changes. Feature Roadmap and Status A work in progress. Much is done, a few bits remain to be done. [x] Unit tests for tool code [x] Integration tests for MCP server (both SSE and StreamableHttp) [x] SSE transport [x] StreamableHttp transport [x] Multiple simultaneous client connections (both transports) [x] Create puzzles (state machines) as dynamic resources [x] Subscribe to puzzles [x] Receive update notifications when puzzles change [x] Get puzzle snapshot (current state and available actions) [x] Change puzzle state by performing action on puzzle [ ] Resource creation by puzzle state (used by agents and guard prompts) [ ] Transition guard prompt creation (uses resources by state) [ ] Transition guard via sampling [ ] Command line REPL [ ] Demo via REPL What problem does puzzlebox address? Collaboration and coordination are related but different problems. Collaboration is good for non-trivial yet relatively simple tasks. To tackle long horizon efforts, puzzlebox solves for coordination. Teams need coordination Marshalling multiple agents toward a big goal is tougher than just breaking down a request into tasks, assigning them to available agents and enabling collaboration between them. Just as a few agents can collaborate to complete a small project, several teams of process-aware agents need to","default_branch":null,"files":null,"tree":[],"storefront":"/r/cliffhall","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/cliffhall/puzzlebox/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}