agora_search
Search for products across the web using natural language queries, with options to filter by price range, sort results, and paginate through listings.
Instructions
Search for products matching the query in Agora.
Args:
q: The search query.
count: The number of products to return per page.
page: The page number.
price_min: The minimum price. Optional
price_max: The maximum price. Optional
sort: The sort field: price:relevance.
order: The sort order: asc or desc.
Returns:
The search results.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | ||
| price_min | No | ||
| price_max | No | ||
| count | No | ||
| page | No | ||
| sort | No | relevance | |
| order | No | desc |
Implementation Reference
- src/agora_mcp/server.py:34-61 (handler)The main handler function for the 'agora_search' tool. It searches for products using the Agora client based on query and filters, then handles and returns the response.
async def agora_search(q: str, price_min: int = 0, price_max: int = 100000, count: int = 20, page: int = 1, sort: str = "relevance", order: str = "desc") -> Dict: """ Search for products matching the query in Agora. Args: q: The search query. count: The number of products to return per page. page: The page number. price_min: The minimum price. Optional price_max: The maximum price. Optional sort: The sort field: price:relevance. order: The sort order: asc or desc. Returns: The search results. """ response = get_agora().search_products( query=q, count=count, page=page, price_min=price_min, price_max=price_max, sort=sort, order=order ) return handle_response(response) - src/agora_mcp/server.py:33-33 (registration)The @mcp.tool() decorator registers the agora_search function as an MCP tool.
@mcp.tool() - src/agora_mcp/server.py:11-19 (helper)Helper function to lazily initialize and return the Agora client instance, used by agora_search.
def get_agora(): """Get or create an Agora instance. We want to create the class instance inside the tool, so the init errors will bubble up to the tool and hence the MCP client instead of silently failing during the server creation. """ return Agora() - src/agora_mcp/server.py:21-30 (helper)Helper function to process responses from Agora API calls, used by agora_search.
def handle_response(response): """ Handle responses from Agora methods. """ if hasattr(response, 'status_code'): # This is a raw response object try: return response.status_code, response.json() except: return response.status_code, response.text # This is already processed data (like a dictionary) return response - src/agora_mcp/server.py:37-51 (schema)Docstring providing input parameters and return type description, serving as schema documentation for the tool.
""" Search for products matching the query in Agora. Args: q: The search query. count: The number of products to return per page. page: The page number. price_min: The minimum price. Optional price_max: The maximum price. Optional sort: The sort field: price:relevance. order: The sort order: asc or desc. Returns: The search results. """