Norman Finance MCP Server

Instructions

Link a transaction to an invoice.

Args:
    invoice_id: ID of the invoice
    transaction_id: ID of the transaction to link
    
Returns:
    Response from the link transaction request

Implementation Reference

• norman_mcp/tools/invoices.py:433-465 (handler)

  The core handler function for the 'link_transaction' tool. It is decorated with @mcp.tool() for registration and implements the logic to link a transaction ID to an invoice ID via a POST request to the Norman API.

  @mcp.tool() 
  async def link_transaction(
      ctx: Context,
      invoice_id: str,
      transaction_id: str
  ) -> Dict[str, Any]:
      """
      Link a transaction to an invoice.
      
      Args:
          invoice_id: ID of the invoice
          transaction_id: ID of the transaction to link
          
      Returns:
          Response from the link transaction request
      """
      api = ctx.request_context.lifespan_context["api"]
      company_id = api.company_id
      
      if not company_id:
          return {"error": "No company available. Please authenticate first."}
          
      link_url = urljoin(
          config.api_base_url,
          f"api/v1/companies/{company_id}/invoices/{invoice_id}/link-transaction/"
      )
      
      link_data = {
          "transaction": transaction_id
      }
      
      return api._make_request("POST", link_url, json_data=link_data)

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

  Top-level registration call to register_invoice_tools(server), which includes the registration of the link_transaction tool via its @mcp.tool() decorator.

  register_invoice_tools(server)

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

  Import of register_invoice_tools from invoices.py in the main server.py file.

  from norman_mcp.tools.invoices import register_invoice_tools

• norman_mcp/tools/invoices.py:439-448 (schema)

  Docstring providing the input schema (arguments) and output description for the link_transaction tool.

  """
  Link a transaction to an invoice.
  
  Args:
      invoice_id: ID of the invoice
      transaction_id: ID of the transaction to link
      
  Returns:
      Response from the link transaction request
  """