{
    "schemaVersion": "1.0.0",
    "name": "IT-Tremmel GmbH — SaaS / ERP & MiniApps",
    "description": "Business software platform: ERP modules, MiniApps, accommodation, portals and integrations.",
    "provider": {
        "name": "IT-Tremmel GmbH",
        "url": "https://www.alpha.it-tremmel.de"
    },
    "sources": [
        {
            "id": "public-openapi",
            "type": "openapi",
            "url": "https://www.alpha.it-tremmel.de/api/openapi.json",
            "documentation": "https://www.alpha.it-tremmel.de/api/docs",
            "description": "Compiled aggregate OpenAPI spec — the authoritative endpoint contract."
        }
    ],
    "authentication": {
        "standard": "AgentAuth",
        "type": "bearer",
        "specification": "https://www.alpha.it-tremmel.de/.well-known/auth.md",
        "tokenIssuance": {
            "description": "Scoped bearer token; shown once, stored as a bcrypt hash. Two ways to obtain one: self-service purchase (below) or out-of-band issuance by a tenant admin. See auth.md.",
            "selfService": {
                "mode": "self-service",
                "order": "https://www.alpha.it-tremmel.de/api/agent-auth/self-service/orders",
                "issue": "https://www.alpha.it-tremmel.de/api/agent-auth/self-service/orders/{id}/issue",
                "access_status": "https://www.alpha.it-tremmel.de/api/agent-auth/self-service/access-status",
                "price_minor": 500,
                "currency": "EUR",
                "period_days": 21,
                "auto_renew": false,
                "scopes": [
                    "communication:chat",
                    "search:read",
                    "erp:read",
                    "erp:write",
                    "reports:run",
                    "audit:read",
                    "commerce:order",
                    "timetracking:read",
                    "pii.pseudonymized:read"
                ],
                "headers": {
                    "X-Tenant-Id": "must equal body.tenant_id",
                    "Idempotency-Key": "required, <= 191 chars"
                },
                "flow": [
                    "POST order {tenant_id, agent_id, name?, scopes[]} -> 201 {order_id, claim_token, amount_minor_units, currency}",
                    "settle a tenant-bound payment of exactly amount_minor_units (payment_transaction_id)",
                    "POST issue {tenant_id, claim_token, payment_transaction_id} -> 201 {token, expires_at}; the token is shown once"
                ],
                "sandbox": "https://www.alpha.it-tremmel.de/api/sandbox/provision"
            },
            "adminIssued": "https://www.alpha.it-tremmel.de/api/agent-auth/tokens",
            "oauth2": {
                "authorizationServerMetadata": "https://www.alpha.it-tremmel.de/.well-known/oauth-authorization-server",
                "protectedResourceMetadata": "https://www.alpha.it-tremmel.de/.well-known/oauth-protected-resource",
                "tokenEndpoint": "https://www.alpha.it-tremmel.de/api/oauth/token",
                "revocationEndpoint": "https://www.alpha.it-tremmel.de/api/oauth/revoke",
                "grantTypes": [
                    "client_credentials"
                ]
            }
        },
        "scopes": [
            "communication:chat",
            "search:read",
            "erp:read",
            "erp:write",
            "reports:run",
            "audit:read",
            "commerce:order",
            "timetracking:read",
            "pii.pseudonymized:read"
        ]
    },
    "pricing": {
        "catalogue": "https://www.alpha.it-tremmel.de/api/docs/pricing",
        "currency": "EUR",
        "unit": "request",
        "money": "integer minor units",
        "quota": "https://www.alpha.it-tremmel.de/api/agent-auth/self-service/usage",
        "storefront": "https://www.alpha.it-tremmel.de/api/agents/catalog",
        "spec_extension": "x-itt-pricing",
        "capabilities": [
            {
                "capability": "api.read",
                "unit_price_minor": 10,
                "currency": "EUR",
                "unit": "request",
                "label": {
                    "de": "API-Lesezugriff",
                    "en": "API read access",
                    "es": "Acceso de lectura API"
                }
            },
            {
                "capability": "api.write",
                "unit_price_minor": 50,
                "currency": "EUR",
                "unit": "request",
                "label": {
                    "de": "API-Schreibzugriff",
                    "en": "API write access",
                    "es": "Acceso de escritura API"
                }
            },
            {
                "capability": "ai.inference",
                "unit_price_minor": 100,
                "currency": "EUR",
                "unit": "request",
                "label": {
                    "de": "KI-Inferenz",
                    "en": "AI inference",
                    "es": "Inferencia de IA"
                }
            },
            {
                "capability": "capability.invoke",
                "unit_price_minor": 25,
                "currency": "EUR",
                "unit": "request",
                "label": {
                    "de": "Fähigkeit ausführen",
                    "en": "Capability invocation",
                    "es": "Invocación de capacidad"
                }
            },
            {
                "capability": "document.generate",
                "unit_price_minor": 200,
                "currency": "EUR",
                "unit": "request",
                "label": {
                    "de": "Dokument erzeugen",
                    "en": "Document generation",
                    "es": "Generación de documentos"
                }
            },
            {
                "capability": "communication.chat_prepaid",
                "unit_price_minor": 5,
                "currency": "EUR",
                "unit": "request",
                "label": {
                    "de": "Prepaid-Agentenfrage",
                    "en": "Prepaid agent question",
                    "es": "Pregunta de agente prepago"
                }
            },
            {
                "capability": "communication.read",
                "unit_price_minor": 0,
                "currency": "EUR",
                "unit": "request",
                "label": {
                    "de": "Guthaben und eigene Chat-Antwort",
                    "en": "Balance and own chat answer",
                    "es": "Saldo y respuesta propia"
                }
            }
        ]
    },
    "capabilities": [
        {
            "scope": "communication:chat",
            "description": "communication:chat"
        },
        {
            "scope": "search:read",
            "description": "Read the public discovery surface (/.well-known, llms.txt, catalog)."
        },
        {
            "scope": "erp:read",
            "description": "Read ERP module data (lists, detail views, exports)."
        },
        {
            "scope": "erp:write",
            "description": "Create and update ERP records (CRUD writes)."
        },
        {
            "scope": "reports:run",
            "description": "Execute reporting and analytics jobs."
        },
        {
            "scope": "audit:read",
            "description": "Read the agent audit log."
        },
        {
            "scope": "commerce:order",
            "description": "Complete ACP checkout sessions into orders / booking offers (see /.well-known/payments.json)."
        },
        {
            "scope": "timetracking:read",
            "description": "timetracking:read"
        },
        {
            "scope": "pii.pseudonymized:read",
            "description": "pii.pseudonymized:read"
        }
    ],
    "mcp": {
        "transport": "streamable-http",
        "url": "https://www.alpha.it-tremmel.de/api/mcp",
        "protocolVersion": "2025-06-18",
        "authentication": {
            "type": "bearer",
            "standard": "AgentAuth",
            "hint": "Authorization: Bearer itt_agt_… (scoped agent token, see auth.md; sessions are not accepted)",
            "specification": "https://www.alpha.it-tremmel.de/.well-known/auth.md"
        },
        "authorization": {
            "type": "oauth2",
            "specification": "MCP authorization 2025-06-18 (RFC 9728 + RFC 8414)",
            "required": true,
            "appliesTo": "https://www.alpha.it-tremmel.de/api/mcp",
            "protectedResourceMetadata": "https://www.alpha.it-tremmel.de/.well-known/oauth-protected-resource",
            "authorizationServerMetadata": "https://www.alpha.it-tremmel.de/.well-known/oauth-authorization-server",
            "authorizationServers": [
                "https://www.alpha.it-tremmel.de"
            ],
            "grantTypes": [
                "client_credentials"
            ],
            "tokenEndpoint": "https://www.alpha.it-tremmel.de/api/oauth/token"
        },
        "x-mcp-status": "read-only"
    },
    "steering": {
        "status": "ui-affordance",
        "hosts": "Phase-one steering hosts only (localhost / beta.* / *.local / first-party desktop shells), authenticated session required.",
        "pageManifest": {
            "windowGetter": "__ITT_STEERING_MANIFEST__",
            "domIsland": "#itt-steering-manifest",
            "description": "Per-route manifest of the steering commands available on the CURRENT page (module ids, command ids, localized titles, parameter schemas, availability). Call window.__ITT_STEERING_MANIFEST__() or read the JSON <script> island."
        },
        "domAttributes": {
            "command": "data-steer-command",
            "fixedParams": "data-steer-params",
            "description": "Interactive elements bound to a registered steering command carry data-steer-command=\"<moduleId>.<commandId>\" (plus data-steer-params JSON when the command has fixed parameter defaults). Elements are also addressable by data-testid for envelope click/fill actions."
        },
        "envelope": {
            "format": "RemoteSteeringEnvelope { id: string, action: string, args: object }",
            "allowedActions": [
                "navigate",
                "click",
                "fill",
                "waitFor",
                "speak",
                "highlight",
                "spotlight",
                "tour"
            ],
            "maxSteps": 30,
            "validator": "Server: App\\Service\\SteeringScriptValidator; UI mirror: GENERATED_SCRIPT_ALLOWED_ACTIONS (generatedScriptValidation.ts)."
        },
        "sessionApi": {
            "url": "https://www.alpha.it-tremmel.de/api/remote-steering",
            "note": "Remote-steering sessions are consent-gated in-app; commands are delivered over /api/remote-steering/events (SSE) and executed by the same registry."
        }
    },
    "realtime": {
        "status": "session-auth",
        "note": "Tenant-scoped event bus for entity changes, job progress and stats. Resume with Last-Event-ID (SSE) or ?cursor=N (delta); filter with ?channels=notifications,jobs,stats.",
        "sse": {
            "url": "https://www.alpha.it-tremmel.de/api/realtime/events",
            "transport": "text/event-stream",
            "resume": "Last-Event-ID header",
            "filter": "?channels=notifications,jobs,stats",
            "tokenExchange": "https://www.alpha.it-tremmel.de/api/realtime/sse-token"
        },
        "websocket": {
            "path": "/realtime",
            "note": "WebSocket twin of the same sse_events bus (App\\WebSocket\\RealtimeEventsServer)."
        },
        "delta": {
            "url": "https://www.alpha.it-tremmel.de/api/realtime/delta",
            "note": "FPM-safe short-poll: events-since-cursor with 304/ETag no-change semantics.",
            "resume": "?cursor=N (or If-None-Match: \"delta-N\")"
        }
    },
    "discovery": {
        "llmsTxt": "https://www.alpha.it-tremmel.de/llms.txt",
        "llmsFullTxt": "https://www.alpha.it-tremmel.de/llms-full.txt",
        "openapi": "https://www.alpha.it-tremmel.de/api/openapi.json",
        "auth": "https://www.alpha.it-tremmel.de/.well-known/auth.md",
        "securityContact": "https://www.alpha.it-tremmel.de/.well-known/security.txt",
        "a2aAgentCard": "https://www.alpha.it-tremmel.de/.well-known/agent-card.json",
        "mcp": "https://www.alpha.it-tremmel.de/.well-known/mcp.json",
        "payments": "https://www.alpha.it-tremmel.de/.well-known/payments.json",
        "ucp": "https://www.alpha.it-tremmel.de/.well-known/ucp",
        "productFeed": "https://www.alpha.it-tremmel.de/api/acp/product-feed",
        "pricing": "https://www.alpha.it-tremmel.de/api/docs/pricing",
        "aiPlugin": "https://www.alpha.it-tremmel.de/.well-known/ai-plugin.json",
        "chatgptApp": "https://www.alpha.it-tremmel.de/.well-known/ai-plugin.json"
    }
}