search_geo_locations
Find geographic locations for Meta Ads targeting by searching location names or types to refine audience reach in advertising campaigns.
Instructions
Search geo-location entities for targeting.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| meta_access_token | No | ||
| location_types | No | ||
| page_size | No | ||
| page_cursor | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- 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