@mambalabsdev/mcp-recent-funding-rounds-feed 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mamba Labs
+
+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

@@ -1,3 +1,120 @@
-# Temporary Holding Version
+# Recent Funding Rounds Feed MCP Server
 
-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.
+[![Smithery](https://smithery.ai/badge/mambabuilt/mcp-recent-funding-rounds-feed)](https://smithery.ai/servers/mambabuilt/mcp-recent-funding-rounds-feed) [![Glama score](https://glama.ai/mcp/servers/mambalabsdev/mcp-recent-funding-rounds-feed/badges/score.svg)](https://glama.ai/mcp/servers/mambalabsdev/mcp-recent-funding-rounds-feed) [![MCP Registry](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fregistry.modelcontextprotocol.io%2Fv0%2Fservers%3Fsearch%3Dcom.mambabuilt%252Fmcp-recent-funding-rounds-feed%26limit%3D1&query=%24.servers%5B0%5D._meta%5B%22io.modelcontextprotocol.registry%2Fofficial%22%5D.status&label=mcp%20registry&color=blue)](https://registry.modelcontextprotocol.io/v0/servers?search=com.mambabuilt/mcp-recent-funding-rounds-feed&limit=1) [![npm version](https://img.shields.io/npm/v/@mambalabsdev/mcp-recent-funding-rounds-feed)](https://www.npmjs.com/package/@mambalabsdev/mcp-recent-funding-rounds-feed) [![npm downloads](https://img.shields.io/npm/dm/@mambalabsdev/mcp-recent-funding-rounds-feed)](https://www.npmjs.com/package/@mambalabsdev/mcp-recent-funding-rounds-feed) [![license](https://img.shields.io/github/license/mambalabsdev/mcp-recent-funding-rounds-feed)](https://github.com/mambalabsdev/mcp-recent-funding-rounds-feed/blob/main/LICENSE) [![mcpservers.org](https://img.shields.io/badge/mcpservers.org-listed-blue)](https://mcpservers.org/servers/mambalabsdev/mcp-recent-funding-rounds-feed)
+
+An MCP server for the Mamba Labs Recent Funding Rounds Feed actor on Apify. Give it a filing window and filters such as state, industry, and minimum size. Each run reads SEC Form D notices from SEC EDGAR and returns one row per new private funding round.
+
+## What's Inside
+
+- [What it does](#what-it-does)
+- [Quick start](#quick-start)
+- [Prerequisites](#prerequisites)
+- [Example prompts](#example-prompts)
+- [Tool](#tool)
+- [Inputs](#inputs)
+- [Pricing](#pricing)
+- [Your keys](#your-keys)
+- [Full actor documentation](#full-actor-documentation)
+- [License](#license)
+
+## What it does
+
+The actor reads the Form D notices US companies file with the SEC within 15 days of a private funding round, keeps the ones in your window that match your filters, and returns one flat row per round: company, amount sold and offered, what was sold (equity, debt, a SAFE), investor count, industry group, executives and directors with roles, address and phone from the filing, the SEC links, and the company domain when the company's own homepage proves it. Funds, SPVs, and real estate projects are dropped by default. When nothing matches, one free row says why.
+
+All of the work runs on Apify. This package is a thin client that starts the actor run, waits for it, and hands back the dataset rows.
+
+## Quick start
+
+You need Node.js 18 or newer and an Apify account with an API token.
+
+Add this to your Claude Desktop config (`claude_desktop_config.json`), Cursor, or any MCP client:
+
+```json
+{
+  "mcpServers": {
+    "mamba-recent-funding-rounds-feed": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@mambalabsdev/mcp-recent-funding-rounds-feed"
+      ],
+      "env": {
+        "APIFY_TOKEN": "your-apify-token"
+      }
+    }
+  }
+}
+```
+
+Restart the client. The `find_recent_funding_rounds` tool appears.
+
+## Prerequisites
+
+- Node.js 18 or newer.
+- An Apify API token from [console.apify.com/account/integrations](https://console.apify.com/account/integrations), set as `APIFY_TOKEN`. The server lists its tool without a token; a call needs one.
+
+## Example prompts
+
+- "Which tech and biotech companies filed a Form D for a round over 1 million USD this week?"
+- "List companies in New York and Massachusetts that raised money in the last 30 days, with their domains."
+- "Find newly funded AI startups from SEC filings this week and give me their executives."
+
+## Tool
+
+`find_recent_funding_rounds`. One tool. Example arguments:
+
+```json
+{
+  "filed_within_days": "7",
+  "industry_groups": [
+    "Other Technology"
+  ],
+  "min_amount_usd": "500000"
+}
+```
+
+## Inputs
+
+Every buyer facing input of the actor, unchanged. Omitted inputs take the actor's own defaults. Numbers and booleans are sent as strings.
+
+| Input | Type | Description |
+|---|---|---|
+| `filed_within_days` | string | Filing window in days ending today, 1 to 90, today included. Ignored when date_from is set. Default 7. |
+| `date_from` | string | Start of a custom filing window, YYYY-MM-DD. The window is at most 92 days. |
+| `date_to` | string | End of a custom filing window, YYYY-MM-DD. Default today. |
+| `states` | array | Two character state codes of the company's principal place of business, such as CA, NY, or TX. |
+| `industry_groups` | array | Keep only these Form D industry groups, such as Other Technology, Computers, Biotechnology, Pharmaceuticals, Business Services, Retailing, Manufacturing. |
+| `exclude_industry_groups` | array | Drop these Form D industry groups. The actor default drops Pooled Investment Fund, Commercial, Residential, REITS and Finance, and Other Real Estate; send an empty list to keep them. |
+| `exclude_spvs` | string | Drop SPVs and funds (3(c) exemptions, pooled fund interests, SPV or Fund in the name). Default true. |
+| `min_amount_usd` | string | Keep a round only when the larger of amount offered and amount sold is at least this many USD. Default 100000; 0 keeps every size. |
+| `name_keywords` | array | Words in the company name, such as AI or Bio. |
+| `include_amendments` | string | Also return Form D/A amendments. Default false. |
+| `resolve_domains` | string | Find each company's domain and keep it only when its homepage names the company. No extra charge. Default true. |
+| `include_press` | string | Add a matching funding headline for the 50 largest rounds through the Mamba Labs News and Media Mention Monitor, which bills its own article events (up to 100 a run) to your Apify account. Default false. |
+| `max_rounds` | string | Round rows per run, newest filing first, up to 2000. Each round row is billed. Default 100. |
+| `only_new` | string | Skip rounds an earlier run with the same state_key returned. Default false. |
+| `state_key` | string | Names the seen list for only_new. |
+| `max_charge_usd` | string | Optional. The run stops before any row that would take its charges over this amount. |
+
+## Pricing
+
+Pay per event on Apify, billed to your Apify account. Prices in USD.
+
+| Event | Free plan | Bronze | Silver | Gold |
+|---|---|---|---|---|
+| `round-row`, per funding round row | $0.01 | $0.0095 | $0.009 | $0.0085 |
+| `apify-actor-start`, per run start (one per GB of run memory, minimum one; the default is 512 MB) | $0.0015 | $0.0015 | $0.0015 | $0.0015 |
+
+The no results row, a refused input row, and rounds skipped by `only_new` are free. With `include_press` set to `true`, the actor starts one run of the Mamba Labs News and Media Mention Monitor on your account, which bills its own article events.
+
+## Your keys
+
+None beyond your Apify token. SEC EDGAR is free and needs no key. Mamba Labs pays the platform and proxy costs of the run.
+
+## Full actor documentation
+
+[apify.com/mambalabs/recent-funding-rounds-feed](https://apify.com/mambalabs/recent-funding-rounds-feed)
+
+## License
+
+MIT. See [LICENSE](LICENSE).

package/SECURITY.md

@@ -0,0 +1,31 @@
+# Security Policy
+
+## Supported versions
+
+The latest published `1.x` release of
+`@mambalabsdev/mcp-recent-funding-rounds-feed` receives security updates.
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 1.x     | :white_check_mark: |
+| < 1.0   | :x:                |
+
+## Reporting a vulnerability
+
+Please do not open a public GitHub issue for security reports.
+
+Email security reports to **labs@mambamindsetgrowth.com** with:
+
+- a description of the issue and its impact,
+- steps to reproduce, and
+- any relevant logs or proof of concept.
+
+We aim to acknowledge reports within 3 business days and to provide a remediation
+timeline after triage. Coordinated disclosure is appreciated.
+
+## Handling of credentials
+
+This server reads an `APIFY_TOKEN` from the environment and uses it only to call
+the Apify API on your behalf. The token is never logged or written to disk by this
+package. Treat your `APIFY_TOKEN` as a secret and rotate it at
+https://console.apify.com/account/integrations if you believe it has been exposed.

package/build/index.js

@@ -0,0 +1,206 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+const here = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(here, "..", "package.json"), "utf8"));
+// Distinctive UA so Apify run meta.userAgent marks MCP-originated runs.
+const USER_AGENT = `mambalabs-mcp ${pkg.name}@${pkg.version}`;
+// Drop undefined values so optional inputs are not sent to the actor.
+function compact(obj) {
+    const out = {};
+    for (const [k, v] of Object.entries(obj)) {
+        if (v !== undefined)
+            out[k] = v;
+    }
+    return out;
+}
+// How long the actor run itself is allowed to take, in seconds. The suite's
+// slowest measured run on 2026-09-22 was 152 s on a seven platform search, so
+// 1800 s is roughly twelve times that: headroom for a slow day without letting a
+// hung run bill indefinitely.
+const ACTOR_RUN_TIMEOUT_SECS = 1800;
+// How long this wrapper waits for that run, in milliseconds. The actor's own
+// timeout plus two minutes, so the run's own TIMED-OUT status is what the
+// caller sees rather than the wrapper giving up first and reporting nothing.
+const WRAPPER_WAIT_MS = (ACTOR_RUN_TIMEOUT_SECS + 120) * 1000;
+const POLL_INTERVAL_MS = 3000;
+const TERMINAL = new Set(["SUCCEEDED", "FAILED", "TIMED-OUT", "ABORTED", "ABORTING"]);
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+// Shared caller. actorPath is the actor's immutable Apify actor ID (a stable key
+// that survives Store renames). The /v2/acts/{id} endpoint accepts it directly,
+// so a Store rename never breaks these calls.
+//
+// START AND POLL, NOT RUN-SYNC. Apify's synchronous endpoints carry a platform
+// ceiling of 300 seconds on the HTTP wait itself and answer 408 past it whatever
+// the timeout parameter says, so a long run reads as a timeout even though the
+// actor goes on to finish. Starting the run, polling it to a terminal status and
+// then reading the dataset is the only way to wait as long as the actor needs.
+//
+// The token is read here rather than at module load, so the tool registers
+// unconditionally and a server started without APIFY_TOKEN still advertises its
+// capabilities instead of reporting none.
+async function runActor(actorPath, actorLabel, input) {
+    const APIFY_TOKEN = process.env.APIFY_TOKEN;
+    if (!APIFY_TOKEN) {
+        return { isError: true, content: [{ type: "text", text: "APIFY_TOKEN is not set. Create a token at https://console.apify.com/account/integrations and set it as the APIFY_TOKEN environment variable." }] };
+    }
+    const headers = {
+        Authorization: `Bearer ${APIFY_TOKEN}`,
+        "Content-Type": "application/json",
+        "User-Agent": USER_AGENT,
+    };
+    const httpError = async (response) => {
+        let detail = "";
+        try {
+            const body = (await response.json());
+            if (body?.error?.message)
+                detail = ` ${body.error.message}`;
+        }
+        catch {
+            detail = "";
+        }
+        switch (response.status) {
+            case 400:
+                return `The ${actorLabel} run was rejected as invalid input.${detail}`;
+            case 401:
+                return "Invalid Apify token. Check your APIFY_TOKEN environment variable.";
+            case 402:
+                return "Insufficient Apify credits. Check your account balance at https://console.apify.com/billing";
+            default:
+                return `Apify request to ${actorLabel} failed with status ${response.status}.${detail}`;
+        }
+    };
+    // 1. Start the run.
+    let started;
+    try {
+        started = await fetch(`https://api.apify.com/v2/acts/${actorPath}/runs?timeout=${ACTOR_RUN_TIMEOUT_SECS}`, { method: "POST", headers, body: JSON.stringify(input) });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { isError: true, content: [{ type: "text", text: `Could not reach the Apify API: ${message}` }] };
+    }
+    if (!started.ok) {
+        return { isError: true, content: [{ type: "text", text: await httpError(started) }] };
+    }
+    let run;
+    try {
+        run = (await started.json()).data ?? {};
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { isError: true, content: [{ type: "text", text: `The ${actorLabel} run start returned a response that could not be parsed: ${message}` }] };
+    }
+    const runId = run.id;
+    if (!runId) {
+        return { isError: true, content: [{ type: "text", text: `The ${actorLabel} run start returned no run id, so there is nothing to wait for.` }] };
+    }
+    // 2. Poll to a terminal status.
+    const deadline = Date.now() + WRAPPER_WAIT_MS;
+    let status = run.status ?? "READY";
+    let datasetId = run.defaultDatasetId;
+    while (!TERMINAL.has(status)) {
+        if (Date.now() >= deadline) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `The ${actorLabel} run ${runId} was still ${status} after ${Math.round(WRAPPER_WAIT_MS / 1000)} seconds and this call stopped waiting. The run itself is still on Apify: read it at https://console.apify.com/actors/runs/${runId}` }],
+            };
+        }
+        await sleep(POLL_INTERVAL_MS);
+        let poll;
+        try {
+            poll = await fetch(`https://api.apify.com/v2/actor-runs/${runId}`, { headers });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return { isError: true, content: [{ type: "text", text: `Lost contact with the Apify API while waiting for ${actorLabel} run ${runId}: ${message}` }] };
+        }
+        if (!poll.ok) {
+            return { isError: true, content: [{ type: "text", text: await httpError(poll) }] };
+        }
+        const body = (await poll.json());
+        status = body.data?.status ?? status;
+        datasetId = body.data?.defaultDatasetId ?? datasetId;
+    }
+    // 3. A run that did not succeed is a failure the caller must see, never an
+    // empty success. Surfacing it here is what keeps a crashed run from reading
+    // as "no results found".
+    if (status !== "SUCCEEDED") {
+        return {
+            isError: true,
+            content: [{ type: "text", text: `The ${actorLabel} run did not succeed (run ID: ${runId}, status: ${status}).` }],
+        };
+    }
+    if (!datasetId) {
+        return { isError: true, content: [{ type: "text", text: `The ${actorLabel} run ${runId} succeeded but reported no dataset, so there is nothing to return.` }] };
+    }
+    // 4. Read the dataset.
+    let ds;
+    try {
+        ds = await fetch(`https://api.apify.com/v2/datasets/${datasetId}/items?format=json`, { headers });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { isError: true, content: [{ type: "text", text: `Could not read the ${actorLabel} dataset: ${message}` }] };
+    }
+    if (!ds.ok) {
+        return { isError: true, content: [{ type: "text", text: await httpError(ds) }] };
+    }
+    let items;
+    try {
+        items = await ds.json();
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { isError: true, content: [{ type: "text", text: `The ${actorLabel} run returned a response that could not be parsed: ${message}` }] };
+    }
+    if (!Array.isArray(items)) {
+        const asObj = items;
+        const detail = asObj?.error?.message
+            ? `${asObj.error.message}`
+            : JSON.stringify(items);
+        return { isError: true, content: [{ type: "text", text: `The ${actorLabel} run did not return a dataset. ${detail}` }] };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(items, null, 2) }] };
+}
+const server = new McpServer({
+    name: "mamba-recent-funding-rounds-feed",
+    version: pkg.version,
+});
+// Recent Funding Rounds Feed (immutable actor ID KueVp9MOz7iOoAgDp). Every buyer facing input of the actor
+// is exposed. The actor takes numbers and booleans as strings, so those inputs are strings here too.
+const bool = () => z.enum(["true", "false"]).optional();
+server.registerTool("find_recent_funding_rounds", {
+    title: "Find recent funding rounds",
+    description: "Find US companies that just raised private funding, from SEC Form D notices read directly from SEC EDGAR. Filter by filing window (filed_within_days, or date_from and date_to), states, Form D industry_groups, name_keywords, and min_amount_usd. Funds, SPVs, and real estate projects are dropped by default. Returns one row per round: company_name, company_domain with domain_confidence (kept only when the company's own homepage names it), filing_date, first_sale_date, amount_sold_usd, amount_offered_usd, security_types (equity, debt, SAFE), investor_count, industry_group, entity_type, year_of_incorporation, street, city, state, zip_code, issuer_phone, related_persons (executives and directors with roles), cik, accession, and filing_url. A Form D names no round label and no investors; round_label and press_url come only from a matching headline with include_press. When nothing matches, one free no_results row says why; bad input returns one free input_invalid row. A run that does not succeed is returned as an error with its run ID. Read-only; requires an APIFY_TOKEN; Apify charges per round row returned plus a run start.",
+    annotations: {
+        title: "Find recent funding rounds",
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+    inputSchema: {
+        filed_within_days: z.string().optional().describe("Filing window in days ending today, 1 to 90, today included. Ignored when date_from is set. Default 7."),
+        date_from: z.string().optional().describe("Start of a custom filing window, YYYY-MM-DD. The window is at most 92 days."),
+        date_to: z.string().optional().describe("End of a custom filing window, YYYY-MM-DD. Default today."),
+        states: z.array(z.string()).optional().describe("Two character state codes of the company's principal place of business, such as CA, NY, or TX."),
+        industry_groups: z.array(z.string()).optional().describe("Keep only these Form D industry groups, such as Other Technology, Computers, Biotechnology, Pharmaceuticals, Business Services, Retailing, Manufacturing."),
+        exclude_industry_groups: z.array(z.string()).optional().describe("Drop these Form D industry groups. The actor default drops Pooled Investment Fund, Commercial, Residential, REITS and Finance, and Other Real Estate; send an empty list to keep them."),
+        exclude_spvs: bool().describe("Drop SPVs and funds (3(c) exemptions, pooled fund interests, SPV or Fund in the name). Default true."),
+        min_amount_usd: z.string().optional().describe("Keep a round only when the larger of amount offered and amount sold is at least this many USD. Default 100000; 0 keeps every size."),
+        name_keywords: z.array(z.string()).optional().describe("Words in the company name, such as AI or Bio."),
+        include_amendments: bool().describe("Also return Form D/A amendments. Default false."),
+        resolve_domains: bool().describe("Find each company's domain and keep it only when its homepage names the company. No extra charge. Default true."),
+        include_press: bool().describe("Add a matching funding headline for the 50 largest rounds through the Mamba Labs News and Media Mention Monitor, which bills its own article events (up to 100 a run) to your Apify account. Default false."),
+        max_rounds: z.string().optional().describe("Round rows per run, newest filing first, up to 2000. Each round row is billed. Default 100."),
+        only_new: bool().describe("Skip rounds an earlier run with the same state_key returned. Default false."),
+        state_key: z.string().optional().describe("Names the seen list for only_new."),
+        max_charge_usd: z.string().optional().describe("Optional. The run stops before any row that would take its charges over this amount."),
+    },
+}, async (args) => runActor("KueVp9MOz7iOoAgDp", "Recent Funding Rounds Feed", compact(args)));
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "@mambalabsdev/mcp-recent-funding-rounds-feed",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "MCP server for Recent Funding Rounds Feed. Find US companies that just raised private funding, from SEC Form D filings: company, domain, amount raised and offered, securities, investors count, executives and directors, address, and phone, filtered by date, state, industry, and size. Runs on Apify. Clay-ready output.",
+  "type": "module",
+  "bin": {
+    "mcp-recent-funding-rounds-feed": "./build/index.js"
+  },
+  "files": [
+    "build",
+    "README.md",
+    "LICENSE",
+    "SECURITY.md"
+  ],
+  "scripts": {
+    "build": "tsc && chmod +x build/index.js",
+    "test": "npm run build && node --test test/*.test.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "funding-rounds",
+    "recently-funded",
+    "form-d",
+    "sec-edgar",
+    "startups",
+    "venture-capital",
+    "lead-generation",
+    "apify",
+    "clay"
+  ],
+  "author": "Mamba Labs <labs@mambamindsetgrowth.com>",
+  "license": "MIT",
+  "homepage": "https://apify.com/mambalabs/recent-funding-rounds-feed",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mambalabsdev/mcp-recent-funding-rounds-feed"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^26.2.0",
+    "typescript": "5.9.3"
+  },
+  "mcpName": "com.mambabuilt/mcp-recent-funding-rounds-feed",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.32.0",
+    "zod": "^4.4.3"
+  }
+}