@ktmcp-cli/nordigen 1.0.0 → 1.0.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 KTMCP
+Copyright (c) 2026 Tom Granot
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,12 +1,11 @@
-# Nordigen CLI
-
-<p align="center">
-  <img src="banner.png" alt="KTMCP Banner" width="100%">
-</p>
+![Banner](https://raw.githubusercontent.com/ktmcp-cli/nordigen/main/banner.svg)
 
+# Nordigen CLI
 
 Production-ready command-line interface for the Nordigen Account Information Services API (Open Banking).
 
+> **⚠️ Unofficial CLI** - This tool is not officially sponsored, endorsed, or maintained by Nordigen (GoCardless). It is an independent project built on the public Nordigen API. Official site: https://nordigen.com | API docs: https://nordigen.com/en/account_information_documenation/integration/
+
 ## Features
 
 - Complete coverage of Nordigen API v2
@@ -263,162 +262,5 @@ nordigen institutions list --country GB --json | jq '.[].name'
 Configuration is stored securely in:
 
 - **Linux/macOS**: `~/.config/nordigen-cli/config.json`
-- **Windows**: `%APPDATA%\nordigen-cli\config.json`
-
-The config file has permissions set to `0600` (read/write for owner only).
-
-## Error Handling
-
-The CLI provides detailed error messages with exit codes:
-
-- `0` - Success
-- `1` - General error
-- `400` - Bad request / validation error
-- `401` - Authentication error
-- `403` - Permission denied
-- `404` - Resource not found
-- `429` - Rate limit exceeded
-- `500` - Server error
-
-Enable debug output for detailed stack traces:
-
-```bash
-DEBUG=1 nordigen accounts get <ACCOUNT_ID>
-```
-
-## Common Workflows
-
-### Complete Bank Connection Flow
-
-```bash
-# 1. Find the institution
-nordigen institutions search "Your Bank" --country GB
-
-# 2. Create end user agreement
-nordigen agreements create --institution-id <INST_ID> --max-days 90
-
-# 3. Create requisition
-nordigen requisitions create \
-  --institution-id <INST_ID> \
-  --redirect https://yourapp.com/callback \
-  --agreement <AGREEMENT_ID>
-
-# 4. Send the returned link to your user for authentication
-
-# 5. After user authenticates, retrieve accounts
-nordigen requisitions get <REQUISITION_ID>
-
-# 6. Access account data
-nordigen accounts balances <ACCOUNT_ID>
-nordigen accounts transactions <ACCOUNT_ID>
-```
-
-### Batch Processing Accounts
-
-```bash
-# Get all requisitions as JSON
-nordigen requisitions list --json > requisitions.json
-
-# Extract account IDs and fetch transactions
-cat requisitions.json | jq -r '.results[].accounts[]' | while read account; do
-  echo "Fetching transactions for $account"
-  nordigen accounts transactions $account --json > "transactions_${account}.json"
-done
-```
-
-## Why CLI > MCP?
-
-### Performance
-- **CLI**: Direct execution, no protocol overhead, instant responses
-- **MCP**: Additional network/IPC layer, serialization overhead, slower responses
-
-### Simplicity
-- **CLI**: Simple command invocation, standard UNIX patterns, easy to compose
-- **MCP**: Requires server setup, protocol understanding, more moving parts
-
-### Debugging
-- **CLI**: Standard stdout/stderr, easy to debug with DEBUG flag
-- **MCP**: Protocol messages, requires MCP-specific debugging tools
-
-### Integration
-- **CLI**: Works with any language via subprocess, easy shell scripting
-- **MCP**: Requires MCP client library, limited language support
-
-### Portability
-- **CLI**: Single binary/script, runs anywhere with Node.js
-- **MCP**: Requires MCP server runtime, more dependencies
-
-### Use Cases
-
-**Use CLI when:**
-- Building scripts and automation
-- One-off data retrieval tasks
-- Integrating with existing shell workflows
-- Debugging API responses
-- Human interaction needed
-
-**Use MCP when:**
-- Building persistent AI agent applications
-- Need stateful server connections
-- Multiple AI tools need shared context
-- Protocol-level features required
-
-## Troubleshooting
-
-### Token Expired
-
-```bash
-# Check authentication status
-nordigen auth status
-
-# Re-login if needed
-nordigen auth login --secret-id <id> --secret-key <key>
-```
-
-### Rate Limiting
-
-If you hit rate limits, the API will return a 429 error. Wait and retry, or implement exponential backoff in your scripts.
-
-### Account Access Errors
-
-Ensure:
-1. Valid End User Agreement exists
-2. Agreement has correct access scope
-3. User has completed authentication flow
-4. Access period hasn't expired
-
-## API Documentation
-
-For complete API reference, see:
-- Official Nordigen Docs: https://nordigen.com/en/docs/
-- OpenAPI Spec: https://ob.nordigen.com/api/swagger/
-
-## Development
-
-```bash
-# Install dependencies
-npm install
-
-# Run tests
-npm test
-
-# Lint code
-npm run lint
-
-# Make executable
-chmod +x bin/nordigen.js
-```
-
-## License
-
-MIT
-
-## Support
-
-- GitHub Issues: https://github.com/ktmcp/nordigen-cli/issues
-- Email: support@ktmcp.com
-
-## Related Documentation
-
-- [AGENT.md](./AGENT.md) - AI agent integration patterns
-- [OPENCLAW.md](./OPENCLAW.md) - OpenClaw integration guide
+- **Windows**: `%APPDATA%
+ordigen-cli

package/banner.svg

@@ -0,0 +1,25 @@
+<svg width="1200" height="300" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#0a0a0a;stop-opacity:1" />
+      <stop offset="100%" style="stop-color:#1a1a1a;stop-opacity:1" />
+    </linearGradient>
+  </defs>
+
+  <rect width="1200" height="300" fill="url(#bg)"/>
+  <rect x="0" y="0" width="8" height="300" fill="#00ff7f"/>
+
+  <text x="60" y="100" font-family="system-ui, -apple-system, sans-serif" font-size="72" font-weight="800" fill="#ffffff">Nordigen CLI</text>
+  <text x="60" y="150" font-family="system-ui, -apple-system, sans-serif" font-size="28" fill="#888888">Open banking & financial data</text>
+
+  <rect x="60" y="190" width="600" height="60" rx="8" fill="#1e1e1e"/>
+  <text x="90" y="230" font-family="monospace" font-size="20" fill="#00ff7f">npm install -g @ktmcp-cli/nordigen</text>
+
+  <!-- Terminal window badge -->
+  <rect x="980" y="100" width="180" height="100" rx="4" fill="#0a0e0f" stroke="#0ff7f" stroke-width="2"/>
+  <circle cx="995" cy="115" r="3" fill="#ff5f56"/>
+  <circle cx="1010" cy="115" r="3" fill="#ffbd2e"/>
+  <circle cx="1025" cy="115" r="3" fill="#27c93f"/>
+  <text x="1070" y="150" font-family="monospace" font-size="14" fill="#8b9d9f" text-anchor="middle">$ kill -9</text>
+  <text x="1070" y="180" font-family="monospace" font-size="24" font-weight="900" fill="#00ff7f" text-anchor="middle">MCP</text>
+</svg>

package/bin/nordigen.js

@@ -1,5 +1,8 @@
 #!/usr/bin/env node
 
+const { showWelcomeMessage } = require('../src/lib/welcome');
+showWelcomeMessage('nordigen');
+
 /**
  * Nordigen CLI - Production-ready command-line interface for Nordigen API
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ktmcp-cli/nordigen",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Production-ready CLI for Nordigen Account Information Services API (Open Banking)",
   "main": "src/index.js",
   "type": "module",

package/src/lib/welcome.js

@@ -0,0 +1,47 @@
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+function showWelcomeMessage(cliName) {
+  const configDir = path.join(os.homedir(), `.${cliName}`);
+  const welcomeFile = path.join(configDir, '.welcome-shown');
+
+  // Check if welcome was already shown
+  if (fs.existsSync(welcomeFile)) {
+    return; // Already shown
+  }
+
+  // Show welcome message
+  console.log('\n╔════════════════════════════════════════════════════════════╗');
+  console.log('║                                                            ║');
+  console.log('║  👋 Welcome to the Kill The MCP Project!                  ║');
+  console.log('║                                                            ║');
+  console.log('║  This CLI is part of KTMCP - a project that generates     ║');
+  console.log('║  production-ready command-line tools for APIs.             ║');
+  console.log('║                                                            ║');
+  console.log('║  🎯 Why CLI over MCP?                                     ║');
+  console.log('║     • Faster: Direct API calls, no server overhead        ║');
+  console.log('║     • Cheaper: No tokens, no server costs                 ║');
+  console.log('║     • Simpler: Standard Unix tools, pipe & compose        ║');
+  console.log('║     • Deterministic: Same input = same output             ║');
+  console.log('║                                                            ║');
+  console.log('║  🤖 Perfect for AI Agents!                                ║');
+  console.log('║     Agents can use these CLIs directly via bash commands  ║');
+  console.log('║     without needing MCP server setup.                     ║');
+  console.log('║                                                            ║');
+  console.log('║  📚 Learn more: https://killthemcp.com                    ║');
+  console.log('║                                                            ║');
+  console.log('╚════════════════════════════════════════════════════════════╝\n');
+
+  // Create config dir and mark as shown
+  try {
+    if (!fs.existsSync(configDir)) {
+      fs.mkdirSync(configDir, { recursive: true });
+    }
+    fs.writeFileSync(welcomeFile, new Date().toISOString());
+  } catch (err) {
+    // Silently fail if can't create file
+  }
+}
+
+module.exports = { showWelcomeMessage };