@thecorporation/mcp-server 0.1.0

package/README.md

@@ -0,0 +1,82 @@
+# The Corporation — MCP Server
+
+<!-- mcp-name: io.github.thecorporation/corporate-os -->
+
+Your agent just formed an LLC in 4 tool calls.
+
+An MCP server that gives AI agents full corporate operations capabilities — entity formation, equity management, payroll, contracts, banking, and tax compliance. 12 tools, zero corporate law expertise required.
+
+## Install
+
+```bash
+uv pip install thecorporation
+```
+
+Or run directly:
+
+```bash
+uvx thecorporation
+```
+
+## Configure with Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "thecorporation": {
+      "command": "uvx",
+      "args": ["thecorporation"]
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | What it does |
+|------|-------------|
+| `form_entity` | Form an LLC or corporation in any US state |
+| `issue_equity` | Issue shares or membership units to recipients |
+| `issue_safe` | Issue SAFE notes (pre-money, post-money, MFN) to investors |
+| `create_invoice` | Create and send invoices to customers |
+| `run_payroll` | Run payroll for employees and contractors |
+| `submit_payment` | Send payments via ACH, wire, or check |
+| `get_signing_link` | Generate a signing link — documents can only be signed by humans via this URL |
+| `convene_meeting` | Convene board, shareholder, or member meetings |
+| `cast_vote` | Cast votes on meeting agenda items |
+| `open_bank_account` | Open a business bank account (auto-assembles KYB) |
+| `generate_contract` | Generate NDAs, contractor agreements, offer letters |
+| `file_tax_document` | Generate 1099s, K-1s, estimated tax filings |
+
+## Example Prompts
+
+- "Form a Delaware LLC called Acme AI for my consulting business"
+- "Issue a $500K post-money SAFE with a $10M cap to Jane Smith"
+- "Generate an NDA between my company and Acme Corp"
+- "Run payroll for January 2025"
+- "File 1099-NECs for all my contractors for tax year 2025"
+
+## How It Works
+
+Every operation flows through a deterministic governance kernel:
+
+```
+Agent Tool Call → Intent → Policy Evaluation → Execution → Receipt
+```
+
+- No side effect without an auditable intent
+- Every receipt is hash-bound and immutable
+- Human obligations auto-generated for legally required signatures
+- Double-entry ledger tracks every dollar
+
+## What This Is (and Isn't)
+
+**This is** infrastructure for AI agents that need to operate businesses. It handles the corporate law, tax compliance, and financial plumbing so your agent doesn't have to.
+
+**This is not** legal advice, tax advice, or a substitute for professional counsel. The platform computes from data it already has (K-1 allocations, 1099 aggregations, estimated taxes) but doesn't interpret tax law.
+
+## License
+
+Apache 2.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.js

