create_invoice tool issues, mcp

[gitsathish]

issues with the create_invoice tool.
The information on this page https://github.com/paypal/agent-toolkit/blob/main/PROMPTS.md do not seem to be same as what the tool is doing/expecting.
tool seems to expect a unit_amount field. Not clear what the datatype for unit_amount is, pls clarify.
Also, quantity seems to be expected as a string by the tool. pls clarify.
Could you please provide a example payload for create_invoice, the tool description from the tool listing does not have an example. Whereas create_shipment_tracking provides an example.

[amsourav]

Unit Amount is a combination of Unit Value and the Currency Code eg. unit_amount = { currency_code: 'USD', value: '100.00' }. Quantity is a string and its value ranges from -1000000 to 1000000. Supports up to five decimal places

Here are some sample prompts for create_invoice -

• Create an invoice in USD for 3 units of 'Wireless Mouse' at $25 each. No tax, no recipient info needed.

{
  "detail": {
    "currency_code": "USD"
  },
  "items": [
    {
      "name": "Wireless Mouse",
      "quantity": "3",
      "unit_amount": {
        "currency_code": "USD",
        "value": "25.00"
      }
    }
  ]
}

• Create an invoice in USD for consulting services delivered on 10th May 2026, with an item called 'Strategy Session' priced at $200 per hour for 2 hours billed to John Doe (customer@example.com)

{
  "detail": {
    "invoice_date": "2026-05-10",
    "currency_code": "USD"
  },
  "primary_recipients": [
    {
      "billing_info": {
        "name": {
          "given_name": "John",
          "surname": "Doe"
        },
        "email_address": "customer@example.com"
      }
    }
  ],
  "items": [
    {
      "name": "Strategy Session",
      "quantity": "2",
      "unit_amount": {
        "currency_code": "USD",
        "value": "200.00"
      },
      "unit_of_measure": "HOURS"
    }
  ]
}

• Make an invoice in USD for 1.5 hours of 'Consulting', priced at USD120/hour. Include tax named 'Service Tax' at 10%. Date: today.

{
  "detail": {
    "invoice_date": "2025-05-09",
    "currency_code": "USD"
  },
  "items": [
    {
      "name": "Consulting",
      "quantity": "1.5",
      "unit_amount": {
        "currency_code": "USD",
        "value": "120.00"
      },
      "tax": {
        "name": "Service Tax",
        "percent": "10"
      },
      "unit_of_measure": "HOURS"
    }
  ]
}