Puzzlebox FAQs

Question 1

What is Puzzlebox?

Accepted Answer

Puzzlebox is an MCP (Model Context Protocol) server that hosts finite state machines as dynamic resources. It enables clients to subscribe to these resources and receive real-time updates when their state changes, facilitating agent coordination.

Question 2

What are the key features of Puzzlebox?

Accepted Answer

Puzzlebox supports multiple client connections, manages puzzle instances as dynamic resources, provides tools for adding, querying, and acting on puzzles, allows clients to subscribe to puzzle state changes, and implements state transition guards for validation.

Question 3

How do I get started with Puzzlebox?

Accepted Answer

To get started, you need Node.js and npm installed. Then, clone the Puzzlebox repository, install dependencies with `npm install`, build with `npm run build`, and start the server with `npm run start`. You can then use an MCP client like the MCP Inspector to connect and interact with Puzzlebox.

Question 4

How does Puzzlebox help with team coordination?

Accepted Answer

Puzzlebox allows teams to be process-aware without being subject to 'hallucination'. It represents project phases and processes as 'puzzles' (finite state machines) that agents can interact with, ensuring everyone follows a defined and validated workflow.

Question 5

What are 'puzzles' in Puzzlebox?

Accepted Answer

In Puzzlebox, a 'puzzle' is simply a finite state machine. It represents a stateful process with discrete states, actions that transition between states, an initial state, and a current state. Transitions can be validated using state exit and enter guards.

Puzzlebox

Puzzlebox

Key Features

Use Cases

Key Features

Use Cases