API Reference

Meta Ads / API Reference

meta_ads_list_ad_accounts

Meta Ads tool. List all Meta ad accounts the user has access to, with optional name filtering. Paginates through ALL accounts (not just the first 50). If name_filter is provided, returns only accounts whose name contains that string (case-insensitive). Args: user_id: Facebook user ID. Leave blank to use 'me'. name_filter: Optional partial name to filter results, e.g. 'רוקט' or 'rocket'.

This is a read-only tool: it lists ad accounts from your Meta Ads account. It changes nothing.

Ask Claude

You do not call this tool yourself. Ask for the outcome and the client picks the tool:

List ad accounts in my Meta Ads account.

It takes 0 required and 2 optional parameters.

Parameters

ParameterTypeRequiredDescription
user_idstringNoUser Id
name_filterstringNoName Filter

Related Meta Ads tools

Before you can call it

This tool needs a connected Meta Ads account. The Meta Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.

Workflows that use this

Rather than calling tools one at a time, these skills run a whole procedure against the same account:

Start using MCP Ads