MCP

The MCP (Model Context Protocol) configuration is loaded into the agent sandbox and available during task execution. This allows the agent to use specialized tools and access external data sources through MCP servers.

Configuration

MCP servers are configured in your MCP configuration file. The configuration is loaded when the sandbox starts and remains available throughout task execution.

Example configuration

{
  "mcpServers": {
    "aws-knowledge-mcp-server": {
      "command": "uvx",
      "args": [
        "fastmcp",
        "run",
        "https://knowledge-mcp.global.api.aws"
      ],
      "env": {}
    }
  }
}

Supported servers

Only local MCP servers are currently supported. Remote MCP servers are not available at this time.

Using environment variables and secrets

You can reference environment variables and secrets in your MCP configuration to securely pass credentials and configuration values to MCP servers.

Use the ${key_name} syntax to reference the key names of your environment variables and secrets in the server configuration:

{
  "mcpServers": {
    "server-name": {
      "command": "executable",
      "args": ["arg1", "arg2"],
      "env": {
        "ENV_VAR_KEY": "${my_env_var_key}",
        "SECRET_KEY": "${my_secret_key}"
      }
    }
  }
}

Both environment variables and secrets use the same syntax. The values are resolved when the sandbox starts.