Kora Authorize Spend icon

Kora Authorize Spend

Authorize financial transactions before spending. The AI agent MUST call this tool before any payment.

Kora Authorize Spend

AI-generated

Summary

Registers a tool for an AI agent to request authorization for financial transactions via the Kora protocol before spending.

Inputs

  • mandateId (required) — The mandate ID that governs this agent's spending.
  • toolDescription — Override the default tool description sent to the AI. Leave empty for default.

Output shape

a tool definition object for the AI agent

The tool is returned as a LangChain DynamicStructuredTool. The AI uses it to call the Kora protocol's /v1/authorize endpoint with deterministic intent_id generation based on n8n execution context. Returns a JSON object with status (APPROVED/DENIED/ERROR), message, and specific details (e.g., seal, remaining balance, denial reason, retry suggestion).

Examples

Example 1: Standard AI workflow authorization

Set 'Mandate ID' to the specific mandate governing the agent. The default tool description instructs the AI to provide amount_cents, currency, vendor_id, and purpose.

Example 2: Customizing tool behavior

Provide a custom 'Tool Description' to alter how the AI understands the tool's constraints or required fields.

Links

Discussion