Tools for discovering and inspecting Facebook ad accounts accessible to the authenticated user.
Start Here
Use list_ad_accounts first to discover available accounts. The returned account_id values are required by all other tools.
list_ad_accounts
List all Facebook ad accounts accessible to the authenticated user. Returns each account's ID, name, status, and currency.
Parameters
| Parameter | Type | Description |
|---|---|---|
limit |
number |
Results per page (1-1000, default: 1000) |
auto_paginate |
boolean |
Automatically fetch all pages (default: true) |
next_page_url |
string | undefined |
Pagination URL from a previous response |
Example
Natural Language
What ad accounts do I have access to?
List all my Facebook ad accounts
Direct Query
{
"tool": "list_ad_accounts",
"arguments": {}
}
get_ad_account
Retrieve comprehensive details for a Facebook ad account, including current status, currency, timezone, billing information, spending limits, and business ownership.
Parameters
| Parameter | Type | Description |
|---|---|---|
account_id |
string |
Facebook Ad Account ID (e.g., act_123456789) |
Example
Show me the details of ad account act_123456789
get_ad_account_activities
Retrieve the audit log of significant changes made to a Facebook ad account, such as status changes, payment method updates, and account-level budget modifications.
Parameters
| Parameter | Type | Description |
|---|---|---|
account_id |
string |
Facebook Ad Account ID (e.g., act_123456789) |
Example
Show me the activity log for ad account act_123456789
Related
- Campaign Tools Manage campaigns in your accounts
- Account Insights View account-level performance metrics