@gmpsignal/mcp-server 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,45 @@
-# Temporary Holding Version
+# `gmpsignal-mcp` — Official MCP Server Launcher for GMPSignal's 40 Apify Intelligence APIs
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Connect **40 production-grade JSON APIs & Apify Actors** by **[GMPSignal (`@gmpsignal`)](https://apify.com/gmpsignal)** directly into **Claude Desktop, Cursor, Windsurf, and MCP-compatible AI Agents** with a single command.
+
+---
+
+## Quick Usage
+
+### 1. Print Ready-to-Paste Claude Desktop / Cursor MCP Config
+```bash
+npx gmpsignal-mcp --print-config --suite flagship
+```
+
+### 2. List All 40 Actors by Vertical Suite
+```bash
+npx gmpsignal-mcp --list
+```
+
+### 3. Run Directly as an MCP Server in `claude_desktop_config.json` or `.cursor/mcp.json`
+```json
+{
+  "mcpServers": {
+    "gmpsignal": {
+      "command": "npx",
+      "args": ["-y", "gmpsignal-mcp", "--suite", "flagship"],
+      "env": {
+        "APIFY_TOKEN": "<YOUR_APIFY_API_TOKEN>"
+      }
+    }
+  }
+}
+```
+
+---
+
+## Available `--suite` Presets
+
+| Suite Name | Included Intelligence Tools |
+|---|---|
+| `flagship` *(Default)* | Top 11 global Actors: DEX Security Auditor, Crypto OrderBook Arbitrage, Multi-Chain Wallet AML, DeFi Yield/TVL, Polymarket/Kalshi Odds, B2B Tech-Stack & Contacts, Global Sanctions/GLEIF KYB, CISA KEV + EPSS Cyber, YC/GitHub Startup Radar, OpenAlex Scientific R&D, and Shopify Store Scraper |
+| `crypto` | 6 Quantitative Crypto, DeFi, OrderBook, Wallet AML & Prediction Market Actors |
+| `b2b` | 4 B2B Lead Enrichment, Shopify E-Commerce, VC Deal-Flow & European Jobs Actors |
+| `compliance` | 8 KYB/Sanctions, CISA KEV Cybersecurity, OpenAlex R&D, SEC EDGAR, FDA & EU TED Actors |
+| `regional` | 22 Seismic, Central Bank FX, Balkan Marketplace & Regional Mobility Actors |
+| `all` | All 40 GMPSignal Apify Actors |

package/bin/cli.mjs

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * @file cli.mjs
+ * @description Command-line launcher for the GMPSignal Model Context Protocol (MCP) Server.
+ * Spawns @apify/actors-mcp-server preconfigured with GMPSignal intelligence suites or prints
+ * ready-to-paste Claude Desktop / Cursor MCP configuration blocks.
+ */
+
+import { spawn } from 'node:child_process';
+import { GMPSIGNAL_SUITES, resolveActorsForSuite, buildMcpServerConfig } from '../index.mjs';
+
+/**
+ * Parses command-line arguments passed to gmpsignal-mcp.
+ *
+ * @param {Array<string>} argv - Process argv slice.
+ * @returns {{ suite: string, customActors: string, listOnly: boolean, printConfig: boolean }} Parsed CLI flags.
+ */
+function parseCliArgs(argv) {
+    let suite = 'flagship';
+    let customActors = '';
+    let listOnly = false;
+    let printConfig = false;
+
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === '--suite' && argv[i + 1]) {
+            suite = argv[i + 1];
+            i += 1;
+        } else if (arg === '--actors' && argv[i + 1]) {
+            customActors = argv[i + 1];
+            i += 1;
+        } else if (arg === '--list') {
+            listOnly = true;
+        } else if (arg === '--print-config') {
+            printConfig = true;
+        }
+    }
+
+    return { suite, customActors, listOnly, printConfig };
+}
+
+/**
+ * Main CLI execution entry point.
+ */
+function main() {
+    const { suite, customActors, listOnly, printConfig } = parseCliArgs(process.argv.slice(2));
+
+    if (listOnly) {
+        console.log('GMPSignal 40-Actor Intelligence Suites (https://apify.com/gmpsignal):');
+        for (const [suiteKey, actorList] of Object.entries(GMPSIGNAL_SUITES)) {
+            console.log(`\n[${suiteKey.toUpperCase()}] (${actorList.length} Actors):`);
+            for (const slug of actorList) {
+                console.log(`  - ${slug}`);
+            }
+        }
+        return;
+    }
+
+    if (printConfig) {
+        const configObj = buildMcpServerConfig(suite);
+        console.log(JSON.stringify(configObj, null, 2));
+        return;
+    }
+
+    const actorsArg = customActors
+        ? customActors.trim()
+        : resolveActorsForSuite(suite).join(',');
+
+    const child = spawn(
+        'npx',
+        ['-y', '@apify/actors-mcp-server', '--actors', actorsArg],
+        {
+            stdio: 'inherit',
+            env: {
+                ...process.env
+            }
+        }
+    );
+
+    child.on('exit', (code) => {
+        process.exitCode = code || 0;
+    });
+}
+
+main();

