---
title: pydo.users
description: |
    Action Gateway gives AI agents governed access to tools over the Model Context Protocol (MCP).
product: Reference
url: https://docs.digitalocean.com/reference/pydo/reference/users/
last_updated: "2026-10-16"
---

> **For AI agents:** The documentation index is at [https://docs.digitalocean.com/llms.txt](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).

# pydo.users

Generated on 16 Oct 2026 from `pydo` version [`v0.44.0`](https://github.com/digitalocean/pydo/releases/tag/v0.44.0v0.44.0)

Action Gateway gives AI agents governed access to tools over the Model Context Protocol (MCP).

The `/v2/action-gateway` endpoints manage the tool catalog and the resources that control how agents use it:

- **Tools** browse and search the catalog, its providers, and global provider and tool health.
- **Toolbelts** are versioned, team-owned sets of tools that sessions and policies reference as `toolbelt:<name>@<version>`.
- **Output views** reshape a tool’s output before it reaches the agent.
- **MCP servers** register your own remote MCP servers and choose which of their tools to enable.
- **Connections** authorize one of your end users to use a provider’s tools, for example through OAuth.
- **Sessions** bind a tool selection and permission policy to an MCP URL that an agent connects to.
- **Users** and **end user limits** show and limit activity per end user, identified by a session’s `actorId`.

To find and call tools in a session, use the [Action Gateway Data Plane](#tag/Action-Gateway-Data-Plane) endpoints or connect an MCP client to the session’s `mcpUrl`.

[pydo.users.get()](https://docs.digitalocean.com/reference/pydo/reference/users/get/index.html.md): Get a User

[pydo.users.list()](https://docs.digitalocean.com/reference/pydo/reference/users/list/index.html.md): List Users