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.