package/index.mjs

@@ -0,0 +1,120 @@
+/**
+ * @file index.mjs
+ * @description Programmatic SDK and Suite Registry for the GMPSignal 40-Actor Enterprise
+ * Data & Model Context Protocol (MCP) Intelligence Suite on Apify.
+ */
+
+/**
+ * Curated Actor suites organized by vertical use case.
+ * @type {Record<string, Array<string>>}
+ */
+export const GMPSIGNAL_SUITES = {
+    flagship: [
+        'gmpsignal/dex-token-scanner-security-auditor',
+        'gmpsignal/crypto-orderbook-arbitrage-scanner',
+        'gmpsignal/multichain-wallet-aml-risk-screener',
+        'gmpsignal/defi-yield-tvl-stablecoin-monitor',
+        'gmpsignal/prediction-markets-polymarket-kalshi-scanner',
+        'gmpsignal/b2b-company-techstack-contacts-enricher',
+        'gmpsignal/global-sanctions-pep-gleif-kyb-screener',
+        'gmpsignal/cyber-cve-kev-epss-vulnerability-scanner',
+        'gmpsignal/startup-vc-dealflow-yc-github-radar',
+        'gmpsignal/academic-patent-research-citation-intelligence',
+        'gmpsignal/shopify-global-store-products-scraper'
+    ],
+    crypto: [
+        'gmpsignal/dex-token-scanner-security-auditor',
+        'gmpsignal/crypto-orderbook-arbitrage-scanner',
+        'gmpsignal/multichain-wallet-aml-risk-screener',
+        'gmpsignal/defi-yield-tvl-stablecoin-monitor',
+        'gmpsignal/prediction-markets-polymarket-kalshi-scanner',
+        'gmpsignal/turkey-crypto-exchange-prices'
+    ],
+    b2b: [
+        'gmpsignal/b2b-company-techstack-contacts-enricher',
+        'gmpsignal/shopify-global-store-products-scraper',
+        'gmpsignal/startup-vc-dealflow-yc-github-radar',
+        'gmpsignal/german-jobs-scraper'
+    ],
+    compliance: [
+        'gmpsignal/global-sanctions-pep-gleif-kyb-screener',
+        'gmpsignal/cyber-cve-kev-epss-vulnerability-scanner',
+        'gmpsignal/academic-patent-research-citation-intelligence',
+        'gmpsignal/sec-edgar-filings',
+        'gmpsignal/fda-warning-letters-scraper',
+        'gmpsignal/fda-recalls-enforcement',
+        'gmpsignal/eu-ted-tenders-scraper',
+        'gmpsignal/global-product-recalls'
+    ],
+    regional: [
+        'gmpsignal/earthquake-monitor-usgs-emsc-afad',
+        'gmpsignal/europe-mediterranean-earthquakes-emsc-official-data',
+        'gmpsignal/turkey-earthquakes-afad-official-data',
+        'gmpsignal/islamic-prayer-times-worldwide-monthly-calendars',
+        'gmpsignal/njuskalo-scraper',
+        'gmpsignal/bolha-scraper',
+        'gmpsignal/olx-ba-scraper',
+        'gmpsignal/halooglasi-serbia-scraper',
+        'gmpsignal/kupujemprodajem-scraper',
+        'gmpsignal/pazar3-merrjep-balkan-scraper',
+        'gmpsignal/tcmb-exchange-rates-official-turkish-central-bank-fx',
+        'gmpsignal/turkey-gold-prices',
+        'gmpsignal/turkey-weather-mgm-official',
+        'gmpsignal/turkey-on-duty-pharmacies-nobetci-eczane-daily',
+        'gmpsignal/turkey-fuel-prices-81-provinces-daily-benzin-motorin-lpg',
+        'gmpsignal/turkey-car-rental-prices-city-airport-index',
+        'gmpsignal/turkey-hotels-explorer-ratings-amenities',
+        'gmpsignal/turkey-domestic-flight-prices',
+        'gmpsignal/eksi-sozluk-scraper-entries-trending',
+        'gmpsignal/turkey-greek-islands-ferry-schedules',
+        'gmpsignal/turkey-bus-routes-prices',
+        'gmpsignal/hepsiemlak-scraper-turkey-real-estate-listings'
+    ]
+};
+
+/**
+ * Resolves the unique list of GMPSignal Actor slugs for a given suite name.
+ *
+ * @param {string} suiteName - Suite identifier ('flagship', 'crypto', 'b2b', 'compliance', 'regional', or 'all').
+ * @returns {Array<string>} Array of full Apify Actor slugs (`gmpsignal/<slug>`).
+ */
+export function resolveActorsForSuite(suiteName = 'flagship') {
+    const normalized = String(suiteName || 'flagship').toLowerCase().trim();
+    if (normalized === 'all') {
+        const unique = new Set([
+            ...GMPSIGNAL_SUITES.crypto,
+            ...GMPSIGNAL_SUITES.b2b,
+            ...GMPSIGNAL_SUITES.compliance,
+            ...GMPSIGNAL_SUITES.regional
+        ]);
+        return Array.from(unique);
+    }
+    return GMPSIGNAL_SUITES[normalized] || GMPSIGNAL_SUITES.flagship;
+}
+
+/**
+ * Builds a complete Claude Desktop / Cursor MCP configuration object.
+ *
+ * @param {string} suiteName - Target suite identifier.
+ * @param {string} apiTokenPlaceholder - Placeholder or actual Apify API token.
+ * @returns {Object} JSON-serializable MCP configuration object.
+ */
+export function buildMcpServerConfig(suiteName = 'flagship', apiTokenPlaceholder = '<YOUR_APIFY_API_TOKEN>') {
+    const actors = resolveActorsForSuite(suiteName);
+    return {
+        mcpServers: {
+            [`gmpsignal-${suiteName}`]: {
+                command: 'npx',
+                args: [
+                    '-y',
+                    '@apify/actors-mcp-server',
+                    '--actors',
+                    actors.join(',')
+                ],
+                env: {
+                    APIFY_TOKEN: apiTokenPlaceholder
+                }
+            }
+        }
+    };
+}

