armavita-originality-ai-mcp

Instructions

Implementation Reference

• armavita_originality_ai_mcp/handlers/scan_handlers.py:185-195 (handler)

  Handler function that retrieves stored scan results by scan_id, validates the input, calls the client API, and formats the response using _format_full_result()

  async def handle_get_scan_results(
      arguments: dict[str, Any],
      client: OriginalityClient,
  ) -> list[TextContent]:
      """Retrieve stored scan results."""
      scan_id = arguments.get("scan_id", "")
      if not scan_id:
          return [TextContent(type="text", text="No scan_id provided.")]
  
      result = await client.get_scan_results(scan_id)
      return [TextContent(type="text", text=_format_full_result(result))]

• armavita_originality_ai_mcp/tools/scan_tools.py:224-241 (schema)

  Tool schema definition with name 'get_scan_results', description, and inputSchema requiring scan_id parameter

  Tool(
      name="get_scan_results",
      description=(
          "Retrieve previously stored scan results by scan ID. Use this to fetch "
          "full results for scans that were stored (storeScan=true), or to check "
          "on scans that may have been processing when originally submitted."
      ),
      inputSchema={
          "type": "object",
          "properties": {
              "scan_id": {
                  "type": "string",
                  "description": "The scan ID (returned as 'id' in the original scan response).",
              },
          },
          "required": ["scan_id"],
      },
  ),

• armavita_originality_ai_mcp/server.py:53-62 (registration)

  Registration mapping tool name 'get_scan_results' to its handler function handle_get_scan_results

  TOOL_HANDLERS = {
      "scan_ai": handle_scan_ai,
      "scan_full": handle_scan_full,
      "scan_plagiarism": handle_scan_plagiarism,
      "scan_readability": handle_scan_readability,
      "scan_seo": handle_scan_seo,
      "scan_url": handle_scan_url,
      "get_scan_results": handle_get_scan_results,
      "credit_balance": handle_credit_balance,
  }

• armavita_originality_ai_mcp/client.py:111-115 (helper)

  Client method that makes the actual HTTP GET request to /scan-results endpoint with scan_id parameter

  async def get_scan_results(self, scan_id: str) -> dict[str, Any]:
      """Retrieve stored scan results by ID."""
      resp = await self.client.get("/scan-results", params={"id": scan_id})
      resp.raise_for_status()
      return resp.json()