Meta Ads / API Reference
meta_ads_find_account
Meta Ads tool. Find a Meta Ads account by partial name, ID fragment, or currency. Searches across ALL accounts (130+) using fuzzy partial matching. Checks user accounts and optionally business accounts. Case-insensitive. Hebrew, English, and mixed names all supported. Examples of valid queries: - "רוקט" → matches "Rocket Digital | רוקט" - "ynet" → matches "Ynet – News" - "269" → matches account IDs containing "269" - "ILS" → all ILS-currency accounts - "רמי לוי" → matches partial client name Args: query: Any partial string to match against account name or ID (required). user_id: Facebook user ID. Default: "me". business_id: Optional Business Manager ID to also search business accounts. Returns a list of matching accounts with id, name, status, and currency, plus the total count of matches.
This is a read-only tool: it finds account 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:
Find account in my Meta Ads account for [query].
It takes 1 required and 2 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Query |
user_id | string | No | User Id |
business_id | string | No | Business Id |
Related Meta Ads tools
meta_ads_find_pagemeta_ads_ab_test_resultsmeta_ads_account_change_historymeta_ads_account_diagnosticsmeta_ads_account_spending_limitmeta_ads_ad
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: