Skip to main content
Glama

Kema Invoice

by com.kema-studio
OverviewDiscussionsAdmin

Issue invoice (LEGALLY BINDING)

issue_invoice
Destructive

Issue a Draft invoice: the legal act of creating it (the product calls this 'Créer la facture'). The invoice becomes a definitive legal document (status Sent, displayed as 'Créée'): IRREVERSIBLE under French law, undone only with a credit note. ALWAYS show the user the invoice summary and get their explicit approval before calling with confirm:true; without confirm, returns a preview. Fiscal certification happens inside this call and is internal plumbing: once it returns, tell the user the invoice is created and nothing more. NEVER mention certification, fiscal status, immutability or processing to the user unless this tool returns an error.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
confirmNoMust be true to issue. Omit/false to preview the invoice that would be issued.
invoice_idYesThe Draft invoice UUID to issue.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
idNoInvoice UUID.
noteNoWhat to tell the user (after confirm:true).
typeNoDocument type: invoice, credit_note, provision or quote.
statusNoDocument status: Draft, Sent, Paid, Overdue, Cancelled, Rectified, Accepted, Rejected or Expired.
companyNoClient company name, null when unknown.
paid_atNoPayment timestamp (ISO 8601), null while unpaid.
previewNoTrue when the call was a preview (confirm omitted or false): nothing was changed.
warningNoIrreversibility warning (preview only).
currencyNoISO 4217 currency code (EUR, USD, GBP or CHF).
due_dateNoDue date, YYYY-MM-DD.
issue_dateNoIssue date, YYYY-MM-DD.
gross_totalNoTotal incl. VAT, in the document currency.
would_issueNoInvoice that would be issued (preview only).
invoice_numberNoHuman-readable invoice number.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changed
    • changedInput schema / properties / confirm / description
      Previous value: -"Must be true to issue + certify. Omit/false to preview the invoice that would be certified."New value: +"Must be true to issue. Omit/false to preview the invoice that would be issued."
    • removedOutput schema / properties / certification_status
      Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "description": "Certification status right after submission (after confirm:true)."
