Add tools from an MCP stdio server. Args: command: Command to start the MCP server. env: Optional environment variabl

Reverse the normalization of a tool name. This converts provider-format names back to Arcade's dot notation. Note: This is a best-effort

Get authorization headers for API calls. Args: coordinator_url: Coordinator URL for token refresh (optional for legacy) Returns

Terminate a process with Windows-friendly graceful fallback behavior. On Windows, try ``CTRL_BREAK_EVENT`` first (when supported) so child pr

Load the configuration from the YAML file in the configuration directory. Returns: Config: The loaded configuration.

Parse --output/-o paths into base path and format list. Supports: - Single file with extension: "results.json" → ("results", ["json"]) -

Read the update cache from disk. Returns None if missing or corrupt.

Send a response to a server-initiated request.

Check if a protocol version supports a given feature.

Clean up memory streams for a request.

Create a transport-level error response. The body MUST OMIT the id field entirely — transport errors have no associated request id. Uses a ra

Legacy helper: normalize scope extraction across OAuth provider formats. Retained as a thin shim around the validator's ``_extract_granted_sc

Format a value for display, truncating if too long.

Get configuration overrides from environment variables.

Parses a rate limit header and returns the number of milliseconds until the rate limit resets. Args: headers: A

Run with file watching for auto-reload. This method runs as the parent process that watches for file changes and spawns/rest

Add tools from an Arcade MCP gateway. Args: gateway_slug: The Arcade gateway slug. arcade_api_key: Optional API key.

Add tools from an MCP HTTP server. Args: url: The MCP server URL. headers: Optional HTTP headers. timeout

Convert a Python value to MCP-compatible structured content (JSON object). According to the MCP specification, structuredContent should be a

Convert an MCP tool definition to Anthropic tool format. This is a minimal conversion since Anthropic accepts standard JSON Schema. Chan

Assert the request's resource owner has every required OAuth scope. Reads ``ResourceOwner`` from ``scope[RESOURCE_OWNER_SCOPE_KEY]`` (populat

Expand provider configs into individual ModelSpecs with resolved API keys. Args: configs: List of ProviderConfig from parsed --use-provid

Get the number of tools in the catalog.

Return Windows creation flags to suppress phantom console windows. Args: new_process_group: When true, include ``CREATE_NEW_PROCESS_GROUP

Group comparative results by model, suite, and case name. This allows showing the same case across different tracks side-by-side. Args:

Check if a track exists. Args: name: The track name. Returns: True if track exists, False otherwise.

Check whether a tool name conforms to the MCP name constraints. Rules: 1-128 chars, only ``[A-Za-z0-9_.-]``. This is a MCP SHOULD rule, so we

Create mock results with system_message and additional_messages.

Run the session manager with lifecycle management. This creates and manages the task group for all session operations. Important: Th

Start the transport.

Stop the transport.

Terminate the current session.

Validate the given token against each configured authorization server. Tries each validator until one succeeds. If all fail, raises InvalidTo

Ensure Windows console encoding won't raise UnicodeEncodeError.

Create a mock CaptureResult with multiple runs per case.

Create a mock CaptureResult with track information for testing.

Helper to create a materialized tool with a given output ValueSchema.

Map Google HttpError to appropriate ToolRuntimeError.

Minimal valid ``ResourceServerAuth`` kwargs (no scope arg).

Project list items for the negotiated version. ``strip_fields`` maps each field name to the feature that gates it. Passing a plain li

Strip the 'arcade_' prefix from the name if it exists.

Add or update a tool at runtime if server is bound; otherwise queue via app.add_tool decorator.

Configure Codex CLI to connect to an Arcade Cloud MCP gateway. Writes a ``[mcp_servers.<name>]`` section to ``~/.codex/config.toml``. Codex s

Query PyPI for the latest stable version of the package. Returns None only if the fetch fails or no stable version exists. If ``data["info"][

Find and load as Toolkits all installed packages in the current Python interpreter's environment that either 1. Have a regist

Group evaluation results by model and suite, collecting statistics. This is the shared logic used by all formatters and display functions.

Returns True if the given type is a strict optional type, i.e. a union with exactly two types where one type is None. This covers Optional[T]

Check if usage tracking is enabled via environment variable. Returns: bool: True if tracking is enabled (default), False if explicitly di

Load variables from *path* into os.environ. Args: path: .env file path override: replace existing env vars if True Retu

Parse --api-key value into (provider, key). Args: spec: API key spec string. Format: "provider:key" Examples: "openai:sk-..

Read a response from the server.

Load a Toolkit from a directory.

Track MCP tool call event. Args: success: Whether the tool call succeeded (True) or failed (False) reason: The reason

Truncate long field values for display. Args: value: The string value to potentially truncate. max_length: Maximum allowed l

Wait for the server to become healthy. Args: base_url: Base URL of the server process: The server process timeout: M

Create a JSON response. Inspects JSONRPCError responses for ``_transport`` metadata. When the error code is ``INSUFFICIENT_SCOPE_ERRO

Extract error message and developer details from Microsoft Graph APIError. Microsoft Graph errors always have this structure:

Extract retry-after from Microsoft Graph API errors. Returns milliseconds to wait before retry. Defaults to 1000ms if not fou

Map HTTP status code to appropriate Arcade error.

Open a URL in the default browser without flashing a CMD window on Windows. On Windows, both ``webbrowser.open`` and ``os.startfile`` call ``

Build additional_messages from [(user_msg, tool_name, args_json, response_json)].

Translate ServiceNow HTTP errors into descriptive ValueErrors.

Validate Accept header. Client MUST include Accept header listing both application/json AND text/event-stream. Wildcards satisfy. Returns

Validate that a JSON Schema uses a supported dialect (2020-12). If ``$schema`` is absent, the schema is treated as 2020-12 (valid). If ``$sch

Add all the tools in a module to the catalog. Args: module: The module to add. name: Optionally override the

Check if client has a specific capability. Args: capability: Capability to check Returns: True if c

Configure an MCP client for Arcade toolkits. When *transport* is ``"stdio"`` (default), writes a config that launches ``arcade mcp stdio --to

Create a FastAPI app exposing MCP HTTP endpoints and Arcade Worker endpoints if a secret is provided. MCP is always enabled in this inte

Create a new toolkit from a template with user input.

Auto-detect how the user originally installed the CLI. Detection order: 1. uv tool — check ``uv tool list`` for the package 2. pipx — che

Create a successful result.

Create an Arcade client with proper authentication and org-scoped URL rewriting. Requests are automatically rewritten to include org/project

Get the default model for a provider. Args: provider: The provider to get the default model for. Returns: The default model

Get a valid access token, refreshing if necessary. Returns: Valid access token Raises: ValueError: If not logged in or

Handle incoming HTTP requests.

Whether negotiated version supports a specific feature.

Check if results contain comparative evaluations. Comparative results have a 'track_name' field that indicates they came from a multi-tr

Check if comparative results contain multiple models. Args: results: Nested list of evaluation results. Returns: True i