---
title: "list_user_accounts. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/list_user_accounts
description: "List accounts the current user has access to, with optional name filtering. Read tool on the Metadata MCP server, with its full JSON Schema and a real recorded response."
source: metadata.io
---

# list_user_accounts

List accounts the current user has access to, with optional name filtering.

Read [account](https://metadata.io/developers/tools/#cat-account)

## What it does

## Arguments

| Argument | Type |   | Notes |
|---|---|---|---|
| `name` | string |   | Partial account name to search for. Optional for regular users (acts as a filter); required for super users (acts as the search query against the whole platform). |

## Request

**Request template, not a complete runnable example.** Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.

## Response

Real, from the production server, in **906 ms**. Values that identify a customer or disclose money are replaced with typed placeholders; keys, types and nesting are exactly as returned.

## Related

Other account tools:

- [connect_crm](https://metadata.io/developers/tools/connect_crm) Writes
- [create_topup_link](https://metadata.io/developers/tools/create_topup_link) Destructive
- [get_account_details](https://metadata.io/developers/tools/get_account_details) Read
- [get_credit_balance](https://metadata.io/developers/tools/get_credit_balance) Read
- [get_credit_transactions](https://metadata.io/developers/tools/get_credit_transactions) Read
- [get_integrations_status](https://metadata.io/developers/tools/get_integrations_status) Read
- [get_payment_status](https://metadata.io/developers/tools/get_payment_status) Read
- [impersonate_account](https://metadata.io/developers/tools/impersonate_account) Writes

[Browse the tool catalog](https://metadata.io/developers/tools/) · [machine-readable index](https://metadata.io/developers/tools.json)