Norman Finance MCP Server

Instructions

Get list of available tax states.

Returns:
    List of tax states

Implementation Reference

• norman_mcp/tools/taxes.py:185-197 (handler)

  The handler function for the 'list_tax_states' tool. It makes a GET request to the API endpoint for tax states.

  @mcp.tool()
  async def list_tax_states(ctx: Context) -> Dict[str, Any]:
      """
      Get list of available tax states.
      
      Returns:
          List of tax states
      """
      api = ctx.request_context.lifespan_context["api"]
      
      states_url = urljoin(config.api_base_url, "api/v1/taxes/states/")
      
      return api._make_request("GET", states_url)

• norman_mcp/server.py:328-336 (registration)

  Registration block in the server creation where register_tax_tools(server) is called, which defines and registers the list_tax_states tool among others.

  register_client_tools(server)
  register_invoice_tools(server)
  register_tax_tools(server)
  register_transaction_tools(server)
  register_document_tools(server)
  register_company_tools(server)
  register_prompts(server)
  register_resources(server)