Get Started

PuzldAI Core

Use PuzldAI through the CLI / TUI for free — no registration needed.

01

Install

npm install -g puzldai
or clone from GitHub
git clone https://github.com/MedChaouch/Puzld.ai
02

Run

Start the interactive TUI or run commands directly.

TUI
puzldai
CLI
puzldai run "your prompt here"

Puzld MCP / API

Once you have PuzldAI Core installed.

01

Authenticate

Login (browser)
puzldai login
Login (headless / no GUI)
puzldai login --token <your-api-key>
02

Serve

Start the MCP server to expose your agents.

puzldai serve --mcp
03

MCP Clients

Add Puzld MCP to Claude Desktop, Cursor, or any MCP client.

claude mcp add puzld https://api.puzld.cc/protocol \
  --header "X-PUZLD-API-KEY: YOUR_API_KEY"

See MCP docs for more clients and configuration details.

04

REST API

Start a local REST API server to integrate with your own apps.

puzldai serve
curl -X POST http://localhost:3000/task \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Explain async/await", "agent": "auto"}'
POST/task— Submit a task
GET/task/:id— Get task result
GET/task/:id/stream— SSE stream
GET/agents— List agents
GET/health— Health check