Puzld API

Programmatic Access

Execute agents directly via REST API. Simple authentication, powerful orchestration.

Get API KeysDocumentation
curl -X POST https://api.puzld.cc/mcp/execute \
  -H "X-PUZLD-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "run",
    "prompt": "Hello world",
    "agent": "claude"
  }'

Core Capabilities

Everything you need to build powerful integrations.

API Capabilities
01

Remote Execution

Trigger your local Puzld agents from anywhere. The API bridges to your machine, keeping execution local while access stays global.

  • → Local-first Execution
  • → Global Access
02

Multi-Agent Routing

Route requests to any agent CLI configured locally. Claude Code, Codex, Gemini CLI, Mistral Vibe, or Ollama—same API call.

  • → Unified Interface
  • → Agent Selection
03

MCP Protocol

Built on the Model Context Protocol. Use Puzld as an MCP server from Claude, Cursor, or any MCP-compatible client.

  • → HTTP Transport
  • → Client Agnostic

Endpoint Reference

POST/mcp/execute

Execute an agent with a given prompt and configuration.

Request Body

{
  "action": "run",
  "prompt": "Your prompt here",
  "agent": "claude"
}

Response

{
  "success": true,
  "result": "Agent response...",
  "usage": {
    "tokens": 150
  }
}

Required Headers

X-PUZLD-API-KEY: your_api_keyContent-Type: application/json