API Reference

Meta Ads / API Reference

meta_ads_adsets

Meta Ads tool. Get Meta Ads adset-level performance: spend, impressions, CPC, frequency per ad set. Args: start_date: Start date YYYY-MM-DD. Defaults to 28 days ago. end_date: End date YYYY-MM-DD. Defaults to today. account_id: Ad account ID. Leave blank to use .env default. campaign_id: Filter by a specific campaign ID. Leave blank for all.

This is a read-only tool: it returns adsets for 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:

Adsets in my Meta Ads account.

It takes 0 required and 4 optional parameters.

Parameters

ParameterTypeRequiredDescription
start_datestringNoStart Date
end_datestringNoEnd Date
account_idstringNoAccount Id
campaign_idstringNoCampaign Id

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