package/package.json

@@ -1,6 +1,53 @@
 {
-  "name": "@gmpsignal/mcp-server",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+    "name": "@gmpsignal/mcp-server",
+    "version": "1.0.0",
+    "description": "Official @gmpsignal Model Context Protocol (MCP) Server & CLI Launcher for the 40-Actor Enterprise Data, Quantitative Crypto, Prediction Markets, B2B Enrichment, KYB/Sanctions, Cybersecurity & Regulatory Suite on Apify.",
+    "type": "module",
+    "main": "./index.mjs",
+    "bin": {
+        "gmpsignal-mcp-server": "./bin/cli.mjs",
+        "gmpsignal-mcp": "./bin/cli.mjs"
+    },
+    "files": [
+        "bin/",
+        "index.mjs",
+        "README.md"
+    ],
+    "scripts": {
+        "start": "node ./bin/cli.mjs",
+        "list": "node ./bin/cli.mjs --list",
+        "print-config": "node ./bin/cli.mjs --print-config"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/devburaq/gmpsignal-mcp-n8n-starter-kit.git"
+    },
+    "keywords": [
+        "mcp",
+        "mcp-server",
+        "model-context-protocol",
+        "apify",
+        "claude-desktop",
+        "cursor",
+        "ai-agents",
+        "dexscreener",
+        "polymarket",
+        "kalshi",
+        "b2b-enrichment",
+        "kyb-sanctions",
+        "cisa-kev",
+        "epss",
+        "shopify-scraper",
+        "sec-edgar",
+        "gmpsignal"
+    ],
+    "author": "GMPSignal <https://apify.com/gmpsignal>",
+    "license": "MIT",
+    "homepage": "https://github.com/devburaq/gmpsignal-mcp-n8n-starter-kit",
+    "publishConfig": {
+        "access": "public"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    }
+}