sieve_results

Instructions

Implementation Reference

• src/sieve_mcp/server.py:117-136 (handler)

  The MCP tool handler for sieve_results. Decorated with @mcp.tool, it accepts deal_id and optional sections, delegates to client.results().

  @mcp.tool(
      annotations={
          "readOnlyHint": True,
          "destructiveHint": False,
          "openWorldHint": True,
      }
  )
  async def sieve_results(deal_id: str, sections: str = "") -> dict:
      """Get the full results of a completed Sieve analysis.
  
      Returns the Sieve Score (0-140), meeting decision (Take Meeting/Pass/
      Need More Info), executive summary, key strengths, and key concerns.
  
      Args:
          deal_id: The deal ID returned by sieve_screen.
          sections: Comma-separated filter (e.g. 'summary,strengths,concerns').
                    Options: summary, profiles, findings, questions, strengths, concerns.
                    Empty returns everything. Score and decision are always included.
      """
      return await client.results(deal_id, sections=sections)

• src/sieve_mcp/client.py:143-146 (helper)

  The HTTP client helper that performs the actual API call for sieve_results. Sends GET /api/v1/public/screen/{deal_id}/results with optional sections query parameter.

  async def results(deal_id: str, sections: str = "") -> dict[str, Any]:
      """Get full results of a completed analysis."""
      query = f"?sections={sections}" if sections else ""
      return await _request("GET", f"/screen/{deal_id}/results{query}")

• src/sieve_mcp/server.py:117-136 (registration)

  The @mcp.tool decorator on the sieve_results function registers it as an MCP tool. This is the registration mechanism.

  @mcp.tool(
      annotations={
          "readOnlyHint": True,
          "destructiveHint": False,
          "openWorldHint": True,
      }
  )
  async def sieve_results(deal_id: str, sections: str = "") -> dict:
      """Get the full results of a completed Sieve analysis.
  
      Returns the Sieve Score (0-140), meeting decision (Take Meeting/Pass/
      Need More Info), executive summary, key strengths, and key concerns.
  
      Args:
          deal_id: The deal ID returned by sieve_screen.
          sections: Comma-separated filter (e.g. 'summary,strengths,concerns').
                    Options: summary, profiles, findings, questions, strengths, concerns.
                    Empty returns everything. Score and decision are always included.
      """
      return await client.results(deal_id, sections=sections)

• src/sieve_mcp/server.py:124-136 (schema)

  The function signature and docstring define the schema: deal_id (str, required) and sections (str, optional default '') with documented valid options.

  async def sieve_results(deal_id: str, sections: str = "") -> dict:
      """Get the full results of a completed Sieve analysis.
  
      Returns the Sieve Score (0-140), meeting decision (Take Meeting/Pass/
      Need More Info), executive summary, key strengths, and key concerns.
  
      Args:
          deal_id: The deal ID returned by sieve_screen.
          sections: Comma-separated filter (e.g. 'summary,strengths,concerns').
                    Options: summary, profiles, findings, questions, strengths, concerns.
                    Empty returns everything. Score and decision are always included.
      """
      return await client.results(deal_id, sections=sections)