@thecorporation/mcp-server 0.1.0 → 1.0.5

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 +76 -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
+ 36 MCP tools that give AI agents full corporate operations capabilities. Entity formation, equity management, payroll, contracts, banking, tax compliance — every tool call passes through the governance kernel, produces an atomic git commit, and returns a signed receipt. Your agent gets corporate powers. Your corporation gets an audit trail.
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 [TheCorporation](https://thecorporation.ai) — version-controlled governance, autonomous agents, and open-source 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,84 @@ 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_signer_link` | Generate a signing link for human obligations |
104
+ | `get_billing_status` | Show billing tier and usage |
52
105
 
53
106
  ## Example Prompts
54
107
 
@@ -56,7 +109,7 @@ Add to your `claude_desktop_config.json`:
56
109
  - "Issue a $500K post-money SAFE with a $10M cap to Jane Smith"
57
110
  - "Generate an NDA between my company and Acme Corp"
58
111
  - "Run payroll for January 2025"
59
- - "File 1099-NECs for all my contractors for tax year 2025"
112
+ - "File 1099-NECs for all my contractors"
60
113
 
61
114
  ## How It Works
62
115
 
@@ -71,12 +124,11 @@ Agent Tool Call → Intent → Policy Evaluation → Execution → Receipt
71
124
  - Human obligations auto-generated for legally required signatures
72
125
  - Double-entry ledger tracks every dollar
73
126
 
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.
127
+ ## Links
77
128
 
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.
129
+ - [thecorporation.ai](https://thecorporation.ai)
130
+ - [GitHub](https://github.com/thecorporationai/thecorporation-mono/tree/main/packages/mcp-server)
79
131
 
80
132
  ## License
81
133
 
82
- Apache 2.0
134
+ 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.5",
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.5",
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
  }