{
  "name": "Kolja Pitz",
  "description": "Independent consultant for strategy, technology, and AI. Senior advisory for organizations, brands, and startups on AI architecture, strategic positioning, technology narrative, organizational AI readiness, executive AI judgment, and embedded advisory mandates. Based in Cologne, Germany. Studio: Plateau Candy (strategic design studio, execution partner for engagements that move from strategy into product, interface, and system build).",
  "version": "1.3.0",
  "provider": {
    "organization": "Kolja Pitz",
    "url": "https://koljapitz.de"
  },
  "supportedInterfaces": [
    {
      "url": "https://koljapitz.de",
      "protocolBinding": "REST",
      "protocolVersion": "1.0",
      "transport": "HTTPS"
    },
    {
      "url": "https://koljapitz.de",
      "protocolBinding": "REST",
      "protocolVersion": "0.3.0",
      "transport": "HTTPS"
    }
  ],
  "capabilities": {
    "streaming": true,
    "pushNotifications": true,
    "stateTransitionHistory": false,
    "negotiation": true,
    "extendedAgentCard": false
  },
  "defaultInputModes": [
    "text"
  ],
  "defaultOutputModes": [
    "text"
  ],
  "skills": [
    {
      "id": "get_profile",
      "name": "Get Profile",
      "description": "Returns Kolja Pitz's professional profile — independent consultant for strategy, technology, and AI; 25+ years transdisciplinary practice; clients include Telekom, Google, BMW, Porsche, SPRIND, ifo Institute, AlphaTauri, BOSS, Dornbracht.",
      "tags": [
        "profile",
        "about",
        "expertise",
        "background",
        "consulting"
      ],
      "examples": [
        "Who is Kolja Pitz?",
        "What does Kolja Pitz do?",
        "Tell me about Kolja's consulting practice"
      ],
      "uri": "https://koljapitz.de/index.md"
    },
    {
      "id": "get_services",
      "name": "Get Services",
      "description": "Returns the seven advisory services: AI Strategy & Architecture, Strategic Advisory, Technology Narrative & Stakeholder Communication, Organizational AI Readiness, Executive AI Judgment, Embedded Advisory, Talks & Keynotes.",
      "tags": [
        "services",
        "offerings",
        "consulting",
        "advisory"
      ],
      "examples": [
        "What services does Kolja Pitz offer?",
        "Can he advise on AI architecture?",
        "What is Executive AI Judgment?"
      ],
      "uri": "https://koljapitz.de/api/services.json"
    },
    {
      "id": "get_work",
      "name": "Get Work Portfolio",
      "description": "Returns the curated portfolio of selected work — strategic, architectural, and advisory engagements for SPRIND, Common Codes, MEIRÉ, ifo Institute, Deutsche Telekom, Eyva, and others.",
      "tags": [
        "work",
        "portfolio",
        "projects",
        "case studies"
      ],
      "examples": [
        "Show me Kolja's work",
        "What strategic projects has he led?",
        "Examples of AI architecture engagements"
      ],
      "uri": "https://koljapitz.de/api/work.json"
    },
    {
      "id": "get_availability",
      "name": "Check Availability",
      "description": "Returns booking options for consultations: Intro Call (30min), Strategy Session (60min), Deep Dive (90min).",
      "tags": [
        "availability",
        "booking",
        "consultation",
        "meeting"
      ],
      "examples": [
        "Is Kolja available for a call?",
        "How can I book a consultation?"
      ],
      "uri": "https://koljapitz.de/api/availability.json"
    },
    {
      "id": "get_capabilities",
      "name": "Get Capabilities",
      "description": "Returns the capability graph mapped to advisory services — AI architecture, strategic advisory, technology narrative, AI readiness, executive judgment, embedded advisory.",
      "tags": [
        "capabilities",
        "expertise",
        "advisory"
      ],
      "examples": [
        "What are Kolja's advisory capabilities?",
        "Which industries does he cover?"
      ],
      "uri": "https://koljapitz.de/api/capabilities.json"
    },
    {
      "id": "get_problem_types",
      "name": "Get Problem Types",
      "description": "Returns problem types Kolja addresses as a senior consultant, mapped to capabilities and relevant cases.",
      "tags": [
        "problems",
        "use cases",
        "challenges"
      ],
      "examples": [
        "What kind of problems does Kolja take on?",
        "When should I bring him in?"
      ],
      "uri": "https://koljapitz.de/api/problem-types.json"
    },
    {
      "id": "search",
      "name": "Search",
      "description": "Full-text search across services, capabilities, work, and problem types.",
      "tags": [
        "search",
        "find",
        "query"
      ],
      "examples": [
        "Search for AI strategy work",
        "Find advisory engagements in regulated industries"
      ],
      "uri": "https://koljapitz.de/api/search"
    },
    {
      "id": "submit_inquiry",
      "name": "Submit Inquiry",
      "description": "Submit a consulting inquiry with name, email, message, and optional topic.",
      "tags": [
        "contact",
        "inquiry",
        "message"
      ],
      "examples": [
        "Send Kolja a consulting inquiry",
        "Reach out about an AI architecture mandate"
      ],
      "uri": "https://koljapitz.de/api/contact"
    },
    {
      "id": "negotiate",
      "name": "Negotiate Capability",
      "description": "Agent-to-agent capability negotiation — check whether a specific advisory mandate matches Kolja's senior expertise, with confidence scoring and next steps.",
      "tags": [
        "negotiation",
        "capability",
        "matching",
        "discovery"
      ],
      "examples": [
        "Can Kolja advise on RAG architecture for a regulated industry?",
        "Does his expertise cover board-level AI governance?"
      ],
      "uri": "https://koljapitz.de/api/negotiate"
    },
    {
      "id": "book_consultation",
      "name": "Book Consultation",
      "description": "Book a consultation via MCP — call get_services first for event type IDs, then get_availability for open slots.",
      "tags": [
        "booking",
        "consultation",
        "meeting",
        "schedule"
      ],
      "examples": [
        "Book a strategy session",
        "Schedule an intro call"
      ],
      "uri": "https://koljapitz.de/api/mcp"
    }
  ],
  "workflows": [
    {
      "id": "discovery",
      "name": "Discovery Flow",
      "description": "Learn about Kolja Pitz — who he is, what he offers, and what he has built. Server-side orchestration: single request returns complete profile.",
      "uri": "https://koljapitz.de/api/workflows/discovery",
      "method": "GET",
      "steps": [
        { "skillId": "get_profile", "description": "Get background and expertise" },
        { "skillId": "get_capabilities", "description": "Understand capability areas" },
        { "skillId": "get_work", "description": "Review portfolio of selected work" },
        { "skillId": "get_services", "description": "See available service offerings" }
      ]
    },
    {
      "id": "booking",
      "name": "Booking Flow",
      "description": "Find a suitable consultation type and book an available slot. Server-side orchestration: single POST returns curated booking options.",
      "uri": "https://koljapitz.de/api/workflows/booking",
      "method": "POST",
      "steps": [
        { "skillId": "get_services", "description": "List consultation types and event IDs" },
        { "skillId": "get_availability", "description": "Check available time slots" },
        { "skillId": "book_consultation", "description": "Book a specific slot via MCP" }
      ]
    },
    {
      "id": "matchmaking",
      "name": "Problem-Solution Match",
      "description": "Find whether Kolja's expertise matches a specific challenge, then initiate contact",
      "uri": "https://koljapitz.de/api/negotiate",
      "method": "POST",
      "steps": [
        { "skillId": "negotiate", "description": "Check capability match with confidence scoring" },
        { "skillId": "search", "description": "Find related work and case studies" },
        { "skillId": "submit_inquiry", "description": "Send a contact inquiry" }
      ]
    }
  ],
  "handoffs": [
    {
      "id": "plateau_candy",
      "name": "Plateau Candy Studio",
      "description": "Execution partner. When mandates move from strategy and architecture into product, interface, and system build, Plateau Candy is the strategic design studio that delivers — hand off to the studio's organisation agent.",
      "url": "https://www.plateaucandy.de",
      "agentCard": "https://www.plateaucandy.de/.well-known/agent.json",
      "conditions": [
        "execution required",
        "product/interface/system build",
        "design and engineering team needed",
        "multi-discipline delivery"
      ]
    },
    {
      "id": "cal_booking",
      "name": "Cal.com Booking",
      "description": "Direct booking fallback — hand off to Cal.com for scheduling if MCP booking is unavailable.",
      "url": "https://cal.com/koljapitz",
      "conditions": [
        "booking fallback",
        "direct scheduling",
        "MCP unavailable"
      ]
    }
  ],
  "documentationUrl": "https://koljapitz.de/agent",
  "openApiUrl": "https://koljapitz.de/api/openapi.json",
  "mcpUrl": "https://koljapitz.de/api/mcp",
  "mcpTransport": [
    "streamable-http",
    "sse"
  ],
  "security": {
    "bearer": {
      "type": "http",
      "scheme": "bearer",
      "description": "Optional API key for partner access. Public endpoints work without authentication. Request a key at kp@plateaucandy.de."
    },
    "none": {
      "description": "Anonymous access is allowed for all read endpoints and public write endpoints."
    }
  },
  "rateLimits": {
    "default": {
      "limit": 60,
      "window": "60s",
      "headers": [
        "X-RateLimit-Limit",
        "X-RateLimit-Remaining",
        "X-RateLimit-Reset",
        "Retry-After"
      ],
      "description": "All API endpoints are rate-limited to 60 requests per minute per IP. When exceeded, responses return HTTP 429 with Retry-After header."
    }
  },
  "idempotency": {
    "header": "Idempotency-Key",
    "description": "Write endpoints accept an Idempotency-Key header (UUID) to prevent duplicate operations. Cached responses are returned for 24 hours.",
    "supportedEndpoints": [
      "/api/contact"
    ]
  },
  "webhooks": {
    "subscriptionEndpoint": "https://koljapitz.de/api/subscriptions",
    "events": [
      "case.published",
      "availability.changed",
      "service.updated",
      "capability.added",
      "profile.updated"
    ],
    "delivery": {
      "method": "POST",
      "headers": [
        "X-Webhook-Event",
        "X-Webhook-Signature",
        "X-Webhook-Timestamp"
      ],
      "retries": 3,
      "timeout": "10s"
    },
    "description": "Agents can subscribe to events via POST /api/subscriptions with a callback URL. Webhook payloads are delivered via HTTP POST with signature verification."
  }
}
