MAT Framework n8n Community Node

This repository provides the official community node that integrates MAT Framework with n8n. The node enables n8n workflows to securely trigger and monitor network-impacting automations executed inside MAT Framework.

All execution logic, governance, policy enforcement, and auditing are handled entirely within MAT.

Documentation

Full documentation, configuration guides, compatibility notes, and release information are available at:

https://iquall.net/mat-n8n/

For production deployments, always refer to the official documentation page above. This repository does not duplicate or maintain detailed usage documentation.

Overview

The node acts as a thin client over MAT’s northbound API layer. It does not execute automation logic itself. All execution, governance, policy enforcement, and auditing are handled by MAT.

High-level flow:

n8n Workflow > MAT Community Node > MAT Framework API > Network Domains

What this Node does:

• Triggers MAT automations or Bricks
• Pass structured input parameters
• Retrieves execution results
• Integrates MAT job outputs into n8n workflows

The node acts strictly as a thin client over MAT’s REST API. All authorization and validation are enforced server-side by MAT.

Prerequisites

• A running MAT Framework instance (SaaS or On-Prem)
• A valid API token
• Network connectivity between n8n and your MAT tenant
• A valid commercial MAT license

Security & Governance

This node does not execute automation logic locally and does not bypass MAT controls. All RBAC, CI/CD validation, approval gates, maintenance windows, and audit logging are enforced server-side within MAT.

When triggering a workflow:

1. n8n sends a request to MAT API.
2. MAT validates authentication and permissions.
3. MAT registers a Job internally.
4. Execution is performed within the MAT Engine.
5. Job status and output can be polled asynchronously.

The node does not bypass:

• Role-based access control
• Approval gates
• CI/CD enforcement
• Closed-loop policies
• Audit logging

Security Notes:

• The node stores credentials in n8n’s encrypted credential store.
• API tokens should be scoped according to least privilege.
• All sensitive execution logic remains server-side in MAT.
• No network configuration logic resides in this repository.

Error Handling

Errors returned by the node fall into two categories:

• Transport errors (network, timeout, TLS)
• Execution errors (returned by MAT API)

MAT-side execution errors include:

• Authorization failure
• Invalid workflow ID
• Parameter validation error
• Policy restriction
• All execution logs

Development

This node is implemented in TypeScript and follows n8n community node structure.

Scope

This repository does not include the MAT Engine, automation workflows or SLA/support services, nor does it expose proprietary Bricks. Use of MAT APIs requires a valid commercial license.

License

Proprietary License. The full license text is included in the published package as the LICENSE file.