aiprox-workflows-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 LPX Digital Group LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,158 @@
+# aiprox-workflows-mcp
+
+<a href="https://glama.ai/mcp/servers/unixlamadev-spec/aiprox-workflows-mcp">
+<img width="380" height="200" src="https://glama.ai/mcp/servers/unixlamadev-spec/aiprox-workflows-mcp/badge" alt="AIProx Workflows MCP Server" />
+</a>
+
+MCP server for [AIProx Workflows](https://aiprox.dev/workflows) — create and run multi-agent pipelines from Claude Desktop. Chain AI agents into scheduled workflows. Pay per execution in sats.
+
+## Install
+
+```bash
+npx aiprox-workflows-mcp
+```
+
+## What AIProx Workflows Is
+
+AIProx is an agent registry with a built-in workflow engine. You chain agents by capability into pipelines — each step passes its result to the next. Workflows can run on demand or on a schedule. Execution costs are deducted from your Lightning spend token in sats. No accounts, no monthly subscriptions.
+
+**Available agent capabilities:** web-search, sentiment-analysis, scraping, data-analysis, translation, vision, code-execution, email, market-data, token-analysis
+
+## Setup
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "aiprox-workflows": {
+      "command": "npx",
+      "args": ["aiprox-workflows-mcp"],
+      "env": {
+        "AIPROX_SPEND_TOKEN": "lnpx_your_token_here"
+      }
+    }
+  }
+}
+```
+
+Get a spend token at [lightningprox.com](https://lightningprox.com).
+
+### Cursor
+
+Add to Cursor MCP settings with the same JSON above.
+
+---
+
+## Tools
+
+### `create_workflow`
+
+Create a new multi-agent pipeline.
+
+```
+Create a workflow named "daily-intel" that:
+1. Searches for the latest AI news
+2. Analyzes sentiment
+3. Emails me a daily summary
+Schedule it @daily
+```
+
+### `run_workflow`
+
+Trigger a workflow by ID.
+
+```
+Run workflow wf_abc123
+```
+
+### `list_workflows`
+
+List all your workflows and their status.
+
+```
+List my workflows
+```
+
+### `get_run_history`
+
+Get past execution results and sats spent.
+
+```
+Show run history for workflow wf_abc123
+```
+
+### `delete_workflow`
+
+Delete a workflow (also cancels scheduled runs).
+
+```
+Delete workflow wf_abc123
+```
+
+### `run_template`
+
+Run a pre-built template by name. Creates the workflow and runs it immediately.
+
+```
+Run the news-digest template and email results to me@example.com
+```
+
+**Available templates:**
+
+| Template | Agents | Cost |
+|---|---|---|
+| `news-digest` | search-bot → sentiment-bot → email-bot | ~150 sats |
+| `token-scanner` | data-spider → isitarug → email-bot | ~120 sats |
+| `competitive-intel` | search-bot → doc-miner → sentiment-bot → email-bot | ~200 sats |
+| `multilingual-content` | data-spider → doc-miner → polyglot | ~180 sats |
+| `site-audit` | vision-bot → code-auditor → doc-miner | ~220 sats |
+| `polymarket-signals` | market-oracle → sentiment-bot → email-bot | ~160 sats |
+
+---
+
+## Example Conversation
+
+```
+You: Run the news-digest template and email results to alice@example.com
+
+Claude: I'll run the Daily Bitcoin News Digest template now.
+
+[calls run_template with template="news-digest", notify_email="alice@example.com"]
+
+🚀 Template "news-digest" running
+
+Template: Daily Bitcoin News Digest
+Steps: web-search → sentiment-analysis → email
+
+Run ID: run_xyz789
+Status: running
+Sats spent: 147 sats
+```
+
+---
+
+## Environment Variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `AIPROX_SPEND_TOKEN` | ✅ | Lightning spend token (`lnpx_...`) |
+| `AIPROX_URL` | ❌ | Override API URL (default: `https://aiprox.dev`) |
+
+---
+
+## Pricing
+
+50–220 sats per workflow run depending on agents used and step count. No monthly fee.
+
+---
+
+## Links
+
+- Dashboard: [aiprox.dev/workflows](https://aiprox.dev/workflows)
+- Templates: [aiprox.dev/templates](https://aiprox.dev/templates)
+- Registry: [aiprox.dev/registry.html](https://aiprox.dev/registry.html)
+- Spend tokens: [lightningprox.com](https://lightningprox.com)
+- npm SDK: [aiprox-workflows](https://www.npmjs.com/package/aiprox-workflows)

package/dist/index.js

@@ -0,0 +1,443 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * AIProx Workflows MCP Server
+ * Create and run multi-agent workflows from Claude Desktop.
+ * Pay per execution in sats via Lightning spend token.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const AIPROX_URL = process.env.AIPROX_URL || "https://aiprox.dev";
+const SPEND_TOKEN = process.env.AIPROX_SPEND_TOKEN || "";
+if (!SPEND_TOKEN) {
+    console.error("❌ AIPROX_SPEND_TOKEN environment variable is required");
+    console.error("   Set it to your Lightning spend token (lnpx_...)");
+    console.error("   Get a token at: https://lightningprox.com");
+    console.error("   Example: AIPROX_SPEND_TOKEN=lnpx_... npx aiprox-workflows-mcp");
+    process.exit(1);
+}
+// Pre-built templates — Claude can reference these by name
+const TEMPLATES = {
+    "news-digest": {
+        name: "Daily Bitcoin News Digest",
+        steps: [
+            { capability: "web-search", input: "Search for the latest Bitcoin news and developments today. Get the top 5-10 stories." },
+            { capability: "sentiment-analysis", input: "$step1.result — Analyze sentiment and summarize key themes from these Bitcoin news stories." },
+            { capability: "email", input: "$step2.result — Format as a daily Bitcoin news digest email and send." },
+        ],
+        schedule: "@daily",
+    },
+    "token-scanner": {
+        name: "Token Safety Scanner",
+        steps: [
+            { capability: "scraping", input: "Scrape token data and on-chain metrics for risk analysis." },
+            { capability: "data-analysis", input: "$step1.result — Analyze for rug pull signals, liquidity risks, and red flags." },
+            { capability: "email", input: "$step2.result — Send token safety report to email." },
+        ],
+        schedule: "",
+    },
+    "competitive-intel": {
+        name: "Competitive Intelligence Brief",
+        steps: [
+            { capability: "web-search", input: "Research the company: news, funding rounds, product launches, and market position." },
+            { capability: "data-analysis", input: "$step1.result — Extract key facts, financials, and strategic moves." },
+            { capability: "sentiment-analysis", input: "$step2.result — Analyze market sentiment and competitive positioning." },
+            { capability: "email", input: "$step3.result — Format as a competitive intelligence brief and send." },
+        ],
+        schedule: "@daily",
+    },
+    "multilingual-content": {
+        name: "Multilingual Content Pipeline",
+        steps: [
+            { capability: "scraping", input: "Scrape and extract the main content from the target URL." },
+            { capability: "data-analysis", input: "$step1.result — Summarize the key points and main message of this content." },
+            { capability: "translation", input: "$step2.result — Translate this summary to the target language." },
+        ],
+        schedule: "",
+    },
+    "site-audit": {
+        name: "Visual Site Audit",
+        steps: [
+            { capability: "vision", input: "Analyze this webpage for design quality, visual hierarchy, and UX issues." },
+            { capability: "code-execution", input: "$step1.result — Audit code structure, accessibility, and technical issues." },
+            { capability: "data-analysis", input: "$step2.result — Compile a comprehensive site audit with actionable recommendations." },
+        ],
+        schedule: "",
+    },
+    "polymarket-signals": {
+        name: "Polymarket Signal Digest",
+        steps: [
+            { capability: "data-analysis", input: "Fetch and analyze the latest Polymarket prediction market signals, top markets by volume, and notable probability shifts." },
+            { capability: "sentiment-analysis", input: "$step1.result — Identify key trends and trading signals from these prediction markets." },
+            { capability: "email", input: "$step2.result — Format as a daily Polymarket signal digest and send." },
+        ],
+        schedule: "@daily",
+    },
+};
+// ============================================================================
+// TOOL DEFINITIONS
+// ============================================================================
+const tools = [
+    {
+        name: "create_workflow",
+        description: "Create a new AIProx workflow — a multi-agent pipeline that chains AI agent steps. " +
+            "Each step specifies a capability and input. Use $step1.result, $step2.result etc. to chain outputs. " +
+            "Returns a workflow_id you can use to run or manage the workflow.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Workflow name (e.g. 'daily-intel', 'token-scanner')",
+                },
+                steps: {
+                    type: "array",
+                    description: "Ordered list of agent steps",
+                    items: {
+                        type: "object",
+                        properties: {
+                            capability: {
+                                type: "string",
+                                description: "Agent capability: web-search | sentiment-analysis | scraping | data-analysis | translation | vision | code-execution | email | market-data | token-analysis",
+                            },
+                            input: {
+                                type: "string",
+                                description: "Task input. Use $step1.result, $step2.result etc. to chain from previous steps.",
+                            },
+                        },
+                        required: ["capability", "input"],
+                    },
+                },
+                schedule: {
+                    type: "string",
+                    description: "Optional cron schedule: @hourly, @daily, @weekly, or cron expression like '0 9 * * *'",
+                },
+                notify_email: {
+                    type: "string",
+                    description: "Optional email address to notify after each run",
+                },
+                webhook_url: {
+                    type: "string",
+                    description: "Optional webhook URL to POST results to after each run",
+                },
+            },
+            required: ["name", "steps"],
+        },
+    },
+    {
+        name: "run_workflow",
+        description: "Trigger an existing AIProx workflow by ID. Returns run status and receipt.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                workflow_id: {
+                    type: "string",
+                    description: "The workflow ID to run (e.g. 'wf_abc123')",
+                },
+            },
+            required: ["workflow_id"],
+        },
+    },
+    {
+        name: "list_workflows",
+        description: "List all workflows associated with your spend token.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: "get_run_history",
+        description: "Get the run history for a specific workflow, including past execution results and sats spent.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                workflow_id: {
+                    type: "string",
+                    description: "The workflow ID to get run history for",
+                },
+            },
+            required: ["workflow_id"],
+        },
+    },
+    {
+        name: "delete_workflow",
+        description: "Delete an AIProx workflow by ID. This also cancels any scheduled runs.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                workflow_id: {
+                    type: "string",
+                    description: "The workflow ID to delete",
+                },
+            },
+            required: ["workflow_id"],
+        },
+    },
+    {
+        name: "run_template",
+        description: "Run a pre-built workflow template by name. Creates the workflow and triggers it immediately. " +
+            "Available templates: news-digest, token-scanner, competitive-intel, multilingual-content, site-audit, polymarket-signals",
+        inputSchema: {
+            type: "object",
+            properties: {
+                template: {
+                    type: "string",
+                    description: "Template name: news-digest | token-scanner | competitive-intel | multilingual-content | site-audit | polymarket-signals",
+                },
+                notify_email: {
+                    type: "string",
+                    description: "Optional email address to receive results",
+                },
+                schedule: {
+                    type: "string",
+                    description: "Optional schedule override (e.g. '@daily'). Defaults to template's built-in schedule.",
+                },
+            },
+            required: ["template"],
+        },
+    },
+];
+// ============================================================================
+// API HELPERS
+// ============================================================================
+async function apiPost(path, body) {
+    const res = await fetch(`${AIPROX_URL}${path}`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "X-Spend-Token": SPEND_TOKEN,
+        },
+        body: JSON.stringify({ ...body, spend_token: SPEND_TOKEN }),
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        let msg = text;
+        try {
+            msg = JSON.parse(text).error || text;
+        }
+        catch { }
+        if (res.status === 402)
+            throw new Error(`Insufficient balance. Top up at lightningprox.com`);
+        if (res.status === 401)
+            throw new Error(`Invalid spend token. Get one at lightningprox.com`);
+        throw new Error(`AIProx API error ${res.status}: ${msg}`);
+    }
+    return res.json();
+}
+async function apiGet(path) {
+    const res = await fetch(`${AIPROX_URL}${path}`, {
+        headers: { "X-Spend-Token": SPEND_TOKEN },
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        let msg = text;
+        try {
+            msg = JSON.parse(text).error || text;
+        }
+        catch { }
+        throw new Error(`AIProx API error ${res.status}: ${msg}`);
+    }
+    return res.json();
+}
+async function apiDelete(path) {
+    const res = await fetch(`${AIPROX_URL}${path}`, {
+        method: "DELETE",
+        headers: { "X-Spend-Token": SPEND_TOKEN },
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        let msg = text;
+        try {
+            msg = JSON.parse(text).error || text;
+        }
+        catch { }
+        throw new Error(`AIProx API error ${res.status}: ${msg}`);
+    }
+    return res.json();
+}
+function formatWorkflow(w) {
+    return [
+        `ID: ${w.workflow_id || w.id}`,
+        `Name: ${w.name}`,
+        `Steps: ${w.steps_count ?? "?"}`,
+        `Schedule: ${w.schedule || "manual"}`,
+        `Status: ${w.status || "?"}`,
+        w.last_run_at ? `Last run: ${w.last_run_at}` : null,
+        w.next_run_at ? `Next run: ${w.next_run_at}` : null,
+    ].filter(Boolean).join("\n");
+}
+function formatRun(r) {
+    const agents = Array.isArray(r.agents_used) ? r.agents_used.join(", ") : (r.agents_used || "—");
+    return [
+        `Run ID: ${r.run_id || r.id}`,
+        `Status: ${r.status}`,
+        `Sats spent: ${r.sats_spent != null ? r.sats_spent + " sats" : "—"}`,
+        `Agents: ${agents}`,
+        r.result ? `\nResult preview:\n${String(r.result).slice(0, 400)}` : null,
+    ].filter(Boolean).join("\n");
+}
+// ============================================================================
+// MCP SERVER
+// ============================================================================
+const server = new index_js_1.Server({ name: "aiprox-workflows", version: "1.0.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({ tools }));
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case "create_workflow": {
+                const { name: wfName, steps, schedule, notify_email, webhook_url } = args;
+                const payload = {
+                    name: wfName,
+                    steps: steps.map((s, i) => ({ step: i + 1, ...s })),
+                };
+                if (schedule)
+                    payload.schedule = schedule;
+                if (notify_email)
+                    payload.notify_email = notify_email;
+                if (webhook_url)
+                    payload.webhook_url = webhook_url;
+                const result = await apiPost("/api/workflows", payload);
+                const id = result.workflow_id || result.id;
+                return {
+                    content: [{
+                            type: "text",
+                            text: [
+                                `✅ Workflow created`,
+                                ``,
+                                formatWorkflow(result),
+                                ``,
+                                `Run it: use run_workflow with workflow_id="${id}"`,
+                                `Dashboard: https://aiprox.dev/workflows`,
+                            ].join("\n"),
+                        }],
+                };
+            }
+            case "run_workflow": {
+                const { workflow_id } = args;
+                const result = await apiPost(`/api/workflows/${workflow_id}/run`, {});
+                return {
+                    content: [{
+                            type: "text",
+                            text: [
+                                `⚡ Workflow triggered`,
+                                ``,
+                                formatRun(result),
+                            ].join("\n"),
+                        }],
+                };
+            }
+            case "list_workflows": {
+                const data = await apiGet("/api/workflows");
+                const list = data.workflows || data || [];
+                if (!list.length) {
+                    return {
+                        content: [{
+                                type: "text",
+                                text: "No workflows found. Create one with create_workflow.\n\nBrowse templates: https://aiprox.dev/templates",
+                            }],
+                    };
+                }
+                return {
+                    content: [{
+                            type: "text",
+                            text: [
+                                `📋 Your Workflows (${list.length})`,
+                                ``,
+                                list.map(formatWorkflow).join("\n\n---\n\n"),
+                                ``,
+                                `Dashboard: https://aiprox.dev/workflows`,
+                            ].join("\n"),
+                        }],
+                };
+            }
+            case "get_run_history": {
+                const { workflow_id } = args;
+                const data = await apiGet(`/api/workflows/${workflow_id}/runs`);
+                const runs = data.runs || data || [];
+                if (!runs.length) {
+                    return {
+                        content: [{ type: "text", text: `No runs found for workflow ${workflow_id}.` }],
+                    };
+                }
+                return {
+                    content: [{
+                            type: "text",
+                            text: [
+                                `📊 Run History for ${workflow_id} (${runs.length} runs)`,
+                                ``,
+                                runs.slice(0, 5).map(formatRun).join("\n\n---\n\n"),
+                            ].join("\n"),
+                        }],
+                };
+            }
+            case "delete_workflow": {
+                const { workflow_id } = args;
+                await apiDelete(`/api/workflows/${workflow_id}`);
+                return {
+                    content: [{
+                            type: "text",
+                            text: `🗑️ Workflow ${workflow_id} deleted successfully.`,
+                        }],
+                };
+            }
+            case "run_template": {
+                const { template, notify_email, schedule: scheduleOverride } = args;
+                const tpl = TEMPLATES[template];
+                if (!tpl) {
+                    const available = Object.keys(TEMPLATES).join(", ");
+                    throw new Error(`Unknown template "${template}". Available: ${available}`);
+                }
+                const payload = {
+                    name: tpl.name,
+                    steps: tpl.steps.map((s, i) => ({ step: i + 1, ...s })),
+                    schedule: scheduleOverride || tpl.schedule || undefined,
+                };
+                if (notify_email)
+                    payload.notify_email = notify_email;
+                const created = await apiPost("/api/workflows", payload);
+                const workflowId = created.workflow_id || created.id;
+                const runResult = await apiPost(`/api/workflows/${workflowId}/run`, {});
+                return {
+                    content: [{
+                            type: "text",
+                            text: [
+                                `🚀 Template "${template}" running`,
+                                ``,
+                                `Template: ${tpl.name}`,
+                                `Steps: ${tpl.steps.map(s => s.capability).join(" → ")}`,
+                                ``,
+                                formatRun(runResult),
+                                ``,
+                                `View all templates: https://aiprox.dev/templates`,
+                            ].join("\n"),
+                        }],
+                };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        return {
+            content: [{ type: "text", text: `❌ Error: ${error.message}` }],
+            isError: true,
+        };
+    }
+});
+// ============================================================================
+// START
+// ============================================================================
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error(`✅ AIProx Workflows MCP Server running | Token: ${SPEND_TOKEN.slice(0, 8)}...`);
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});

package/glama.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://glama.ai/mcp/schemas/server.json",
+  "maintainers": ["unixlamadev-spec"]
+}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "aiprox-workflows-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for AIProx Workflows — create and run multi-agent pipelines from Claude Desktop. Pay per execution in sats.",
+  "main": "dist/index.js",
+  "bin": {
+    "aiprox-workflows-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "start": "node dist/index.js",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "aiprox",
+    "workflows",
+    "agents",
+    "ai",
+    "automation",
+    "bitcoin",
+    "lightning",
+    "sats",
+    "multi-agent",
+    "orchestration",
+    "model-context-protocol"
+  ],
+  "author": "LPX Digital Group LLC",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/unixlamadev-spec/aiprox-workflows-mcp"
+  },
+  "homepage": "https://aiprox.dev/workflows",
+  "bugs": {
+    "url": "https://github.com/unixlamadev-spec/aiprox-workflows-mcp/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "ts-node": "^10.9.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE",
+    "glama.json"
+  ]
+}