search_numbers
Find specific phone numbers by entering a search term to filter results. Use this tool in Omilia MCP Tools for targeted number retrieval and management.
Instructions
Search (phone) numbers with optional search term.
Args:
search_term: Optional search term to filter numbers
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| search_term | No |
Input Schema (JSON Schema)
{
"properties": {
"search_term": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Search Term"
}
},
"title": "search_numbersArguments",
"type": "object"
}
Implementation Reference
- src/main.py:206-215 (handler)MCP tool registration and handler function for 'search_numbers'. It instantiates IntegrationsClient and delegates to its search_numbers method.@mcp.tool() def search_numbers(search_term: str | None = None) -> list[str]: """Search (phone) numbers with optional search term. Args: search_term: Optional search term to filter numbers """ client = IntegrationsClient() return client.search_numbers(search_term=search_term)
- src/ocp/integrations.py:5-16 (helper)Core implementation of the search_numbers functionality within IntegrationsClient class, performing an API GET request to retrieve numbers matching the search term.def search_numbers(self, search_term: str | None = None, page_size: int = 100) -> dict: """Search numbers with optional search term. Args: search_term (str, optional): Search term to filter numbers. Case insensitive. Returns: dict: The numbers matching the search criteria """ endpoint = "integrations/api/numbers" params = {"pageSize": page_size, "searchTerm": search_term} return self.get(endpoint, params=params)
- src/main.py:207-212 (schema)Input schema and documentation for the search_numbers tool, defining the optional search_term parameter and return type as list[str].def search_numbers(search_term: str | None = None) -> list[str]: """Search (phone) numbers with optional search term. Args: search_term: Optional search term to filter numbers """