For AI agents: The documentation index is at https://docs.digitalocean.com/llms.txt. Markdown versions of pages use the same URL with index.html.md in place of the HTML page (for example, append index.html.md to the directory path instead of opening the HTML document).

A Toolbelt is a versioned collection of Action Gateway tools. Select a specific Toolbelt version to reuse its member selection across sessions. Publishing a later Toolbelt version does not change that selection in existing sessions.

Select a Toolbelt when creating an Action Gateway session. For a managed environment spec, see Connect Action Gateway to Harness Runtime.

Prerequisites

• Access to Action Gateway for your DigitalOcean team.
• A DigitalOcean personal access token authorized for Action Gateway if you use the SDK. Keep it in your local DIGITALOCEAN_TOKEN environment variable.

Creating a Toolbelt does not run its tools. Some member tools, including Exa web search and web fetch, require a positive prepaid balance when you invoke them.

Create a Toolbelt Using the Python SDK

Install PyDo:

pip install pydo

In a local Python interpreter, create a Toolbelt containing the search and fetch tools. The example prints its versioned reference:

import os

from pydo.action_gateway import ActionGatewayClient

ag_client = ActionGatewayClient(token=os.environ["DIGITALOCEAN_TOKEN"])

toolbelt = ag_client.create_toolbelt(
    name="search_toolbelt",
    tools=[
        "exa_web_search",
        "exa_web_fetch",
    ],
)

print(toolbelt.ref)

Continue in the same Python interpreter to select the returned Toolbelt version in a session. Replace <actor-id> with the actor whose provider connections the session should use:

session = ag_client.session.create(
    actor_id="<actor-id>",
    tools=[toolbelt.ref],
    permissions={
        "default_action": "deny",
        "rules": [
            {"tool": "action_search", "action": "allow"},
            {"tool": "action_invoke", "action": "allow"},
            {"tool": toolbelt.ref, "action": "allow"},
        ],
    },
)

print(session.url)

The example prints the session’s MCP URL without making a model request or invoking a tool. Connect an MCP client to use the Toolbelt’s member tools under this policy.

Create a Toolbelt Using the Control Panel

1. In the Control Panel, go to Managed Agents, and click Action Gateway.
2. In the Toolbelts tab, click Create a toolbelt in the top right corner.
3. Name the toolbelt, add a description, and select the tools you want to include.
4. Click Create Toolbelt.

The toolbelt appears in the Toolbelts tab.