Skip to main content
Provider descriptors — declarative shape of a supported third-party. Pure pydantic models describing a provider, its sub-services, MCP server endpoints, OAuth endpoints, and client-supplied config fields. Descriptors are validated when built so a misconfigured provider fails loudly rather than at first user click. Every model refuses an unknown key (extra="forbid"), naming it, so a misspelled field fails loudly instead of being dropped.

SLUG_RE

tai42_contract.connectors.providers.SLUG_RE

McpServerDescriptor

tai42_contract.connectors.providers.McpServerDescriptor
MCP server endpoint for one sub-service. Transport is either http (hosted out-of-band, set url) or stdio (launched as a child process, set command + args). Exactly one configuration is allowed: url xor (command + args). Attributes

Members

model_post_init

tai42_contract.connectors.providers.McpServerDescriptor.model_post_init
Enforce the transport rule: url for http, command + args for stdio. Parameters

ConfigFieldSpec

tai42_contract.connectors.providers.ConfigFieldSpec
One client-supplied static config value for a no-auth provider. target picks the injection channel and MUST match the server transport (env for stdio, header for http). secret flags a value masked in the UI and never logged; required gates connect-time validation. Attributes

SubServiceDescriptor

tai42_contract.connectors.providers.SubServiceDescriptor
One sub-service a provider exposes, with its scopes and a single launch path. Attributes

OAuthEndpoints

tai42_contract.connectors.providers.OAuthEndpoints
The OAuth endpoint URLs of a DECLARED provider: authorize, token exchange, and optional revoke. A provider that carries this block is in declared mode (fixed endpoints, an env client, no discovery); a kind == "oauth" provider without it is in discovered mode, where the engine reads the endpoints from the authorization server its MCP server names. Attributes

ProviderDescriptor

tai42_contract.connectors.providers.ProviderDescriptor
The universal connector-provider contract, registered from the manifest connectors list at boot/reload. A kind == "oauth" provider is in exactly one of two modes. Declared: oauth carries the endpoints and client_id_env / client_secret_env name the operator’s client. Discovered: oauth is unset and the engine discovers the authorization server from the one MCP server all sub-services share; the client is either the env client pinned by issuer to the authorization server it is registered with, or (all three unset) a stored client. Attributes

Members

icon_url

tai42_contract.connectors.providers.ProviderDescriptor.icon_url
An https:// URL to the provider’s icon, or None for none; http, relative, or empty is rejected. The catalog serves this value verbatim as a brand mark, the same rule the plugin spec’s icon enforces.

is_discovered

tai42_contract.connectors.providers.ProviderDescriptor.is_discovered
Whether this is an OAuth provider in discovered mode (no declared oauth endpoints).

discovery_url

tai42_contract.connectors.providers.ProviderDescriptor.discovery_url
The one MCP server URL every sub-service of a discovered provider shares. Raises RuntimeError for a declared or no-auth provider (a caller bug: only a discovered provider is discovered).