ArmaVita Meta Ads MCP

Instructions

Implementation Reference

• src/armavita_meta_ads_mcp/core/targeting_tools.py:427-452 (handler)

  The handler function that implements the search_geo_locations tool logic.

  async def search_geo_locations(
      query: str,
      meta_access_token: Optional[str] = None,
      location_types: Optional[List[str]] = None,
      page_size: int = 25,
      page_cursor: str = "",
  ) -> str:
      """Search geo-location entities for targeting."""
      if not str(query or "").strip():
          return _as_json({"error": "No query provided"})
  
      params: Dict[str, Any] = {
          "type": "adgeolocation",
          "q": query,
          "page_size": int(page_size),
      }
      if page_cursor:
          params["page_cursor"] = page_cursor
      if location_types:
          params["location_types"] = json.dumps(list(location_types))
      payload = await make_api_request(
          "search",
          meta_access_token,
          params,
      )
      return _as_json(payload)

• src/armavita_meta_ads_mcp/core/targeting_tools.py:425-426 (registration)

  Registration of search_geo_locations as an MCP tool using the @mcp_server.tool() decorator.

  @mcp_server.tool()
  @meta_api_tool