Settings

Global configuration and environment-driven settings.

MCPSettings

Python


arcade_mcp_server.settings.MCPSettings

Main settings container.

Bases: BaseSettings

from_env()

Python


from_env() classmethod

Create settings from environment variables.

to_dict()

Python


to_dict()

Convert settings to dictionary.

tool_secrets()

Python


tool_secrets()

Get secrets.

Sub-settings

ServerSettings

Python


arcade_mcp_server.settings.ServerSettings

Server-related settings.

Bases: BaseSettings

MiddlewareSettings

Python


arcade_mcp_server.settings.MiddlewareSettings

Middleware-related settings.

Bases: BaseSettings

validate_log_level()

Python


validate_log_level(v) classmethod

Validate log level.

NotificationSettings

Python


arcade_mcp_server.settings.NotificationSettings

Notification-related settings.

Bases: BaseSettings

TransportSettings

Python


arcade_mcp_server.settings.TransportSettings

Transport-related settings.

Bases: BaseSettings

ArcadeSettings

Python


arcade_mcp_server.settings.ArcadeSettings

Arcade-specific settings.

Bases: BaseSettings

ToolEnvironmentSettings

Python


arcade_mcp_server.settings.ToolEnvironmentSettings

environment settings.

Bases: BaseSettings

Every environment variable that is not prefixed with one of the prefixes for the other settings will be added to the environment as an available tool secret in the ToolContext.

model_post_init()

Python


model_post_init(__context)

Populate tool_environment from process env if not provided.

Examples

Basic configuration

Python


from arcade_mcp_server.settings import MCPSettings
 
settings = MCPSettings(
    debug=True,
    middleware=MCPSettings.middleware.__class__(
        enable_logging=True,
        mask_error_details=False,
    ),
    server=MCPSettings.server.__class__(
        title="My MCP Server",
        instructions="Use responsibly",
    ),
    transport=MCPSettings.transport.__class__(
        http_host="0.0.0.0",
        http_port=8000,
    ),
)

Loading from environment

Python


from arcade_mcp_server.settings import MCPSettings
 
# Values like ARCADE_MCP_DEBUG, ARCADE_MCP_HTTP_PORT, etc. are parsed
settings = MCPSettings()