Norman Finance MCP Server

Instructions

Delete a client.

Args:
    client_id: ID of the client to delete
    
Returns:
    Confirmation of deletion

Implementation Reference

• norman_mcp/tools/clients.py:206-232 (handler)

  The handler function for the 'delete_client' tool. It deletes the specified client using the Norman API by making a DELETE request. Includes input validation via function signature and docstring serving as schema, and is directly registered via @mcp.tool() decorator.

  @mcp.tool()
  async def delete_client(
      ctx: Context,
      client_id: str
  ) -> Dict[str, Any]:
      """
      Delete a client.
      
      Args:
          client_id: ID of the client to delete
          
      Returns:
          Confirmation of deletion
      """
      api = ctx.request_context.lifespan_context["api"]
      company_id = api.company_id
      
      if not company_id:
          return {"error": "No company available. Please authenticate first."}
      
      client_url = urljoin(
          config.api_base_url, 
          f"api/v1/companies/{company_id}/clients/{client_id}/"
      )
      
      api._make_request("DELETE", client_url)
      return {"message": "Client deleted successfully"} 

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

  Top-level registration call that invokes register_client_tools(server), which registers the 'delete_client' tool (along with other client tools) with the MCP server instance.

  register_client_tools(server)