sieve_deals
Read-only
Retrieve deals from your Sieve pipeline. Search by company name to find specific deals or list all to get deal metadata including Sieve scores.
Instructions
List deals in your Sieve pipeline.
Search by company name or list all deals. Returns deal metadata including Sieve scores for screened deals.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| search | No | Search by company name (partial match). Empty returns all. | |
| limit | No | Maximum results to return (1-100, default 20). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/sieve_mcp/server.py:161-171 (handler)MCP tool handler function that defines and exposes the sieve_deals tool. It accepts optional search (string) and limit (int, default 20) parameters, and delegates to client.deals().
async def sieve_deals(search: str = "", limit: int = 20) -> dict: """List deals in your Sieve pipeline. Search by company name or list all deals. Returns deal metadata including Sieve scores for screened deals. Args: search: Search by company name (partial match). Empty returns all. limit: Maximum results to return (1-100, default 20). """ return await client.deals(search=search, limit=limit) - src/sieve_mcp/server.py:154-160 (registration)The @mcp.tool decorator registering sieve_deals as an MCP tool with readOnlyHint=True, marking it as a non-destructive, read-only operation.
@mcp.tool( annotations={ "readOnlyHint": True, "destructiveHint": False, "openWorldHint": True, } ) - src/sieve_mcp/client.py:154-162 (helper)The client.deals() helper function that constructs a GET request to /deals with optional search and limit query parameters, then calls the underlying _request() HTTP helper.
async def deals(search: str = "", limit: int = 20) -> dict[str, Any]: """List/search deals in pipeline.""" params = [] if search: params.append(f"search={search}") if limit != 20: params.append(f"limit={limit}") query = f"?{'&'.join(params)}" if params else "" return await _request("GET", f"/deals{query}") - src/sieve_mcp/server.py:167-170 (schema)Docstring defining the input schema for sieve_deals: search (string for partial company name match, empty returns all) and limit (int, 1-100, default 20).
Args: search: Search by company name (partial match). Empty returns all. limit: Maximum results to return (1-100, default 20). """