@@ -0,0 +1,124 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CorpAPIClient as CorpAPIClient2 } from "@thecorporation/corp-tools";
+
+// src/server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import {
+  GENERATED_TOOL_DEFINITIONS,
+  executeTool
+} from "@thecorporation/corp-tools";
+import { join } from "path";
+import { homedir } from "os";
+function buildZodShape(fn) {
+  const shape = {};
+  const props = fn.parameters.properties || {};
+  const required = new Set(fn.parameters.required || []);
+  for (const [pname, pinfo] of Object.entries(props)) {
+    let schema;
+    switch (pinfo.type) {
+      case "integer":
+        schema = z.number().int();
+        break;
+      case "number":
+        schema = z.number();
+        break;
+      case "boolean":
+        schema = z.boolean();
+        break;
+      case "array":
+        schema = z.array(pinfo.items?.type === "object" ? z.record(z.unknown()) : z.string());
+        break;
+      case "object":
+        schema = z.record(z.unknown());
+        break;
+      default:
+        schema = pinfo.enum ? z.enum(pinfo.enum) : z.string();
+    }
+    if (pinfo.description) schema = schema.describe(pinfo.description);
+    if (!required.has(pname)) schema = schema.optional();
+    shape[pname] = schema;
+  }
+  return shape;
+}
+function createMcpServer(client) {
+  const server = new McpServer({
+    name: "thecorporation",
+    version: "0.1.0"
+  });
+  const ctx = {
+    dataDir: join(homedir(), ".corp", "data")
+  };
+  for (const td of GENERATED_TOOL_DEFINITIONS) {
+    const fn = td.function;
+    const shape = buildZodShape(fn);
+    server.tool(fn.name, fn.description, shape, async (args) => {
+      const result = await executeTool(fn.name, args, client, ctx);
+      return { content: [{ type: "text", text: result }] };
+    });
+  }
+  return server;
+}
+
+// src/auth.ts
+import { readFileSync, writeFileSync, mkdirSync } from "fs";
+import { join as join2 } from "path";
+import { homedir as homedir2 } from "os";
+var CONFIG_FILE = join2(homedir2(), ".corp", "config.json");
+function loadConfig() {
+  try {
+    return JSON.parse(readFileSync(CONFIG_FILE, "utf-8"));
+  } catch {
+    return {};
+  }
+}
+function saveConfig(cfg) {
+  const dir = join2(homedir2(), ".corp");
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(CONFIG_FILE, JSON.stringify(cfg, null, 2) + "\n");
+}
+async function provision(apiUrl) {
+  const resp = await fetch(`${apiUrl.replace(/\/+$/, "")}/v1/workspaces/provision`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ name: "mcp-auto" }),
+    signal: AbortSignal.timeout(15e3)
+  });
+  if (!resp.ok) throw new Error(`Provision failed: ${resp.status}`);
+  return await resp.json();
+}
+async function resolveOrProvisionAuth(apiUrl = "https://api.thecorporation.ai") {
+  const envKey = process.env.CORP_API_KEY || "";
+  const envWs = process.env.CORP_WORKSPACE_ID || "";
+  if (envKey && envWs) {
+    return { workspaceId: envWs, apiKey: envKey, scopes: ["*"] };
+  }
+  const cfg = loadConfig();
+  if (cfg.api_key && cfg.workspace_id) {
+    return { workspaceId: cfg.workspace_id, apiKey: cfg.api_key, scopes: ["*"] };
+  }
+  const result = await provision(apiUrl);
+  cfg.api_key = result.api_key;
+  cfg.workspace_id = result.workspace_id;
+  if (!cfg.api_url) cfg.api_url = apiUrl;
+  saveConfig(cfg);
+  return { workspaceId: result.workspace_id, apiKey: result.api_key, scopes: ["*"] };
+}
+
+// src/index.ts
+async function main() {
+  const apiUrl = process.env.CORP_API_URL || "https://api.thecorporation.ai";
+  const ctx = await resolveOrProvisionAuth(apiUrl);
+  const client = new CorpAPIClient2(apiUrl, ctx.apiKey, ctx.workspaceId);
+  const server = createMcpServer(client);
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+main().catch((err) => {
+  console.error("Fatal:", err);
+  process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/server.ts","../src/auth.ts"],"sourcesContent":["/**\n * Entry point — resolve auth, start MCP server on stdio.\n */\n\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { CorpAPIClient } from \"@thecorporation/corp-tools\";\nimport { createMcpServer } from \"./server.js\";\nimport { resolveOrProvisionAuth } from \"./auth.js\";\n\nasync function main(): Promise<void> {\n  const apiUrl = process.env.CORP_API_URL || \"https://api.thecorporation.ai\";\n\n  const ctx = await resolveOrProvisionAuth(apiUrl);\n  const client = new CorpAPIClient(apiUrl, ctx.apiKey, ctx.workspaceId);\n  const server = createMcpServer(client);\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n}\n\nmain().catch((err) => {\n  console.error(\"Fatal:\", err);\n  process.exit(1);\n});\n","/**\n * MCP server — registers all tools from corp-tools definitions,\n * dispatches to the backend API via CorpAPIClient.\n */\n\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport {\n  GENERATED_TOOL_DEFINITIONS,\n  CorpAPIClient,\n  executeTool,\n  type ToolContext,\n} from \"@thecorporation/corp-tools\";\nimport { join } from \"node:path\";\nimport { homedir } from \"node:os\";\n\n// ---------------------------------------------------------------------------\n// Build Zod schemas from JSON Schema properties\n// ---------------------------------------------------------------------------\n\ninterface ToolFunction {\n  name: string;\n  description: string;\n  parameters: {\n    type: string;\n    properties: Record<string, { type: string; description?: string; enum?: string[]; items?: { type: string } }>;\n    required: string[];\n  };\n}\n\ninterface ToolDef {\n  type: string;\n  function: ToolFunction;\n}\n\nfunction buildZodShape(fn: ToolFunction): Record<string, z.ZodTypeAny> {\n  const shape: Record<string, z.ZodTypeAny> = {};\n  const props = fn.parameters.properties || {};\n  const required = new Set(fn.parameters.required || []);\n\n  for (const [pname, pinfo] of Object.entries(props)) {\n    let schema: z.ZodTypeAny;\n    switch (pinfo.type) {\n      case \"integer\":\n        schema = z.number().int();\n        break;\n      case \"number\":\n        schema = z.number();\n        break;\n      case \"boolean\":\n        schema = z.boolean();\n        break;\n      case \"array\":\n        schema = z.array(pinfo.items?.type === \"object\" ? z.record(z.unknown()) : z.string());\n        break;\n      case \"object\":\n        schema = z.record(z.unknown());\n        break;\n      default:\n        schema = pinfo.enum ? z.enum(pinfo.enum as [string, ...string[]]) : z.string();\n    }\n    if (pinfo.description) schema = schema.describe(pinfo.description);\n    if (!required.has(pname)) schema = schema.optional();\n    shape[pname] = schema;\n  }\n  return shape;\n}\n\n// ---------------------------------------------------------------------------\n// Create and configure MCP server\n// ---------------------------------------------------------------------------\n\nexport function createMcpServer(client: CorpAPIClient): McpServer {\n  const server = new McpServer({\n    name: \"thecorporation\",\n    version: \"0.1.0\",\n  });\n\n  const ctx: ToolContext = {\n    dataDir: join(homedir(), \".corp\", \"data\"),\n  };\n\n  for (const td of GENERATED_TOOL_DEFINITIONS as unknown as ToolDef[]) {\n    const fn = td.function;\n    const shape = buildZodShape(fn);\n\n    server.tool(fn.name, fn.description, shape, async (args) => {\n      const result = await executeTool(fn.name, args as Record<string, unknown>, client, ctx);\n      return { content: [{ type: \"text\" as const, text: result }] };\n    });\n  }\n\n  return server;\n}\n","/**\n * MCP server authentication — auto-provisioning and shared config.\n *\n * Resolution order:\n * 1. CORP_API_KEY + CORP_WORKSPACE_ID env vars (explicit)\n * 2. ~/.corp/config.json (shared with TUI/CLI)\n * 3. Auto-provision via POST /v1/workspaces/provision\n */\n\nimport { readFileSync, writeFileSync, mkdirSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { homedir } from \"node:os\";\n\nexport interface McpAuthContext {\n  workspaceId: string;\n  apiKey: string;\n  scopes: string[];\n}\n\nconst CONFIG_FILE = join(homedir(), \".corp\", \"config.json\");\n\nfunction loadConfig(): Record<string, string> {\n  try {\n    return JSON.parse(readFileSync(CONFIG_FILE, \"utf-8\"));\n  } catch {\n    return {};\n  }\n}\n\nfunction saveConfig(cfg: Record<string, string>): void {\n  const dir = join(homedir(), \".corp\");\n  mkdirSync(dir, { recursive: true });\n  writeFileSync(CONFIG_FILE, JSON.stringify(cfg, null, 2) + \"\\n\");\n}\n\nasync function provision(apiUrl: string): Promise<Record<string, string>> {\n  const resp = await fetch(`${apiUrl.replace(/\\/+$/, \"\")}/v1/workspaces/provision`, {\n    method: \"POST\",\n    headers: { \"Content-Type\": \"application/json\" },\n    body: JSON.stringify({ name: \"mcp-auto\" }),\n    signal: AbortSignal.timeout(15_000),\n  });\n  if (!resp.ok) throw new Error(`Provision failed: ${resp.status}`);\n  return await resp.json() as Record<string, string>;\n}\n\nexport async function resolveOrProvisionAuth(\n  apiUrl: string = \"https://api.thecorporation.ai\",\n): Promise<McpAuthContext> {\n  // 1. Env vars\n  const envKey = process.env.CORP_API_KEY || \"\";\n  const envWs = process.env.CORP_WORKSPACE_ID || \"\";\n  if (envKey && envWs) {\n    return { workspaceId: envWs, apiKey: envKey, scopes: [\"*\"] };\n  }\n\n  // 2. Config file\n  const cfg = loadConfig();\n  if (cfg.api_key && cfg.workspace_id) {\n    return { workspaceId: cfg.workspace_id, apiKey: cfg.api_key, scopes: [\"*\"] };\n  }\n\n  // 3. Auto-provision\n  const result = await provision(apiUrl);\n  cfg.api_key = result.api_key;\n  cfg.workspace_id = result.workspace_id;\n  if (!cfg.api_url) cfg.api_url = apiUrl;\n  saveConfig(cfg);\n\n  return { workspaceId: result.workspace_id, apiKey: result.api_key, scopes: [\"*\"] };\n}\n"],"mappings":"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","names":["CorpAPIClient","join","homedir","CorpAPIClient"]}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@thecorporation/mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for agent-native corporate operations",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "thecorporation": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "@thecorporation/corp-tools": "0.1.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.0",
+    "@types/node": "^22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "Apache-2.0"
+}

