ArmaVita Meta Ads MCP

Instructions

Implementation Reference

• src/armavita_meta_ads_mcp/core/targeting_tools.py:191-212 (handler)

  The implementation of the `search_interests` tool which searches for audience interests using the Meta API.

  @mcp_server.tool()
  @meta_api_tool
  async def search_interests(
      query: str,
      meta_access_token: Optional[str] = None,
      page_size: int = 25,
      page_cursor: str = "",
  ) -> str:
      """Find audience interests by keyword."""
      if not str(query or "").strip():
          return _as_json({"error": "No query provided"})
  
      params: Dict[str, Any] = {
          "type": "adinterest",
          "q": query,
          "page_size": int(page_size),
      }
      if page_cursor:
          params["page_cursor"] = page_cursor
  
      payload = await make_api_request("search", meta_access_token, params)
      return _as_json(payload)