create_invoice

Creates a DRAFT invoice only. This tool does not finalize or send invoices or collect payment. Requires a client name and line items (or totalAmount shorthand)…

Use with an AI agent

Export this page as Markdown or bundle it with a task for your agent.

Try a task
Preview the prompt that will be copied

Access

  • Effect: Creates data
  • Required scope: write (the mcp scope also grants it)

Example request

The JSON-RPC message an MCP client sends to call this tool. Your client builds it for you; this is for reference and debugging in a tool such as MCP Inspector.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_invoice",
    "arguments": {}
  }
}

Example IDs refer to fictional demo data. Replace them with IDs from your account before calling the real server.

Description

Creates a DRAFT invoice only. This tool does not finalize or send invoices or collect payment. Requires a client name and line items (or totalAmount shorthand). If accountId is omitted, it uses Main Checking or the only accessible account when unambiguous; otherwise it asks which account. Dates default when omitted; currency defaults to the account's currency. When line items are omitted and totalAmount is provided, it creates one Services line item; invoice totals are calculated from line items. clientName and the amount are NEVER invented — if they are missing this tool returns guidance asking you to clarify with the user.

Input parameters

NameTypeRequiredDescription
accountIdstringNo
clientNamestringNo
contactDetailsstringNo
currencystringNo
deliveryMethodstringNo
descriptionstringNo
dueDatestringNo
issuedAtDatestringNo
itemsarrayNo
reminderFrequencystringNo
totalAmountnumberNo
Full input schema (JSON Schema)
json
{
  "additionalProperties": false,
  "properties": {
    "accountId": {
      "type": "string"
    },
    "clientName": {
      "type": "string"
    },
    "contactDetails": {
      "type": "string"
    },
    "currency": {
      "type": "string"
    },
    "deliveryMethod": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "dueDate": {
      "type": "string"
    },
    "issuedAtDate": {
      "type": "string"
    },
    "items": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "currency": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "discount": {
            "type": "number"
          },
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "quantity": {
            "type": "integer"
          },
          "taxRate": {
            "type": "number"
          },
          "unitPrice": {
            "type": "number"
          }
        },
        "required": [
          "id",
          "name",
          "description",
          "unitPrice",
          "currency",
          "quantity",
          "taxRate",
          "discount"
        ],
        "type": "object"
      },
      "type": [
        "null",
        "array"
      ]
    },
    "reminderFrequency": {
      "type": "string"
    },
    "totalAmount": {
      "type": "number"
    }
  },
  "type": "object"
}