package/server.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.thecorporation/corporate-os",
+  "title": "The Corporation",
+  "description": "Agent-native corporate operations — form LLCs, manage equity, run payroll, generate contracts, file taxes. 12 MCP tools, zero corporate law expertise required.",
+  "version": "0.1.0",
+  "repository": {
+    "url": "https://github.com/thecorporationai/thecorporation-mono",
+    "source": "github"
+  },
+  "packages": [
+    {
+      "registryType": "pypi",
+      "identifier": "thecorporation",
+      "version": "0.1.0",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}

package/smithery.yaml

@@ -0,0 +1,10 @@
+startCommand:
+  type: stdio
+  configSchema:
+    type: object
+    properties: {}
+  commandFunction: |-
+    (config) => ({
+      command: "uvx",
+      args: ["thecorporation"]
+    })

package/src/auth.ts

@@ -0,0 +1,71 @@
+/**
+ * MCP server authentication — auto-provisioning and shared config.
+ *
+ * Resolution order:
+ * 1. CORP_API_KEY + CORP_WORKSPACE_ID env vars (explicit)
+ * 2. ~/.corp/config.json (shared with TUI/CLI)
+ * 3. Auto-provision via POST /v1/workspaces/provision
+ */
+
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+export interface McpAuthContext {
+  workspaceId: string;
+  apiKey: string;
+  scopes: string[];
+}
+
+const CONFIG_FILE = join(homedir(), ".corp", "config.json");
+
+function loadConfig(): Record<string, string> {
+  try {
+    return JSON.parse(readFileSync(CONFIG_FILE, "utf-8"));
+  } catch {
+    return {};
+  }
+}
+
+function saveConfig(cfg: Record<string, string>): void {
+  const dir = join(homedir(), ".corp");
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(CONFIG_FILE, JSON.stringify(cfg, null, 2) + "\n");
+}
+
+async function provision(apiUrl: string): Promise<Record<string, string>> {
+  const resp = await fetch(`${apiUrl.replace(/\/+$/, "")}/v1/workspaces/provision`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ name: "mcp-auto" }),
+    signal: AbortSignal.timeout(15_000),
+  });
+  if (!resp.ok) throw new Error(`Provision failed: ${resp.status}`);
+  return await resp.json() as Record<string, string>;
+}
+
+export async function resolveOrProvisionAuth(
+  apiUrl: string = "https://api.thecorporation.ai",
+): Promise<McpAuthContext> {
+  // 1. Env vars
+  const envKey = process.env.CORP_API_KEY || "";
+  const envWs = process.env.CORP_WORKSPACE_ID || "";
+  if (envKey && envWs) {
+    return { workspaceId: envWs, apiKey: envKey, scopes: ["*"] };
+  }
+
+  // 2. Config file
+  const cfg = loadConfig();
+  if (cfg.api_key && cfg.workspace_id) {
+    return { workspaceId: cfg.workspace_id, apiKey: cfg.api_key, scopes: ["*"] };
+  }
+
+  // 3. Auto-provision
+  const result = await provision(apiUrl);
+  cfg.api_key = result.api_key;
+  cfg.workspace_id = result.workspace_id;
+  if (!cfg.api_url) cfg.api_url = apiUrl;
+  saveConfig(cfg);
+
+  return { workspaceId: result.workspace_id, apiKey: result.api_key, scopes: ["*"] };
+}

