{
  "name": "Plateau Candy — API Directory",
  "description": "Machine-readable endpoints for AI agents and integrations.",
  "version": "1.1",
  "schema_version": "2025-03",
  "last_updated": "2026-05-02",
  "baseUrl": "https://www.plateaucandy.de",
  "endpoints": {
    "services": {
      "url": "/api/services",
      "description": "Schema.org OfferCatalog of all services",
      "format": "application/ld+json"
    },
    "work": {
      "url": "/api/work",
      "description": "Schema.org ItemList of all portfolio case studies",
      "format": "application/ld+json"
    },
    "search": {
      "url": "/api/search",
      "description": "Search and filter portfolio by keyword, tag, or client",
      "format": "application/json",
      "parameters": [
        "q",
        "tag",
        "client",
        "lang"
      ]
    },
    "openapi": {
      "url": "/api/openapi.json",
      "description": "OpenAPI 3.1 specification for all endpoints",
      "format": "application/json"
    },
    "negotiate": {
      "url": "/api/negotiate.json",
      "description": "Agent negotiation: check project fit, capacity, and expertise",
      "format": "application/json",
      "method": "POST"
    },
    "briefing": {
      "url": "/api/briefing",
      "description": "Submit a project briefing (POST)",
      "format": "application/json",
      "method": "POST"
    },
    "inquiry": {
      "url": "/api/inquiry",
      "description": "Submit a general inquiry (POST)",
      "format": "application/json",
      "method": "POST"
    },
    "subscribe": {
      "url": "/api/subscribe",
      "description": "Topic-based subscription API for agents",
      "format": "application/json",
      "method": "POST"
    },
    "webhooks": {
      "url": "/api/webhooks/register",
      "description": "Webhook registration (requires Bearer auth)",
      "format": "application/json",
      "method": "POST",
      "auth": "bearer"
    },
    "feed": {
      "url": "/api/feed.xml",
      "description": "Atom feed with latest case studies and updates",
      "format": "application/atom+xml"
    }
  },
  "workflows": {
    "discovery": {
      "url": "/api/workflows/discovery.json",
      "description": "Server-side: profile + capabilities + work + services in 1 request",
      "method": "GET"
    },
    "booking": {
      "url": "/api/workflows/booking.json",
      "description": "Server-side: event types + slots + curated options in 1 request",
      "method": "POST"
    },
    "matching": {
      "url": "/api/workflows/matching.json",
      "description": "Server-side: problem → capability match → similar work → contact",
      "method": "POST"
    }
  },
  "research": {
    "agent_readiness_whitepaper": {
      "url": "/downloads/Agent-Readiness-EN.pdf",
      "description": "How to prepare brands and organizations for the agentic web — strategic framework, readiness assessment, and implementation guide.",
      "format": "application/pdf"
    }
  },
  "documentation": {
    "agent_docs": "/agent",
    "description": "How AI agents can interact with Plateau Candy — endpoints, contact, problem types, FAQ"
  },
  "mcp": {
    "url": "/api/mcp",
    "description": "Model Context Protocol endpoint (Streamable HTTP, SSE enabled)",
    "transport": [
      "streamable-http",
      "sse"
    ],
    "tools": [
      "get_profile",
      "get_services",
      "get_availability",
      "book_consultation",
      "get_capabilities"
    ]
  },
  "discovery": {
    "llms_txt": "/llms.txt",
    "llms_full_txt": "/llms-full.txt",
    "sitemap": "/sitemap.xml",
    "robots": "/robots.txt",
    "agent_card": "/.well-known/agent.json",
    "agent_card_legacy": "/.well-known/agent-card.json",
    "openapi": "/api/openapi.json",
    "mcp": "/api/mcp"
  },
  "contact": {
    "email": "hi@plateaucandy.de",
    "phone": "+49 221 57770 500",
    "booking": "https://www.cal.eu/plateaucandy",
    "website": "https://www.plateaucandy.de"
  },
  "capabilities": [
    "AI Architecture",
    "Strategic Systems Design",
    "Digital Identity Infrastructure",
    "Interactive Installations",
    "Strategic Communication",
    "Brand & Product Strategy",
    "Data Visualization & Generative Art",
    "Prototyping & Product Development",
    "IoT & Connected Products",
    "Web3 & Generative Platforms",
    "App Development",
    "3D & Motion Design",
    "Digital Art Curation",
    "Website Systems",
    "Agent-First Web Architecture"
  ],
  "structuredData": {
    "note": "Every page includes JSON-LD with Organization, WebSite, WebPage, ProfessionalService, and Person schemas."
  }
}