Norman Finance MCP Server

Instructions

Retrieve a specific tax report.

Args:
    report_id: Public ID of the tax report to retrieve
    
Returns:
    Tax report details

Implementation Reference

• norman_mcp/tools/taxes.py:28-49 (handler)

  The handler function for the 'get_tax_report' MCP tool. It takes a report_id parameter, constructs the API URL, and makes a GET request to retrieve the tax report details.

  @mcp.tool()
  async def get_tax_report(
      ctx: Context,
      report_id: str = Field(description="Public ID of the tax report to retrieve")
  ) -> Dict[str, Any]:
      """
      Retrieve a specific tax report.
      
      Args:
          report_id: Public ID of the tax report to retrieve
          
      Returns:
          Tax report details
      """
      api = ctx.request_context.lifespan_context["api"]
      
      report_url = urljoin(
          config.api_base_url,
          f"api/v1/taxes/reports/{report_id}/"
      )
      
      return api._make_request("GET", report_url)

• norman_mcp/server.py:330-330 (registration)

  Invocation of register_tax_tools(server) which registers the get_tax_report tool among other tax tools.

  register_tax_tools(server)

• norman_mcp/tools/taxes.py:16-17 (registration)

  The register_tax_tools function that defines and registers all tax tools, including get_tax_report, using @mcp.tool() decorators.

  def register_tax_tools(mcp):
      """Register all tax-related tools with the MCP server."""

• norman_mcp/tools/taxes.py:31-31 (schema)

  Pydantic Field defining the input schema for the report_id parameter of the get_tax_report tool.

  report_id: str = Field(description="Public ID of the tax report to retrieve")