Execute a Python script with automatic dependency management.

The script can include PEP 723 inline metadata (# /// script blocks) for declaring dependencies. Additional dependencies can also be passed via the dependencies parameter and will be merged.

Args: script: Python source code to execute. May include PEP 723 metadata. dependencies: Extra PEP 508 dependency specifiers to make available. timeout_seconds: Maximum execution time (1-300, default 30).

Returns: Formatted output with stdout, stderr, exit code, and duration.

Example - simple script:

execute_python(script="print('hello')")

Example - with dependencies parameter:

execute_python(
    script="import requests; print(requests.get('https://example.com').status_code)",
    dependencies=["requests>=2.32"]
)

Example - with inline dependency metadata (preferred for multiple deps):

execute_python(script='''
# /// script
# dependencies = ["pandas>=2.2", "numpy>=1.26"]
# ///

import pandas as pd
import numpy as np
print(pd.DataFrame({"a": np.arange(5)}).describe())
''')

Always pin dependency versions (e.g. "pandas>=2.2" instead of "pandas") for reproducible results.

The inline metadata block (# /// script ... # ///) is the recommended way to declare dependencies directly in the script (see PEP 723: https://peps.python.org/pep-0723/). The dependencies parameter is a simpler alternative when you just need to add a few packages. Both accept standard pip-style version specifiers like "requests>=2.28" or "pandas" (see PEP 508: https://peps.python.org/pep-0508/).

Check the execution environment and report status.

Returns information about Python version, uv version, platform, sandbox configuration, and cache status.

Validate a Python script's PEP 723 metadata and dependencies without executing it.

Checks metadata syntax, dependency format, and requires-python compatibility.

Args: script: Python source code to validate. May include inline dependency metadata (# /// script blocks, see https://peps.python.org/pep-0723/). dependencies: Extra dependency specifiers to validate, using standard pip-style format like "requests>=2.28" (see https://peps.python.org/pep-0508/).

Returns: Validation result with metadata details or error information.