n8n-nodes-mcp-stockly-api

n8n node for Django REST API integration with MCP support for inventory management.

Features

• 🔌 Direct API integration - No server needed, works directly in n8n
• 🧰 Reusable tool library for creating, listing, updating, and deleting products
• ⚙️ Configurable via environment variables with first-class support for .env files
• 🚀 n8n-ready npm package that can be used directly in workflows

Installation

npm install n8n-nodes-mcp-stockly-api

Configuration

Create a .env file or provide the following environment variables:

API_BASE_URL=https://api.encryptosystem.com/api
AUTH_BEARER_TOKEN=your-admin-bearer-token
API_TIMEOUT=30000

Usage

Method 1: Direct Import in n8n

// في n8n Code node
import { executeStocklyOperation } from 'n8n-nodes-mcp-stockly-api';

// إنشاء منتج
const result = await executeStocklyOperation('createProduct', {
  name: 'Test Product',
  price: 100,
  quantity: 50,
  description: 'Test product description'
});

// عرض المنتجات
const products = await executeStocklyOperation('listProducts', {
  page: 1,
  page_size: 10,
  search: 'test'
});

// تحديث المخزون
const stockUpdate = await executeStocklyOperation('updateStock', {
  productId: 123,
  quantity: 75
});

// حذف منتج
const deleteResult = await executeStocklyOperation('deleteProduct', {
  productId: 123
});

return result;

Method 2: Using Tools Directly

// في n8n Code node
import { stocklyApiTools } from 'n8n-nodes-mcp-stockly-api';

// استخدام الأدوات مباشرة
const result = await stocklyApiTools.createProduct({
  name: 'New Product',
  price: 50,
  quantity: 25
});

return result;

Method 3: Traditional MCP Server (Optional)

If you still want to use the MCP server approach:

# Start the MCP server
API_BASE_URL=https://api.encryptosystem.com/api AUTH_BEARER_TOKEN=demo-token PORT=8080 npx n8n-nodes-mcp-stockly-api start

# List available tools
API_BASE_URL=https://api.encryptosystem.com/api AUTH_BEARER_TOKEN=demo-token PORT=8080 npx n8n-nodes-mcp-stockly-api list-tools

Available Operations

• createProduct - Create a new product in the inventory system
• listProducts - List all products with optional filtering and pagination
• updateStock - Update the stock quantity for a product
• deleteProduct - Delete a product by identifier

Parameters

createProduct

• name (string, required) - Product name
• price (number, required) - Product price
• quantity (number, required) - Initial quantity
• sku (string, optional) - Product SKU
• description (string, optional) - Product description
• cost_price (number, optional) - Cost price
• wholesale_price (number, optional) - Wholesale price
• retail_price (number, optional) - Retail price
• category_id (number, optional) - Category ID
• category_name (string, optional) - Category name

listProducts

• page (number, optional) - Page number (default: 1)
• page_size (number, optional) - Items per page (default: 10)
• search (string, optional) - Search term
• category_id (number, optional) - Filter by category

updateStock

• productId (number, required) - Product ID
• quantity (number, required) - New quantity

deleteProduct

• productId (number, required) - Product ID

Response Format

All operations return:

{
  success: true/false,
  data: {}, // API response data
  message: "Operation completed successfully",
  error: {} // Error details if success is false
}

Development

# Install dependencies
npm install

# Build the package
npm run build

# Run in development mode
npm run dev

Publishing

# Login to npm
npm login

# Bump version
npm version patch

# Publish
npm publish --access public

License

MIT © Encryptosystem