n8n Plug Database Nodes

1.1.2 verified Sat May 09 auth: no javascript

n8n community package providing REST-only nodes for the Plug Database blockchain API. Current stable version is 1.1.2, released with patch updates for icons and navigation. It consolidates SQL execution, client access, and user access management into a single node with resource-based navigation, supporting operations like Execute SQL, Request Agent Access, and Approve Access Request. Key differentiators: fixed API base URL, support for both guided and advanced JSON-RPC modes, pagination via Return All, and credential override per node. No socket or realtime trigger support in v1.

Common errors

error Cannot find module 'n8n-nodes-plug-database/credentials/PlugDatabaseApi.credentials' ↓

cause Import path typo or missing file in the package.

fix

Use correct path: 'n8n-nodes-plug-database/credentials/PlugDatabaseApi.credentials'

error Error: Plug Database API returned 401 Unauthorized ↓

cause Invalid or missing credentials; email/password wrong or expired.

fix

Verify user email and password in the credentials dialog, and ensure the account has access.

error Error: Agent ID is required for this operation ↓

cause No Agent ID provided via node field or credential default.

fix

Set the Agent ID either in the node's 'Agent ID' field or in the credential's 'Default Agent ID'.

error The node type "Plug Database" is not known ↓

cause n8n instance may not have the package installed or the community node is not approved.

fix

Install the package via npm install n8n-nodes-plug-database and restart n8n, or check admin settings for community node approval.

Warnings

break Legacy access-only nodes are hidden from new workflows; existing workflows using them will continue to work but new users must use the consolidated node. ↓

fix Switch to the consolidated 'Plug Database' node and use Resource-based navigation.

gotcha The API base URL is fixed to https://plug-server.se7esistemassinop.com.br/api/v1 and cannot be changed via credentials or node settings. ↓

fix Ensure your Plug Database server is accessible at that URL; no customization available.

gotcha No socket transport or realtime triggers are supported in v1; all operations are REST-only. ↓

fix Poll for changes via scheduled workflows or wait for future versions with socket support.

gotcha Execute Batch runs over REST only; it may be slower than a single SQL execution for large batches. ↓

fix Consider splitting large batches into smaller sets or use Execute SQL for fewer statements.

Install

npm install n8n-nodes-plug-database

yarn add n8n-nodes-plug-database

pnpm add n8n-nodes-plug-database

Imports

Plug Database

wrong

import PlugDatabaseApi from 'n8n-nodes-plug-database'

correct

import { Plug Database } from 'n8n-nodes-plug-database/credentials/PlugDatabaseApi.credentials'

Credentials are exported from a separate path; do not import from the main package index

PlugDatabaseNode

wrong

import { PlugDatabase } from 'n8n-nodes-plug-database'

correct

import { PlugDatabaseNode } from 'n8n-nodes-plug-database/nodes/PlugDatabase/PlugDatabase.node'

The node class is exported from a nested path; the package index does not export it directly

PlugDatabaseApi

wrong

import { PlugDatabaseApi } from 'n8n-nodes-plug-database'

correct

import { PlugDatabaseApi } from 'n8n-nodes-plug-database/credentials/PlugDatabaseApi.credentials'

Credentials are not re-exported from the package root

Quickstart

Demonstrates creating a Plug Database node, setting credentials, and executing a SQL query with aggregated JSON output.

// Install: npm install n8n-nodes-plug-database
// In n8n UI, add a 'Plug Database' node
// Credentials: fill User (email), Password, optional Default Agent ID, optional Default Client Token
// Example: Execute SQL
// Create a node with:
// Resource: SQL
// Operation: Execute SQL
// Agent ID: (override or leave empty to use credential default)
// SQL Query: SELECT * FROM agents;
// Output: Aggregated JSON
// The node returns one item per row.
// For listing agents: Resource: Client Access, Operation: List Client Agents, Return All: true