package/src/index.ts

@@ -0,0 +1,23 @@
+/**
+ * Entry point — resolve auth, start MCP server on stdio.
+ */
+
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CorpAPIClient } from "@thecorporation/corp-tools";
+import { createMcpServer } from "./server.js";
+import { resolveOrProvisionAuth } from "./auth.js";
+
+async function main(): Promise<void> {
+  const apiUrl = process.env.CORP_API_URL || "https://api.thecorporation.ai";
+
+  const ctx = await resolveOrProvisionAuth(apiUrl);
+  const client = new CorpAPIClient(apiUrl, ctx.apiKey, ctx.workspaceId);
+  const server = createMcpServer(client);
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch((err) => {
+  console.error("Fatal:", err);
+  process.exit(1);
+});

package/src/server.ts

@@ -0,0 +1,94 @@
+/**
+ * MCP server — registers all tools from corp-tools definitions,
+ * dispatches to the backend API via CorpAPIClient.
+ */
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import {
+  GENERATED_TOOL_DEFINITIONS,
+  CorpAPIClient,
+  executeTool,
+  type ToolContext,
+} from "@thecorporation/corp-tools";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+// ---------------------------------------------------------------------------
+// Build Zod schemas from JSON Schema properties
+// ---------------------------------------------------------------------------
+
+interface ToolFunction {
+  name: string;
+  description: string;
+  parameters: {
+    type: string;
+    properties: Record<string, { type: string; description?: string; enum?: string[]; items?: { type: string } }>;
+    required: string[];
+  };
+}
+
+interface ToolDef {
+  type: string;
+  function: ToolFunction;
+}
+
+function buildZodShape(fn: ToolFunction): Record<string, z.ZodTypeAny> {
+  const shape: Record<string, z.ZodTypeAny> = {};
+  const props = fn.parameters.properties || {};
+  const required = new Set(fn.parameters.required || []);
+
+  for (const [pname, pinfo] of Object.entries(props)) {
+    let schema: z.ZodTypeAny;
+    switch (pinfo.type) {
+      case "integer":
+        schema = z.number().int();
+        break;
+      case "number":
+        schema = z.number();
+        break;
+      case "boolean":
+        schema = z.boolean();
+        break;
+      case "array":
+        schema = z.array(pinfo.items?.type === "object" ? z.record(z.unknown()) : z.string());
+        break;
+      case "object":
+        schema = z.record(z.unknown());
+        break;
+      default:
+        schema = pinfo.enum ? z.enum(pinfo.enum as [string, ...string[]]) : z.string();
+    }
+    if (pinfo.description) schema = schema.describe(pinfo.description);
+    if (!required.has(pname)) schema = schema.optional();
+    shape[pname] = schema;
+  }
+  return shape;
+}
+
+// ---------------------------------------------------------------------------
+// Create and configure MCP server
+// ---------------------------------------------------------------------------
+
+export function createMcpServer(client: CorpAPIClient): McpServer {
+  const server = new McpServer({
+    name: "thecorporation",
+    version: "0.1.0",
+  });
+
+  const ctx: ToolContext = {
+    dataDir: join(homedir(), ".corp", "data"),
+  };
+
+  for (const td of GENERATED_TOOL_DEFINITIONS as unknown as ToolDef[]) {
+    const fn = td.function;
+    const shape = buildZodShape(fn);
+
+    server.tool(fn.name, fn.description, shape, async (args) => {
+      const result = await executeTool(fn.name, args as Record<string, unknown>, client, ctx);
+      return { content: [{ type: "text" as const, text: result }] };
+    });
+  }
+
+  return server;
+}

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "outDir": "dist",
+    "rootDir": "src",
+    "declaration": true,
+    "sourceMap": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "skipLibCheck": true
+  },
+  "include": ["src"]
+}

package/tsup.config.ts

@@ -0,0 +1,13 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+  entry: ["src/index.ts"],
+  format: ["esm"],
+  target: "node20",
+  outDir: "dist",
+  clean: true,
+  dts: true,
+  sourcemap: true,
+  splitting: false,
+  banner: { js: "#!/usr/bin/env node" },
+});