@corpuslaw/mcp-server 0.1.0

package/README.md

@@ -0,0 +1,47 @@
+# @corpuslaw/mcp-server
+
+MCP server giving any AI agent **571,582 provisions of US federal, state and
+municipal law** with verbatim citations — plus a complete LLC / nonprofit
+formation intake.
+
+```bash
+npx -y @corpuslaw/mcp-server
+```
+
+## Claude Desktop / Cursor / any MCP client
+
+```json
+{
+  "mcpServers": {
+    "corpus-law": {
+      "command": "npx",
+      "args": ["-y", "@corpuslaw/mcp-server"],
+      "env": { "CORPUS_API_KEY": "your-key-here" }
+    }
+  }
+}
+```
+
+`CORPUS_API_KEY` is optional but recommended — [free and instant](https://corpuslaw.us/settings).
+Anonymous access gets 100 searches/month per IP; a free key gets 1,000/month at
+30/min.
+
+> **If your client speaks HTTP MCP**, skip this package entirely and point it
+> straight at `https://corpuslaw.us/api/mcp`. This bridge exists for stdio-only
+> clients.
+
+## Tools
+
+`law.search` · `law.get_node` · `law.list_coverage` · `formation.requirements` ·
+`formation.lookup_naics` · `formation.handoff` · `account.status`
+
+Formation tools are never metered.
+
+## Environment
+
+| Variable | Default | Purpose |
+|---|---|---|
+| `CORPUS_API_KEY` | _(optional)_ | Raises rate limits; attributes formation handoffs to you |
+| `CORPUS_BASE_URL` | `https://corpuslaw.us` | Point at your own deployment |
+
+Apache-2.0 · [source](https://github.com/teakesdev/corpus-agent-kit) · [security policy](https://github.com/teakesdev/corpus-agent-kit/blob/main/SECURITY.md)

package/dist/bridge.js

@@ -0,0 +1,27 @@
+export async function handleMessage(msg, deps) {
+    if (!msg || typeof msg !== "object")
+        return null;
+    if (typeof msg.method === "string" && msg.method.startsWith("notifications/"))
+        return null;
+    if (msg.method === "ping")
+        return { jsonrpc: "2.0", id: msg.id ?? null, result: {} };
+    try {
+        return await deps.forward(msg);
+    }
+    catch (err) {
+        return { jsonrpc: "2.0", id: msg.id ?? null, error: { code: -32000, message: String(err.message ?? err) } };
+    }
+}
+export function makeForward(mcpUrl, apiKey) {
+    return async (msg) => {
+        const headers = { "Content-Type": "application/json" };
+        if (apiKey)
+            headers.Authorization = `Bearer ${apiKey}`;
+        const res = await fetch(mcpUrl, { method: "POST", headers, body: JSON.stringify(msg) });
+        if (!res.ok && res.status !== 202)
+            throw new Error(`hosted MCP returned HTTP ${res.status}`);
+        if (res.status === 202)
+            return null;
+        return (await res.json());
+    };
+}

package/dist/index.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/** MCP stdio transport: newline-delimited JSON-RPC on stdin/stdout. */
+import { createInterface } from "node:readline";
+import { handleMessage, makeForward } from "./bridge.js";
+const base = process.env.CORPUS_BASE_URL || "https://corpuslaw.us";
+const forward = makeForward(process.env.CORPUS_MCP_URL || `${base}/api/mcp`, process.env.CORPUS_API_KEY);
+const rl = createInterface({ input: process.stdin });
+rl.on("line", async (line) => {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return;
+    let msg;
+    try {
+        msg = JSON.parse(trimmed);
+    }
+    catch {
+        process.stdout.write(JSON.stringify({ jsonrpc: "2.0", id: null, error: { code: -32700, message: "Parse error" } }) + "\n");
+        return;
+    }
+    const res = await handleMessage(msg, { forward });
+    if (res)
+        process.stdout.write(JSON.stringify(res) + "\n");
+});

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@corpuslaw/mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server giving any AI agent 571,582 provisions of US federal, state and municipal law with verbatim citations \u2014 plus LLC/nonprofit formation intake. Thin client of corpuslaw.us.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "mcp-server",
+    "law",
+    "legal",
+    "legaltech",
+    "us-law",
+    "statutes",
+    "legal-research",
+    "business-formation",
+    "llc",
+    "ai-agents",
+    "claude",
+    "cursor"
+  ],
+  "license": "Apache-2.0",
+  "author": "Corpus (https://corpuslaw.us)",
+  "homepage": "https://github.com/teakesdev/corpus-agent-kit#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/teakesdev/corpus-agent-kit.git",
+    "directory": "mcp-server"
+  },
+  "bugs": {
+    "url": "https://github.com/teakesdev/corpus-agent-kit/issues"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "corpus-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run build && node --test 'test/**/*.test.mjs'",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3",
+    "@types/node": "^22.0.0"
+  }
+}