@scope-bid/scope-aec-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Scope Bid, Inc.
+
+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,39 @@
+# @scope-bid/scope-aec-mcp
+
+> Scope's MCP server for **AEC subcontractor vendor procurement**. **Preview** - V3 launches 2027.
+
+Reserves the npm namespace and the MCP registry listing for Scope's V3 vertical: the cross-platform plumbing layer for general contractor subcontractor procurement. Connects BuildingConnected (bid management), TradeTapp + ISN/Avetta (pre-qualification), Procore (project management), and myCOI (insurance tracking) - the layer that doesn't exist between them today.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Status](https://img.shields.io/badge/Status-Preview-orange)](https://scope-bid.vercel.app/mcp/aec)
+
+## Current tools (preview)
+
+- `scope_aec_status` - returns roadmap, expected launch, planned categories
+- `scope_aec_categories` - list of V3 service categories (subcontractor prequal, specialty trade bids, COI tracking, safety compliance, performance bonds)
+- `scope_aec_join_waitlist` - register interest from inside any AI workflow
+
+## Install (preview)
+
+```json
+{
+  "mcpServers": {
+    "scope-aec": {
+      "command": "npx",
+      "args": ["-y", "@scope-bid/scope-aec-mcp"]
+    }
+  }
+}
+```
+
+No token required for preview tools. Full dispatch tools land at v1.0.0 when V3 ships.
+
+## Roadmap
+
+- **v0.1.0** (now) - preview: status, categories, waitlist
+- **v1.0.0** (2027) - full GC-side subcontractor dispatch with cross-platform integration into Procore + BuildingConnected + ISN/Avetta + myCOI
+- **Sister packages**: `@scope-bid/scope-mcp` (legal, live), `@scope-bid/scope-claims-mcp` (claims, preview)
+
+## License
+
+MIT

package/dist/server.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+//
+// @scope-bid/scope-aec-mcp - Scope's MCP server for AEC subcontractor
+// vendor procurement.
+//
+// PREVIEW STATUS - V3 launches 2027.
+//
+// AEC = Architecture, Engineering, Construction. The plumbing layer for GC
+// subcontractor procurement, where the existing market has bid-management
+// (BuildingConnected), pre-qualification (ISN/Avetta/TradeTapp), and
+// project management (Procore) as separate silos with no connection layer
+// between them.
+//
+// Three preview tools - status, categories, waitlist - reserve the npm
+// namespace and the MCP registry listing. Full dispatch tools land at
+// v1.0.0 when V3 ships.
+import { createScopeServer } from "@scope-bid/mcp-core";
+import { z } from "zod";
+const SERVER_VERSION = "0.1.0";
+const server = createScopeServer({
+    vertical: "aec",
+    serverName: "scope-aec-mcp",
+    serverVersion: SERVER_VERSION,
+    includeCoreTools: false,
+});
+server.registerTool({
+    name: "scope_aec_status",
+    description: "Returns the status and roadmap for Scope's AEC subcontractor procurement plumbing layer (V3). Useful for AI workflows that want to know whether GC subcontractor dispatch is live yet.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false },
+}, async () => ({
+    vertical: "aec",
+    status: "preview",
+    expected_launch: "2027",
+    headline: "Scope's vertical-MCP plumbing layer for AEC subcontractor procurement. Connects BuildingConnected, TradeTapp, ISN/Avetta, Procore, and myCOI - the cross-platform layer that doesn't exist today. Buyer: GC procurement / risk officer. Vendors: subcontractors and specialty trades.",
+    v1_categories_planned: [
+        "subcontractor-prequal",
+        "specialty-trade-bid",
+        "insurance-coi-tracking",
+        "safety-compliance",
+        "performance-bond-issuance",
+    ],
+    join_waitlist: "Use scope_aec_join_waitlist or sign up at scope-bid.vercel.app/founding-vendors",
+    learn_more: "https://scope-bid.vercel.app/mcp/aec",
+}));
+server.registerTool({
+    name: "scope_aec_categories",
+    description: "List planned V3 service categories for Scope's AEC subcontractor procurement. These are the categories vendors and GCs can register for in the founding cohort.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false },
+}, async () => ({
+    categories: [
+        {
+            slug: "subcontractor-prequal",
+            label: "Subcontractor pre-qualification (cross-platform)",
+            api_status: "ops_backed",
+        },
+        {
+            slug: "specialty-trade-bid",
+            label: "Specialty trade bid management (electrical, MEP, structural, etc.)",
+            api_status: "mixed",
+        },
+        {
+            slug: "insurance-coi-tracking",
+            label: "Insurance certificate tracking (cross-vendor)",
+            api_status: "api_native",
+        },
+        {
+            slug: "safety-compliance",
+            label: "Safety + compliance (RAVS, OSHA, project-specific)",
+            api_status: "ops_backed",
+        },
+        {
+            slug: "performance-bond-issuance",
+            label: "Performance bond / surety issuance",
+            api_status: "ops_backed",
+        },
+    ],
+    note: "V3 launches 2027. Until then, this server returns category metadata only - no live dispatch yet. Pricing model in AEC is GC-side subscription, not per-sub like compliance-platform incumbents.",
+}));
+const JoinWaitlistInput = z.object({
+    email: z.string().email(),
+    role: z.enum(["gc", "subcontractor", "developer", "owner", "lender", "other"]),
+    organization: z.string().optional(),
+    category_interest: z.string().optional(),
+    notes: z.string().optional(),
+});
+server.registerTool({
+    name: "scope_aec_join_waitlist",
+    description: "Register interest in Scope's V3 (AEC subcontractor procurement). For GCs, subcontractors, developers, or lenders who want early access to the cross-platform plumbing layer.",
+    inputSchema: {
+        type: "object",
+        required: ["email", "role"],
+        properties: {
+            email: { type: "string", format: "email" },
+            role: {
+                type: "string",
+                enum: ["gc", "subcontractor", "developer", "owner", "lender", "other"],
+            },
+            organization: { type: "string" },
+            category_interest: { type: "string" },
+            notes: { type: "string" },
+        },
+        additionalProperties: false,
+    },
+}, async (rawArgs) => {
+    const args = JoinWaitlistInput.parse(rawArgs);
+    return server.api.post("/api/waitlist", {
+        email: args.email,
+        feature: "scope-aec-v3",
+        metadata: {
+            role: args.role,
+            organization: args.organization,
+            category_interest: args.category_interest,
+            notes: args.notes,
+            source: "mcp-aec-server",
+        },
+    });
+});
+server.start().catch((err) => {
+    process.stderr.write(`[scope-aec-mcp] fatal: ${String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@scope-bid/scope-aec-mcp",
+  "version": "0.1.0",
+  "mcpName": "io.github.scope-bid/scope-aec-mcp",
+  "description": "Scope MCP server for AEC subcontractor vendor procurement (preview - V3 launches 2027).",
+  "license": "MIT",
+  "author": "Jack Gillen <jack@scope.bid>",
+  "homepage": "https://scope-bid.vercel.app/mcp/aec",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/scope-bid/scope-mcp.git",
+    "directory": "packages/scope-aec-mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/scope-bid/scope-mcp/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "construction",
+    "aec",
+    "subcontractor",
+    "claude",
+    "anthropic",
+    "scope"
+  ],
+  "type": "module",
+  "main": "dist/server.js",
+  "bin": {
+    "scope-aec-mcp": "dist/server.js"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@scope-bid/mcp-core": "^0.1.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0"
+  }
+}