agenium

n8n nodes for the Agenium agent:// protocol — bridge AI agents to 400+ automation nodes

Package Information

Downloads: 5 weekly / 11 monthly
Latest Version: 1.0.0

Available Nodes

Agenium
Interact with AI agents via the agent:// protocol. Bridge agents to 400+ n8n nodes.
Agenium Trigger
Triggers workflow when an agent sends a message via agent:// protocol. Connect to any of 400+ n8n nodes.
Agenium DNS
Manage Agenium DNS records — register, update, and query agent domains

Documentation

n8n-nodes-agenium

Connect AI agents to your n8n workflows via the agent:// protocol.

Bridge autonomous AI agents to 400+ n8n integrations — Google Sheets, Slack, databases, CRMs, and more.

Nodes

Node Type Description
Agenium Action Send messages, resolve URIs, list agents
Agenium Trigger Trigger Webhook trigger when agents send messages
Agenium DNS Action Register, update, delete, lookup agent domains

Installation

# In your n8n instance
npm install n8n-nodes-agenium

Or install via n8n Community Nodes in Settings → Community Nodes.

Credentials

  1. Go to Settings → Credentials → New Credential
  2. Search for Agenium API
  3. Enter your API key (dom_...) from agenium.net

Example Workflows

Agent → Google Sheets Logger

Agenium Trigger → Set → Google Sheets (Append Row)

Every agent message automatically logged to a spreadsheet.

Slack → Agent → Slack

Slack Trigger → Agenium (Send Message) → Slack (Post Message)

Forward Slack messages to an AI agent and post the response back.

Scheduled Agent Health Check

Cron → Agenium (List Agents) → IF → Email / Slack Alert

Monitor agent availability on a schedule.

Multi-Agent Pipeline

Agenium Trigger → Agenium (Send to Agent B) → Agenium (Send to Agent C) → Slack

Chain multiple agents in a workflow.

Agent Card Data in Expressions

When using the trigger node, all agent data is available in n8n expressions:

  • {{$json.event}} — Event type (message, task.completed, etc.)
  • {{$json.from}} — Sender agent URI
  • {{$json.message}} — Message content
  • {{$json.agentName}} — Agent domain name
  • {{$json.messageText}} — Message as plain text
  • {{$json.timestamp}} — ISO timestamp
  • {{$json.metadata}} — Additional metadata object

Error Handling

All nodes support:

  • Continue On Fail — process remaining items even if one fails
  • Retry on failure — automatic retry with exponential backoff (up to 3 retries)
  • Dead letter patterns — use Error Trigger node to handle failures

Development

npm install
npm run build
# Link to local n8n for testing
npm link
cd ~/.n8n/custom
npm link n8n-nodes-agenium

License

MIT

Bug Reporting

This project includes optional bug reporting to the Agenium monitoring server.

Configuration

Set the following environment variables to enable bug reporting:

BUG_REPORT_URL=http://130.185.123.153:3100
BUG_REPORT_TOKEN=your_token_here

Bug reporting is disabled by default — it only activates when BUG_REPORT_TOKEN is set. Reports are sent asynchronously (fire and forget) and never block the main application.

Discussion