API Playground

Test the agent API

Copy any of these curl commands to test against our live demo agent. The agent speaks REST, A2A/UCP, and MCP.

GET/healthAgent health check — returns version, uptime, platform, backend status

Request

curl https://demo-agent.nulogic.ai/health

Response

{
  "status": "healthy",
  "core_version": "1.0.0",
  "retailer": "sfcc_demo_store",
  "uptime_seconds": 3600,
  "backend_connected": true,
  "mode": "live"
}

GET/.well-known/agent-card.jsonA2A agent card — describes the agent's capabilities for AI-to-AI discovery

Request

curl https://demo-agent.nulogic.ai/.well-known/agent-card.json

Response

{
  "name": "Demo Store Shopping Agent",
  "description": "AI shopping assistant for Demo Store",
  "version": "1.0.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false
  },
  "skills": [
    { "id": "search_products", "name": "Search Products" },
    { "id": "manage_cart", "name": "Manage Cart" },
    { "id": "checkout", "name": "Checkout" }
  ]
}

GET/api/v1/brand-configRetailer brand configuration — colors, logo, greeting, currency

Request

curl https://demo-agent.nulogic.ai/api/v1/brand-config

Response

{
  "name": "Demo Store",
  "brand_color": "#1B1F5C",
  "logo_url": "/images/logo.png",
  "greeting": "Hello! How can I help you shop today?",
  "country_code": "US",
  "currency": "USD"
}

GET/api/v1/products/searchNatural language product search against the live catalog

Request

curl "https://demo-agent.nulogic.ai/api/v1/products/search?q=blue+jacket&price_max=200"

Response

{
  "query": "blue jacket",
  "count": 12,
  "results": [
    {
      "id": "prod-001",
      "name": "Classic Navy Windbreaker",
      "price": 89.99,
      "image_url": "...",
      "in_stock": true
    }
  ]
}

Using with Claude / MCP

Add this to your Claude Desktop config to use the demo agent as an MCP server:

// ~/.claude/claude_desktop_config.json
{
  "mcpServers": {
    "nulogic-demo": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sse"],
      "env": {
        "SSE_URL": "https://demo-agent.nulogic.ai/mcp/sse"
      }
    }
  }
}