-}
    • changedOutput schema / properties / note / description
      Previous value: -"Outcome summary (after confirm:true)."New value: +"What to tell the user (after confirm:true)."
    • addedOutput schema / properties / would_issue
      Added value: +{
+  "additionalProperties": false,
+  "description": "Invoice that would be issued (preview only).",
+  "properties": {
+    "company": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "Client company name, null when unknown."
+    },
+    "currency": {
+      "description": "ISO 4217 currency code.",
+      "type": "string"
+    },
+    "due_date": {
+      "description": "Due date, YYYY-MM-DD.",
+      "type": "string"
+    },
+    "gross_total": {
+      "description": "Total incl. VAT, in the document currency.",
+      "type": "number"
+    },
+    "id": {
+      "description": "Document UUID.",
+      "type": "string"
+    },
+    "invoice_number": {
+      "description": "Human-readable document number.",
+      "type": "string"
+    },
+    "issue_date": {
+      "description": "Issue date, YYYY-MM-DD.",
+      "type": "string"
+    },
+    "items": {
+      "description": "Line items that would be certified.",
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "description": {
+            "description": "Line text.",
+            "type": "string"
+          },
+          "quantity": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Quantity, null for section/description lines."
+          },
+          "tax_rate": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "VAT rate in percent, null for non-item lines."
+          },
+          "unit_price": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Unit price excl. VAT, null for non-item lines."
+          }
+        },
+        "required": [
+          "description",
+          "quantity",
+          "unit_price",
+          "tax_rate"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "net_total": {
+      "description": "Total excl. VAT, in the document currency.",
+      "type": "number"
+    },
+    "status": {
+      "description": "Document status: Draft, Sent, Paid, Overdue, Cancelled, Rectified, Accepted, Rejected or Expired.",
+      "type": "string"
+    },
+    "tax_total": {
+      "description": "VAT amount, in the document currency.",
+      "type": "number"
+    }
+  },
+  "required": [
+    "id",
+    "invoice_number",
+    "status",
+    "gross_total",
+    "company",
+    "issue_date",
+    "due_date",
+    "net_total",
+    "tax_total",
+    "currency",
+    "items"
+  ],
+  "type": "object"
+}
    • removedOutput schema / properties / would_issue_and_certify
      Removed value: -{
-  "additionalProperties": false,
-  "description": "Invoice that would be issued and certified (preview only).",
-  "properties": {
-    "company": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "description": "Client company name, null when unknown."
-    },
-    "currency": {
-      "description": "ISO 4217 currency code.",
-      "type": "string"
-    },
-    "due_date": {
-      "description": "Due date, YYYY-MM-DD.",
-      "type": "string"
-    },
-    "gross_total": {
-      "description": "Total incl. VAT, in the document currency.",
-      "type": "number"
-    },
-    "id": {
-      "description": "Document UUID.",
-      "type": "string"
-    },
-    "invoice_number": {
-      "description": "Human-readable document number.",
-      "type": "string"
-    },
-    "issue_date": {
-      "description": "Issue date, YYYY-MM-DD.",
-      "type": "string"
-    },
-    "items": {
-      "description": "Line items that would be certified.",
-      "items": {
-        "additionalProperties": false,
-        "properties": {
-          "description": {
-            "description": "Line text.",
-            "type": "string"
-          },
-          "quantity": {
-            "anyOf": [
-              {
-                "type": "number"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Quantity, null for section/description lines."
-          },
-          "tax_rate": {
-            "anyOf": [
-              {
-                "type": "number"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "VAT rate in percent, null for non-item lines."
-          },
-          "unit_price": {
-            "anyOf": [
-              {
-                "type": "number"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Unit price excl. VAT, null for non-item lines."
-          }
-        },
-        "required": [
-          "description",
-          "quantity",
-          "unit_price",
-          "tax_rate"
-        ],
-        "type": "object"
-      },
-      "type": "array"
-    },
-    "net_total": {
-      "description": "Total excl. VAT, in the document currency.",
-      "type": "number"
-    },
-    "status": {
-      "description": "Document status: Draft, Sent, Paid, Overdue, Cancelled, Rectified, Accepted, Rejected or Expired.",
-      "type": "string"
-    },
-    "tax_total": {
-      "description": "VAT amount, in the document currency.",
-      "type": "number"
-    }
-  },
-  "required": [
-    "id",
-    "invoice_number",
-    "status",
-    "gross_total",
-    "company",
-    "issue_date",
-    "due_date",
-    "net_total",
-    "tax_total",
-    "currency",
-    "items"
-  ],
-  "type": "object"
-}
  2. Changed2 schema fields changed
    • addedInput schema / properties / invoice_id / description
      Added value: +"The Draft invoice UUID to issue."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "certification_status": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "Certification status right after submission (after confirm:true)."
+    },
+    "company": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "Client company name, null when unknown."
+    },
+    "currency": {
+      "description": "ISO 4217 currency code (EUR, USD, GBP or CHF).",
+      "type": "string"
+    },
+    "due_date": {
+      "description": "Due date, YYYY-MM-DD.",
+      "type": "string"
+    },
+    "gross_total": {
+      "description": "Total incl. VAT, in the document currency.",
+      "type": "number"
+    },
+    "id": {
+      "description": "Invoice UUID.",
+      "type": "string"
+    },
+    "invoice_number": {
+      "description": "Human-readable invoice number.",
+      "type": "string"
+    },
+    "issue_date": {
+      "description": "Issue date, YYYY-MM-DD.",
+      "type": "string"
+    },
+    "note": {
+      "description": "Outcome summary (after confirm:true).",
+      "type": "string"
+    },
+    "paid_at": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "Payment timestamp (ISO 8601), null while unpaid."
+    },
+    "preview": {
+      "description": "True when the call was a preview (confirm omitted or false): nothing was changed.",
+      "type": "boolean"
+    },
+    "status": {
+      "description": "Document status: Draft, Sent, Paid, Overdue, Cancelled, Rectified, Accepted, Rejected or Expired.",
+      "type": "string"
+    },
+    "type": {
+      "description": "Document type: invoice, credit_note, provision or quote.",
+      "type": "string"
+    },
+    "warning": {
+      "description": "Irreversibility warning (preview only).",
+      "type": "string"
+    },
+    "would_issue_and_certify": {
+      "additionalProperties": false,
+      "description": "Invoice that would be issued and certified (preview only).",
+      "properties": {
+        "company": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Client company name, null when unknown."
+        },
+        "currency": {
+          "description": "ISO 4217 currency code.",
+          "type": "string"
+        },
+        "due_date": {
+          "description": "Due date, YYYY-MM-DD.",
+          "type": "string"
+        },
+        "gross_total": {
+          "description": "Total incl. VAT, in the document currency.",
+          "type": "number"
+        },
+        "id": {
+          "description": "Document UUID.",
+          "type": "string"
+        },
+        "invoice_number": {
+          "description": "Human-readable document number.",
+          "type": "string"
+        },
+        "issue_date": {
+          "description": "Issue date, YYYY-MM-DD.",
+          "type": "string"
+        },
+        "items": {
+          "description": "Line items that would be certified.",
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "description": {
+                "description": "Line text.",
+                "type": "string"
+              },
+              "quantity": {
+                "anyOf": [
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Quantity, null for section/description lines."
+              },
+              "tax_rate": {
+                "anyOf": [
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "VAT rate in percent, null for non-item lines."
+              },
+              "unit_price": {
+                "anyOf": [
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Unit price excl. VAT, null for non-item lines."
+              }
+            },
+            "required": [
+              "description",
+              "quantity",
+              "unit_price",
+              "tax_rate"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "net_total": {
+          "description": "Total excl. VAT, in the document currency.",
+          "type": "number"
+        },
+        "status": {
+          "description": "Document status: Draft, Sent, Paid, Overdue, Cancelled, Rectified, Accepted, Rejected or Expired.",
+          "type": "string"
+        },
+        "tax_total": {
+          "description": "VAT amount, in the document currency.",
+          "type": "number"
+        }
+      },
+      "required": [
+        "id",
+        "invoice_number",
+        "status",
+        "gross_total",
+        "company",
+        "issue_date",
+        "due_date",
+        "net_total",
+        "tax_total",
+        "currency",
+        "items"
+      ],
+      "type": "object"
+    }
+  },
+  "type": "object"
+}
  3. First observed

TDQS

A4.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already mark destructiveHint=true. The description adds crucial context beyond annotations: irreversibility under French law, status transition to Sent/Créée, fiscal certification being internal plumbing, and the mandated user communication pattern (what to tell the user, what never to mention). This is high-value behavioral disclosure.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the core purpose and legal consequence, then the must-have workflow. Long sentences carry a lot, but every clause earns its place. Minor redundancy: 'IRREVERSIBLE' repeats destructiveHint, but it's substantive enough.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Complete for a destructive legal-action tool. Covers prerequisites (Draft state, approval), the confirm gate, side effects (status, certification), and post-call user communication strategy. Output schema exists, so return details need not be repeated. Nothing an agent needs to avoid a critical mistake is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and descriptions for both parameters are exact. The description adds a critical semantic layer—the confirm:true vs preview distinction is explained in the tool description, not just the schema, clarifying the safety-critical usage. Full value beyond schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States the specific verb ('Issue'), the resource ('a Draft invoice'), and the legal effect with exact product terminology ('Créer la facture'), distinguishing it from sibling tools like create_invoice, cancel_invoice, or create_credit_note. Clear differentiation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicit when-to-use guidance: call after showing summary and getting explicit approval; use confirm:true to issue, omit for preview; maps directly to the schema. Though it doesn't enumerate alternatives, the workflow is precise. Could name siblings, but the condition is unambiguous.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Kema Invoice toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources