@thecorporation/mcp-server 0.1.0 → 1.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +75 -24
  2. package/package.json +8 -3
package/README.md CHANGED
@@ -1,21 +1,19 @@
1
- # The Corporation — MCP Server
1
+ # @thecorporation/mcp-server
2
2
 
3
- <!-- mcp-name: io.github.thecorporation/corporate-os -->
3
+ MCP server that gives AI agents full corporate operations capabilities — entity formation, equity management, payroll, contracts, banking, and tax compliance. 36 tools, zero corporate law expertise required.
4
4
 
5
- Your agent just formed an LLC in 4 tool calls.
6
-
7
- 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.
5
+ Part of [The Corporation](https://thecorporation.ai) agent-native corporate infrastructure.
8
6
 
9
7
  ## Install
10
8
 
11
9
  ```bash
12
- uv pip install thecorporation
10
+ npm install -g @thecorporation/mcp-server
13
11
  ```
14
12
 
15
13
  Or run directly:
16
14
 
17
15
  ```bash
18
- uvx thecorporation
16
+ npx @thecorporation/mcp-server
19
17
  ```
20
18
 
21
19
  ## Configure with Claude Desktop
@@ -26,29 +24,83 @@ Add to your `claude_desktop_config.json`:
26
24
  {
27
25
  "mcpServers": {
28
26
  "thecorporation": {
29
- "command": "uvx",
30
- "args": ["thecorporation"]
27
+ "command": "npx",
28
+ "args": ["-y", "@thecorporation/mcp-server"]
29
+ }
30
+ }
31
+ }
32
+ ```
33
+
34
+ ## Configure with Claude Code
35
+
36
+ ```bash
37
+ claude mcp add thecorporation -- npx -y @thecorporation/mcp-server
38
+ ```
39
+
40
+ ## Authentication
41
+
42
+ On first run, the server automatically provisions a workspace and saves credentials to `~/.corp/config.json`. To use an existing workspace, set environment variables:
43
+
44
+ ```json
45
+ {
46
+ "mcpServers": {
47
+ "thecorporation": {
48
+ "command": "npx",
49
+ "args": ["-y", "@thecorporation/mcp-server"],
50
+ "env": {
51
+ "CORP_API_KEY": "sk_...",
52
+ "CORP_WORKSPACE_ID": "ws_..."
53
+ }
31
54
  }
32
55
  }
33
56
  }
34
57
  ```
35
58
 
59
+ | Env var | Description | Default |
60
+ |---|---|---|
61
+ | `CORP_API_URL` | API base URL | `https://api.thecorporation.ai` |
62
+ | `CORP_API_KEY` | API key | auto-provisioned |
63
+ | `CORP_WORKSPACE_ID` | Workspace ID | auto-provisioned |
64
+
36
65
  ## Tools
37
66
 
38
- | Tool | What it does |
39
- |------|-------------|
67
+ | Tool | Description |
68
+ |---|---|
40
69
  | `form_entity` | Form an LLC or corporation in any US state |
41
- | `issue_equity` | Issue shares or membership units to recipients |
42
- | `issue_safe` | Issue SAFE notes (pre-money, post-money, MFN) to investors |
43
- | `create_invoice` | Create and send invoices to customers |
70
+ | `convert_entity` | Convert entity type (e.g. LLC to C-Corp) |
71
+ | `dissolve_entity` | Initiate entity dissolution |
72
+ | `issue_equity` | Issue shares or membership units |
73
+ | `issue_safe` | Issue SAFE notes (pre-money, post-money, MFN) |
74
+ | `transfer_shares` | Transfer shares between parties |
75
+ | `calculate_distribution` | Calculate and record distributions |
76
+ | `create_invoice` | Create and send invoices |
44
77
  | `run_payroll` | Run payroll for employees and contractors |
45
78
  | `submit_payment` | Send payments via ACH, wire, or check |
46
- | `get_signing_link` | Generate a signing link documents can only be signed by humans via this URL |
47
- | `convene_meeting` | Convene board, shareholder, or member meetings |
48
- | `cast_vote` | Cast votes on meeting agenda items |
49
- | `open_bank_account` | Open a business bank account (auto-assembles KYB) |
79
+ | `open_bank_account` | Open a business bank account |
80
+ | `reconcile_ledger` | Reconcile the entity ledger |
50
81
  | `generate_contract` | Generate NDAs, contractor agreements, offer letters |
82
+ | `get_signing_link` | Generate a signing URL for documents |
83
+ | `get_document_link` | Get a document download/preview link |
51
84
  | `file_tax_document` | Generate 1099s, K-1s, estimated tax filings |
85
+ | `track_deadline` | Track compliance and filing deadlines |
86
+ | `classify_contractor` | Analyze contractor classification risk |
87
+ | `convene_meeting` | Convene board, shareholder, or member meetings |
88
+ | `schedule_meeting` | Schedule a governance meeting |
89
+ | `cast_vote` | Cast votes on meeting agenda items |
90
+ | `create_agent` | Create an autonomous AI agent |
91
+ | `send_agent_message` | Send a message to an agent |
92
+ | `update_agent` | Update agent configuration |
93
+ | `add_agent_skill` | Add a skill to an agent |
94
+ | `get_workspace_status` | Workspace summary |
95
+ | `list_entities` | List all entities |
96
+ | `get_cap_table` | View cap table |
97
+ | `list_documents` | List documents |
98
+ | `list_safe_notes` | List SAFE notes |
99
+ | `list_agents` | List agents |
100
+ | `list_obligations` | List compliance obligations |
101
+ | `get_checklist` | Read the workspace checklist |
102
+ | `update_checklist` | Update the workspace checklist |
103
+ | `get_billing_status` | Show billing tier and usage |
52
104
 
53
105
  ## Example Prompts
54
106
 
@@ -56,7 +108,7 @@ Add to your `claude_desktop_config.json`:
56
108
  - "Issue a $500K post-money SAFE with a $10M cap to Jane Smith"
57
109
  - "Generate an NDA between my company and Acme Corp"
58
110
  - "Run payroll for January 2025"
59
- - "File 1099-NECs for all my contractors for tax year 2025"
111
+ - "File 1099-NECs for all my contractors"
60
112
 
61
113
  ## How It Works
62
114
 
@@ -71,12 +123,11 @@ Agent Tool Call → Intent → Policy Evaluation → Execution → Receipt
71
123
  - Human obligations auto-generated for legally required signatures
72
124
  - Double-entry ledger tracks every dollar
73
125
 
74
- ## What This Is (and Isn't)
75
-
76
- **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.
126
+ ## Links
77
127
 
78
- **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.
128
+ - [thecorporation.ai](https://thecorporation.ai)
129
+ - [GitHub](https://github.com/thecorporationai/thecorporation-mono/tree/main/packages/mcp-server)
79
130
 
80
131
  ## License
81
132
 
82
- Apache 2.0
133
+ Apache-2.0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@thecorporation/mcp-server",
3
- "version": "0.1.0",
3
+ "version": "1.0.4",
4
4
  "description": "MCP server for agent-native corporate operations",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -13,7 +13,7 @@
13
13
  },
14
14
  "dependencies": {
15
15
  "@modelcontextprotocol/sdk": "^1.12.0",
16
- "@thecorporation/corp-tools": "0.1.0",
16
+ "@thecorporation/corp-tools": "1.0.4",
17
17
  "zod": "^3.24.0"
18
18
  },
19
19
  "devDependencies": {
@@ -27,5 +27,10 @@
27
27
  "engines": {
28
28
  "node": ">=20"
29
29
  },
30
- "license": "Apache-2.0"
30
+ "license": "Apache-2.0",
31
+ "repository": {
32
+ "type": "git",
33
+ "url": "https://github.com/thecorporationai/thecorporation-mono.git",
34
+ "directory": "packages/mcp-server"
35
+ }
31
36
  }