meta_search_entities

Search campaigns, ad sets, or ads by name within an ad account. One of 59 Meta Ads tools on the Get MCP Ads MCP gateway.

Search campaigns, ad sets, or ads by name within an ad account. Useful for finding specific entities.

Source: Meta Ads
Kind: Read
Discovery: Reachable through search_tools and run_tool
Account parameter: adAccountId
Endpoint: https://mcp.getmcpads.com/meta-ads/mcp

ParametersLink to this section

Name	Type	Required	Notes
`adAccountId`	string	Required	Meta account ID.
`entityType`	string	Required	Type of entity to search. One of: `campaigns`, `adsets`, `ads`.
`nameFilter`	string	Required	Name substring to search for.
`statusFilter`	string	Optional	Filter by native effective_status, not configured status. PAUSED excludes IN_PROCESS, CAMPAIGN_PAUSED and ADSET_PAUSED. Omit for post-creation verification and inspect both returned status fields. One of: `ACTIVE`, `PAUSED`, `DELETED`, `ARCHIVED`.
`limit`	integer	Optional	Maximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. Default: `100`.
`cursor`	string	Optional	Pagination cursor from previous response.

Calling itLink to this section

jsonThrough run_tool, since it is not announced

{
  "name": "run_tool",
  "arguments": {
    "name": "meta_search_entities",
    "args": {
      "adAccountId": "<string>",
      "entityType": "campaigns",
      "nameFilter": "<string>"
    }
  }
}