Tools & MCP Platform — data model

Generated from the architecture model

This page is rendered from model/**/*.yaml by tools/docs_model during mkdocs build. Edit the YAML, not this page; hand-written design lives on the linked service, platform and plane pages.

McpServerRegistryService

erDiagram
    McpServer {
        string serverId PK
        string tenantId
        string name
        enum_McpDirection direction
        enum_McpTransport transport
        string endpointRef
        string commandRef
        enum_McpAuthentication authentication
        string governancePolicyRef
        string protocolVersion
        enum_McpServerState state
        string releaseId
        datetime lastHandshakeAt
        long version
    }
    McpToolBinding {
        string toolName

        hash schemaHash

        string toolId

        string toolVersion

        string declaredClass

        bool bound

    }
    McpResourceBinding {
        string resourceUri

        guid sourceId

        string classification

    }
    McpPromptBinding {
        string promptName

        string skillId

        string workflowStepRef

    }
    McpServer ||--o{ McpToolBinding : contains
    McpServer ||--o{ McpResourceBinding : contains
    McpServer ||--o{ McpPromptBinding : contains

Hold "Alt" / "Option" to enable pan & zoom

McpToolBinding (entity)

A tool the server exposes bound to a Factory tool descriptor.

Field	Type	Required	Description
toolName	string	yes
schemaHash	hash	yes
toolId	string	no
toolVersion	string	no
declaredClass	string	no
bound	bool	yes

McpResourceBinding (entity)

A resource the server exposes mapped to a knowledge source.

Field	Type	Required	Description
resourceUri	string	yes
sourceId	guid	no
classification	string	yes

McpPromptBinding (entity)

A prompt the server exposes mapped to a skill or workflow step.

Field	Type	Required	Description
promptName	string	yes
skillId	string	no
workflowStepRef	string	no

Tables: dbo.McpServers, dbo.McpToolBindings, dbo.McpResourceBindings, dbo.McpPromptBindings — see the DDL appendix.

ToolAdapterService

erDiagram
    ToolDescriptor {
        string toolId PK
        string version
        string releaseId
        string tenantId
        enum_ToolKind kind
        string schemaRef
        string sideEffectClass
        enum_RiskClass riskClass
        json authorization
        list_string secretDependencies
        int timeoutSeconds
        json retryPolicy
        json rateLimits
        json auditRequirements
        enum_SandboxKind sandboxKind
        string mcpServerId
        bool healthy
        bool active
    }
    ToolInvocation {
        guid invocationId PK
        string tenantId
        string projectId
        string environmentId
        guid runId
        guid attemptId
        long fencingToken
        string callerKind
        string toolId
        string toolVersion
        hash requestHash
        string idempotencyKey
        string declaredClass
        string effectiveClass
        guid policyDecisionId
        guid approvalId
        enum_InvocationState state
        guid sandboxLeaseId
        string resultRef
        hash resultHash
        string receiptRef
        string auditRef
        string failureClass
        datetime startedAt
        datetime endedAt
    }
    SandboxLease {
        guid leaseId

        enum_SandboxKind kind

        string poolId

        string workspaceRef

        json limits

        datetime credentialExpiry

        datetime leasedAt

        datetime releasedAt

    }
    ToolInvocation ||--o{ SandboxLease : contains

Hold "Alt" / "Option" to enable pan & zoom

SandboxLease (entity)

A sandbox and workspace leased from Execution Capacity for one invocation (or one attempt when the workspace is shared across calls).

Field	Type	Required	Description
leaseId	guid	yes
kind	enum:SandboxKind	yes
poolId	string	yes
workspaceRef	string	no	Isolated workspace (git worktree or equivalent) per run (original design §34).
limits	json	yes	cpu, memory, gpu, timeout, egress allow-list, read-only mounts
credentialExpiry	datetime	yes
leasedAt	datetime	yes
releasedAt	datetime	no

Tables: dbo.ToolDescriptors, dbo.ToolInvocations, dbo.SandboxLeases — see the DDL appendix.