{
  "name": "Plateau Candy",
  "description": "Studio for emerging technologies in Cologne, Germany. We bring deep understanding of emerging technologies into strategy, design and code, creating prototypes, interfaces, websites, AI tools and products. Expertise in agent readiness, AI strategy, enterprise design, and digital identity.",
  "version": "2.1.0",
  "provider": {
    "organization": "Plateau Candy GmbH & Co. KG",
    "url": "https://www.plateaucandy.de"
  },
  "privacyPolicyUrl": "https://www.plateaucandy.de/en/datenschutz",
  "imprintUrl": "https://www.plateaucandy.de/en/impressum",
  "supportedInterfaces": [
    {
      "url": "https://www.plateaucandy.de",
      "protocolBinding": "REST",
      "protocolVersion": "1.0",
      "transport": "HTTPS"
    },
    {
      "url": "https://www.plateaucandy.de",
      "protocolBinding": "REST",
      "protocolVersion": "0.3.0",
      "transport": "HTTPS"
    }
  ],
  "capabilities": {
    "streaming": true,
    "pushNotifications": true,
    "negotiation": true,
    "extendedAgentCard": false,
    "rateLimiting": {
      "limits": {
        "public-read": "60 requests per minute",
        "public-write": "10 requests per minute",
        "authenticated": "120 requests per minute"
      },
      "headers": [
        "X-RateLimit-Limit",
        "X-RateLimit-Remaining",
        "X-RateLimit-Reset",
        "Retry-After"
      ],
      "onExceeded": "429 Too Many Requests with Retry-After header indicating seconds until reset"
    }
  },
  "mcpUrl": "https://www.plateaucandy.de/api/mcp",
  "mcpTransport": [
    "streamable-http",
    "sse"
  ],
  "defaultInputModes": [
    "text"
  ],
  "defaultOutputModes": [
    "text"
  ],
  "authentication": {
    "schemes": [
      "bearer"
    ],
    "description": "Public endpoints require no auth. Partner agencies can request API keys via hi@plateaucandy.de for access to protected endpoints.",
    "publicEndpoints": [
      "/api/services",
      "/api/work",
      "/api/search",
      "/api/directory",
      "/api/negotiate.json",
      "/api/inquiry",
      "/api/briefing"
    ],
    "protectedEndpoints": [
      "/api/webhooks/register"
    ]
  },
  "idempotency": {
    "header": "Idempotency-Key",
    "supportedEndpoints": [
      "/api/briefing",
      "/api/inquiry",
      "/api/subscribe"
    ]
  },
  "skills": [
    {
      "id": "get_services",
      "name": "Get Services",
      "description": "Returns available services: agent readiness, AI strategy & consulting, enterprise interface design, prototyping, web development, AI tool development",
      "uri": "https://www.plateaucandy.de/api/services",
      "tags": [
        "services",
        "offerings"
      ]
    },
    {
      "id": "get_work",
      "name": "Get Work Portfolio",
      "description": "Returns portfolio of selected projects for SPRIND, Deutsche Telekom, Google, BMW, eyva.ai, and more",
      "uri": "https://www.plateaucandy.de/api/work",
      "tags": [
        "work",
        "portfolio",
        "projects"
      ]
    },
    {
      "id": "search_work",
      "name": "Search Portfolio",
      "description": "Search and filter portfolio by keyword, tag, client, or language",
      "uri": "https://www.plateaucandy.de/api/search",
      "tags": [
        "search",
        "filter"
      ]
    },
    {
      "id": "get_availability",
      "name": "Book Consultation",
      "description": "Booking options for consultations and project discussions via Cal.com",
      "uri": "https://www.cal.eu/plateaucandy",
      "tags": [
        "booking",
        "consultation",
        "contact"
      ]
    },
    {
      "id": "check_project_fit",
      "name": "Check Project Fit",
      "description": "Agent negotiation. GET ?query=… or POST {query}. Returns a fit_score (0–100), ranked matching_experience with proof (role, outcome, relevance), the relevant_team (roles + principal + 80+ specialist network), and current capacity.",
      "uri": "https://www.plateaucandy.de/api/negotiate.json",
      "tags": [
        "negotiation",
        "capacity",
        "matching",
        "fit"
      ]
    },
    {
      "id": "get_capacity",
      "name": "Get Capacity",
      "description": "Forward capacity signal: availability, start lead time, scalable team size (2–20), and the 80+ specialist network (via co-founder MEIRÉ) that backs near-immediate project starts.",
      "uri": "https://www.plateaucandy.de/api/capacity.json",
      "tags": [
        "capacity",
        "availability",
        "team"
      ]
    },
    {
      "id": "submit_briefing",
      "name": "Submit Project Briefing",
      "description": "Submit a project briefing via API (POST). Include project_type, brief, and email.",
      "uri": "https://www.plateaucandy.de/api/briefing",
      "tags": [
        "write",
        "briefing",
        "contact"
      ]
    },
    {
      "id": "submit_inquiry",
      "name": "Submit Inquiry",
      "description": "Submit a general inquiry (POST). Include name, email, and message.",
      "uri": "https://www.plateaucandy.de/api/inquiry",
      "tags": [
        "write",
        "inquiry",
        "contact"
      ]
    },
    {
      "id": "subscribe",
      "name": "Subscribe to Updates",
      "description": "Subscribe to topic-based updates (POST). Agents register for themes like 'AI Architecture' or 'Brand Systems'.",
      "uri": "https://www.plateaucandy.de/api/subscribe",
      "tags": [
        "subscription",
        "updates"
      ]
    }
  ],
  "workflows": [
    {
      "id": "discovery",
      "name": "Service Discovery",
      "uri": "https://www.plateaucandy.de/api/workflows/discovery.json",
      "steps": [
        {
          "skillId": "get_services",
          "description": "List available services"
        },
        {
          "skillId": "search_work",
          "description": "Find relevant case studies"
        },
        {
          "skillId": "get_availability",
          "description": "Check consultation slots"
        }
      ]
    },
    {
      "id": "booking",
      "name": "Booking Flow",
      "uri": "https://www.plateaucandy.de/api/workflows/booking.json",
      "steps": [
        {
          "skillId": "get_services",
          "description": "List consultation types"
        },
        {
          "skillId": "get_availability",
          "description": "Check open slots"
        },
        {
          "skillId": "get_availability",
          "description": "Book consultation"
        }
      ]
    },
    {
      "id": "matching",
      "name": "Problem-Solution Matching",
      "uri": "https://www.plateaucandy.de/api/workflows/matching.json",
      "steps": [
        {
          "skillId": "check_project_fit",
          "description": "Match problem to capabilities"
        },
        {
          "skillId": "search_work",
          "description": "Find similar past projects"
        },
        {
          "skillId": "submit_inquiry",
          "description": "Submit inquiry"
        }
      ]
    }
  ],
  "handoffs": [
    {
      "id": "kolja_pitz",
      "name": "Kolja Pitz (Personal Consulting)",
      "agentCard": "https://koljapitz.de/.well-known/agent.json",
      "conditions": [
        "personal consulting",
        "keynote speaking",
        "advisory"
      ]
    },
    {
      "id": "meire_und_meire",
      "name": "Meiré und Meiré (Extended Team)",
      "url": "https://www.meireundmeire.de",
      "conditions": [
        "large-scale branding",
        "80+ team engagement",
        "enterprise design"
      ]
    },
    {
      "id": "cal_booking",
      "name": "Cal.com Booking",
      "url": "https://www.cal.eu/plateaucandy",
      "conditions": [
        "booking fallback",
        "direct scheduling"
      ]
    }
  ],
  "surfaces": [
    {
      "type": "mcp",
      "url": "https://www.plateaucandy.de/api/mcp",
      "transport": "streamable-http",
      "protocolVersion": "2025-03-26"
    },
    {
      "type": "openapi",
      "url": "https://www.plateaucandy.de/api/openapi.json",
      "version": "3.1.0"
    },
    {
      "type": "rest",
      "url": "https://www.plateaucandy.de/api/directory",
      "description": "Plain REST endpoints listed in the API directory."
    },
    {
      "type": "markdown",
      "url": "https://www.plateaucandy.de/api/markdown",
      "description": "Markdown content negotiation for agent-friendly reading."
    }
  ],
  "security": {
    "none": {},
    "bearer": {
      "description": "API key for partner agencies. Contact hi@plateaucandy.de"
    }
  }
}