@lovie-ai/formation-mcp-server 1.0.4 → 1.0.6

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.
package/README.md CHANGED
@@ -1,256 +1,249 @@
1
- # Lovie CLI - Streamlined US Company Formation
1
+ # Lovie Formation MCP Server
2
2
 
3
- > Form your US company in minutes, right from your terminal.
3
+ > Form your US company through AI assistants with MCP (Model Context Protocol)
4
4
 
5
- [![npm version](https://badge.fury.io/js/lovie.svg)](https://badge.fury.io/js/lovie)
5
+ [![npm version](https://badge.fury.io/js/@lovie-ai%2Fformation-mcp-server.svg)](https://www.npmjs.com/package/@lovie-ai/formation-mcp-server)
6
6
  [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
7
7
 
8
- Lovie CLI is a conversational command-line tool that guides you through forming a US company (LLC, C-Corp, or S-Corp) with real-time name checking, automatic document generation, and seamless state filing.
8
+ Lovie Formation MCP Server enables AI assistants to help users form US companies (LLC, C-Corp, or S-Corp) with real-time name checking, automatic document generation, and seamless state filing.
9
9
 
10
- ## Features
10
+ ## What is Lovie?
11
11
 
12
- - **🚀 Quick Formation** - Complete company formation in under 15 minutes
13
- - **💬 Conversational Interface** - Plain language, no legal jargon
14
- - **⚡ Real-Time Name Check** - Instant company name availability verification
15
- - **📄 Auto-Document Generation** - Professional incorporation documents created automatically
16
- - **🏛️ Direct State Filing** - Submit directly to state authorities
17
- - **💳 Secure Payment** - PCI-compliant payment processing
18
- - **💾 Resume Capability** - Save progress and resume anytime
19
- - **🖥️ Cross-Platform** - Works on macOS, Windows, and Linux
12
+ Lovie is an AI-first financial platform that helps you start and run your business:
20
13
 
21
- ## 🎯 Quick Start
14
+ - **Free company formation** - No service fees, you only pay state filing fees
15
+ - **Lovie as your incorporator** - We handle all the paperwork
16
+ - **In-house legal team** - Working every day to keep you compliant with local and federal law
17
+ - **All legal documents included** - Certificate of Formation, Operating Agreement, Bylaws
18
+ - **Business address** - Virtual or physical address available
19
+ - **Bank account setup** - Help opening and managing your company bank account
20
+ - **AI-first financial platform** - Token-based pricing (a little more than free)
22
21
 
23
- ### Installation
22
+ ## Quick Start
24
23
 
25
- **macOS (Homebrew)**
26
- ```bash
27
- brew install lovie
28
- ```
24
+ ### Claude Desktop
29
25
 
30
- **Windows/Linux/macOS (npm)**
31
- ```bash
32
- npm install -g lovie
26
+ Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
27
+
28
+ ```json
29
+ {
30
+ "mcpServers": {
31
+ "lovie-formation": {
32
+ "command": "npx",
33
+ "args": ["@lovie-ai/formation-mcp-server@latest"]
34
+ }
35
+ }
36
+ }
33
37
  ```
34
38
 
35
- ### Basic Usage
39
+ Restart Claude Desktop.
36
40
 
37
- Start the company formation process:
38
- ```bash
39
- lovie
40
- ```
41
+ ### Cursor
41
42
 
42
- Check version:
43
- ```bash
44
- lovie --version
43
+ Edit `.cursor/mcp.json` in your project or `~/.cursor/mcp.json` globally:
44
+
45
+ ```json
46
+ {
47
+ "mcpServers": {
48
+ "lovie-formation": {
49
+ "command": "npx",
50
+ "args": ["@lovie-ai/formation-mcp-server@latest"]
51
+ }
52
+ }
53
+ }
45
54
  ```
46
55
 
47
- Get help:
56
+ Restart Cursor.
57
+
58
+ ### Claude Code (CLI)
59
+
48
60
  ```bash
49
- lovie --help
61
+ claude mcp add lovie-formation npx @lovie-ai/formation-mcp-server@latest
50
62
  ```
51
63
 
52
- ## 📋 What You'll Need
64
+ ### Windsurf
53
65
 
54
- Before starting, have these ready:
66
+ Edit `~/.codeium/windsurf/mcp_config.json`:
55
67
 
56
- - **Company Information**
57
- - Desired company name (we'll check availability)
58
- - State of incorporation
59
- - Company type (LLC, C-Corp, or S-Corp)
68
+ ```json
69
+ {
70
+ "mcpServers": {
71
+ "lovie-formation": {
72
+ "command": "npx",
73
+ "args": ["@lovie-ai/formation-mcp-server@latest"]
74
+ }
75
+ }
76
+ }
77
+ ```
60
78
 
61
- - **Shareholder/Member Details**
62
- - Full legal names
63
- - Addresses
64
- - SSN or EIN
65
- - Ownership percentages
79
+ ### Manus
66
80
 
67
- - **Registered Agent**
68
- - Name and address (must be in the state of incorporation)
81
+ In Manus settings, add MCP server:
82
+ - **Name**: `lovie-formation`
83
+ - **Command**: `npx`
84
+ - **Args**: `@lovie-ai/formation-mcp-server@latest`
69
85
 
70
- - **Payment Method**
71
- - Credit/debit card for state filing fees and service fee
86
+ ### Generic (Any MCP Client)
72
87
 
73
- ## 🎬 Usage Example
88
+ ```json
89
+ {
90
+ "command": "npx",
91
+ "args": ["@lovie-ai/formation-mcp-server@latest"]
92
+ }
93
+ ```
74
94
 
75
- ```bash
76
- $ lovie
95
+ ## Available Tools
77
96
 
78
- ┌─────────────────────────────────────┐
79
- │ Welcome to Lovie Company Formation │
80
- └─────────────────────────────────────┘
97
+ ### Information Tools
81
98
 
82
- Let's form your company! I'll guide you through the process.
99
+ | Tool | Description |
100
+ |------|-------------|
101
+ | `formation_get_info` | Get information about pricing, FAQ, company types, requirements, or step-by-step guide |
102
+ | `formation_list_info_topics` | List all available information topics |
83
103
 
84
- ? What would you like to name your company?
85
- › Acme Innovations
104
+ ### Session Tools
86
105
 
87
- Checking name availability...
88
- ✓ "Acme Innovations" is available in Delaware!
106
+ | Tool | Description |
107
+ |------|-------------|
108
+ | `formation_start` | Start a new formation session |
109
+ | `formation_get_status` | Get current session status and progress |
110
+ | `formation_resume` | Get guidance on the next step |
89
111
 
90
- ? Which state would you like to incorporate in?
91
- › ◉ Delaware (Recommended for most startups)
92
- ○ California
93
- ○ New York
94
- ○ Texas
95
- ↓ 46 more states...
112
+ ### Company Setup Tools
96
113
 
97
- ? What type of company would you like to form?
98
- ◉ LLC (Limited Liability Company)
99
- Simple structure, pass-through taxation
100
- C-Corporation
101
- Best for raising venture capital
102
- S-Corporation
103
- Pass-through taxation with corporate structure
114
+ | Tool | Description |
115
+ |------|-------------|
116
+ | `formation_set_state` | Set formation state (currently Delaware only) |
117
+ | `formation_set_company_type` | Set company type (LLC, C-Corp, or S-Corp) |
118
+ | `formation_set_entity_ending` | Set legal suffix (LLC, Inc., Corp., etc.) |
119
+ | `formation_set_company_name` | Set the company name |
120
+ | `formation_check_name` | Check name availability with Delaware Secretary of State |
104
121
 
105
- ...
122
+ ### Stakeholder Tools
106
123
 
107
- ┌──────────────────────────────────────┐
108
- │ Review Your Company Information │
109
- └──────────────────────────────────────┘
124
+ | Tool | Description |
125
+ |------|-------------|
126
+ | `formation_set_registered_agent` | Set registered agent details |
127
+ | `formation_set_share_structure` | Set authorized shares and par value (Corp only) |
128
+ | `formation_add_shareholder` | Add a shareholder or member |
129
+ | `formation_set_authorized_party` | Set the person who will sign documents |
110
130
 
111
- Company Details:
112
- Name: Acme Innovations LLC
113
- State: Delaware
114
- Type: Limited Liability Company
131
+ ### Certificate Tools
115
132
 
116
- Members:
117
- 1. John Smith (100%)
118
- 123 Main St, San Francisco, CA 94102
133
+ | Tool | Description |
134
+ |------|-------------|
135
+ | `formation_generate_certificate` | Generate Certificate of Incorporation PDF |
136
+ | `formation_approve_certificate` | Approve certificate and complete formation |
119
137
 
120
- Registered Agent:
121
- Delaware Corporate Services
122
- 456 Business Ave, Wilmington, DE 19801
138
+ ## Available Resources
123
139
 
124
- Costs:
125
- State Filing Fee: $90.00
126
- Service Fee: $49.00
127
- ─────────────────────────────
128
- Total: $139.00
140
+ The MCP server also provides resources that AI assistants can read:
129
141
 
130
- ? Everything look correct? (Y/n)
142
+ | Resource URI | Description |
143
+ |--------------|-------------|
144
+ | `formation://guide` | Step-by-step formation guide |
145
+ | `formation://pricing` | Lovie pricing and Delaware state fees |
146
+ | `formation://company-types` | LLC vs C-Corp vs S-Corp comparison |
147
+ | `formation://faq` | Frequently asked questions |
148
+ | `formation://requirements` | Required information checklist |
131
149
 
132
- Payment processed successfully!
133
- ⠋ Generating incorporation documents...
134
- ✓ Documents generated
135
- ⠋ Filing with Delaware Division of Corporations...
136
- ✓ Filed successfully!
150
+ ## Example Conversation
137
151
 
138
- ┌──────────────────────────────────────┐
139
- │ 🎉 Congratulations! │
140
- └──────────────────────────────────────┘
152
+ **User**: I want to start a company
141
153
 
142
- Your company has been formed!
154
+ **AI Assistant**: I'll help you form a company with Lovie! Let me start a formation session.
143
155
 
144
- Filing Details:
145
- Confirmation #: DE-2025-123456
146
- Filing Date: December 23, 2025
147
- Status: Approved
156
+ *Calls `formation_start`*
148
157
 
149
- Documents saved to: ~/lovie/acme-innovations-llc/
158
+ Great! I've started your formation session. Lovie offers free company formation - you only pay the state filing fees. Let me guide you through the process:
150
159
 
151
- Next Steps:
152
- 1. Apply for EIN (Employer ID Number) at irs.gov
153
- 2. Open a business bank account
154
- 3. Set up accounting software
155
- 4. File annual reports as required
160
+ 1. First, we'll set up in Delaware (the most business-friendly state)
161
+ 2. Then choose your company type (LLC, C-Corp, or S-Corp)
162
+ 3. Pick your company name
163
+ 4. Add your information
164
+ 5. Generate and approve your certificate
156
165
 
157
- Questions? Visit https://lovie.io/support
158
- ```
166
+ Let's begin! What type of company would you like to form?
159
167
 
160
- ## 🗂️ Supported Company Types
168
+ ## Pricing
161
169
 
162
- ### LLC (Limited Liability Company)
163
- - Simple structure with flexible management
164
- - Pass-through taxation
165
- - Personal liability protection
166
- - Fewer compliance requirements
167
- - **Best for**: Small businesses, side projects, real estate
170
+ ### Lovie Service Fee
171
+ **FREE** - Lovie doesn't charge for company formation.
168
172
 
169
- ### C-Corporation
170
- - Formal corporate structure
171
- - Can issue multiple stock classes
172
- - Attracts venture capital investment
173
- - Corporate taxation (double taxation)
174
- - **Best for**: Startups planning to raise VC funding
173
+ ### Delaware State Filing Fees
175
174
 
176
- ### S-Corporation
177
- - Corporate structure with pass-through taxation
178
- - Ownership restrictions (100 shareholders max, US citizens/residents only)
179
- - Tax savings on self-employment
180
- - More compliance requirements
181
- - **Best for**: Small to medium businesses with US-based owners
175
+ | Company Type | Standard | 24-Hour | Same-Day |
176
+ |--------------|----------|---------|----------|
177
+ | LLC | $90 | +$50 | +$100 |
178
+ | C-Corp | $89+ | +$50 | +$100 |
179
+ | S-Corp | $89+ | +$50 | +$100 |
180
+
181
+ ### What's Included (Free)
182
182
 
183
- ## 🗺️ Supported States
183
+ - Company formation filing
184
+ - Lovie as your incorporator
185
+ - Certificate of Formation/Incorporation
186
+ - Operating Agreement (LLC) or Bylaws (Corp)
187
+ - Step-by-step compliance guide
188
+ - In-house legal team keeping you compliant
189
+ - Ongoing compliance reminders
184
190
 
185
- **v1.0 (MVP)**: Delaware
191
+ ## Company Types
186
192
 
187
- **Planned**: California, Texas, New York, Florida, Wyoming, Nevada, and 44+ more states
193
+ ### LLC (Limited Liability Company)
194
+ - Simple structure, flexible management
195
+ - Pass-through taxation (no double taxation)
196
+ - Best for: Small businesses, startups, real estate
188
197
 
189
- ## 🔒 Security & Privacy
198
+ ### C-Corporation
199
+ - Can issue multiple classes of stock
200
+ - Attractive to venture capital investors
201
+ - Best for: Startups planning to raise funding
190
202
 
191
- - **Encryption**: All sensitive data encrypted at rest and in transit
192
- - **PCI Compliance**: Payment processing through Stripe (PCI Level 1 certified)
193
- - **Data Deletion**: Sensitive information cleared after formation completion
194
- - **No Storage**: Credit card details never stored locally or on our servers
195
- - **Secure Sessions**: Unique session IDs with encrypted local storage
203
+ ### S-Corporation
204
+ - Pass-through taxation with corporate structure
205
+ - Limited to 100 US-based shareholders
206
+ - Best for: Small businesses wanting tax advantages
196
207
 
197
- ## 🆘 Troubleshooting
208
+ ## Development
198
209
 
199
- ### Installation Issues
210
+ ### Install Dependencies
200
211
 
201
- **Error: Command not found**
202
212
  ```bash
203
- # Verify installation
204
- which lovie
205
-
206
- # If using npm, ensure global bin is in PATH
207
- npm config get prefix
208
- # Add to PATH: export PATH="$(npm config get prefix)/bin:$PATH"
213
+ npm install
209
214
  ```
210
215
 
211
- **Error: Permission denied**
216
+ ### Build
217
+
212
218
  ```bash
213
- # macOS/Linux: Use sudo (not recommended) or fix npm permissions
214
- npm config set prefix ~/.npm-global
215
- export PATH=~/.npm-global/bin:$PATH
219
+ npm run build
216
220
  ```
217
221
 
218
- ### Common Issues
219
-
220
- **"Name not available" errors**: Try variations of your company name. Add LLC/Inc suffix, use different words.
222
+ ### Run Locally
221
223
 
222
- **Payment declined**: Check card details, ensure sufficient funds, try a different card.
224
+ ```bash
225
+ node dist/mcp/index.js
226
+ ```
223
227
 
224
- **Connection timeout**: Check internet connection, retry operation. Data is saved automatically.
228
+ ### Test with MCP Inspector
225
229
 
226
- See [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) for detailed solutions.
230
+ ```bash
231
+ npx @modelcontextprotocol/inspector node dist/mcp/index.js
232
+ ```
227
233
 
228
- ## 📚 Documentation
234
+ ## Support
229
235
 
230
- - [User Guide](docs/USER_GUIDE.md) - Comprehensive user guide with detailed walkthroughs
231
- - [API Documentation](docs/API.md) - Backend agent API reference
232
- - [Development Guide](docs/DEVELOPMENT.md) - Setup, testing, and contribution guide
233
- - [Troubleshooting](docs/TROUBLESHOOTING.md) - Common issues and solutions
236
+ - **Website**: https://lovie.ai
237
+ - **npm**: https://www.npmjs.com/package/@lovie-ai/formation-mcp-server
234
238
 
235
- ## 🤝 Contributing
239
+ ## Legal Disclaimer
236
240
 
237
- We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
241
+ Lovie is a document preparation and filing service. We do not provide legal or tax advice. For legal guidance on choosing the right business structure, consult with a licensed attorney. For tax advice, consult with a certified tax professional.
238
242
 
239
- ## 📝 License
243
+ ## License
240
244
 
241
245
  MIT License - see [LICENSE](LICENSE) file for details.
242
246
 
243
- ## 🔗 Links
244
-
245
- - **Website**: https://lovie.io
246
- - **Support**: https://lovie.io/support
247
- - **GitHub**: https://github.com/lovie/lovie-cli
248
- - **npm**: https://npmjs.com/package/lovie
249
-
250
- ## ⚖️ Legal Disclaimer
251
-
252
- Lovie CLI is a document preparation and filing service. We do not provide legal or tax advice. For legal guidance on choosing the right business structure, consult with a licensed attorney. For tax advice, consult with a certified tax professional.
253
-
254
247
  ---
255
248
 
256
- Made with ❤️ by the Lovie team
249
+ Made with ❤️ by Lovie
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAGvE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAGD,MAAM,MAAM,WAAW,GAAG,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,qBAAqB,KACzB,OAAO,CAAC,OAAO,CAAC,CAAC;AAOtB,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAG7E;AAGD,wBAAgB,WAAW,IAAI,cAAc,EAAE,CAE9C;AAGD,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAMlB;AAUD,wBAAgB,eAAe,IAAI,IAAI,CAMtC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAGvE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAGD,MAAM,MAAM,WAAW,GAAG,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,qBAAqB,KACzB,OAAO,CAAC,OAAO,CAAC,CAAC;AAOtB,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAG7E;AAGD,wBAAgB,WAAW,IAAI,cAAc,EAAE,CAE9C;AAGD,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAMlB;AAWD,wBAAgB,eAAe,IAAI,IAAI,CAOtC"}
@@ -30,6 +30,7 @@ const company_1 = require("./company");
30
30
  const stakeholders_1 = require("./stakeholders");
31
31
  const certificate_1 = require("./certificate");
32
32
  const sync_1 = require("./sync");
33
+ const info_1 = require("./info");
33
34
  // Import and register all tools
34
35
  function initializeTools() {
35
36
  (0, session_1.registerSessionTools)();
@@ -37,6 +38,7 @@ function initializeTools() {
37
38
  (0, stakeholders_1.registerStakeholderTools)();
38
39
  (0, certificate_1.registerCertificateTools)();
39
40
  (0, sync_1.registerSyncTools)();
41
+ (0, info_1.registerInfoTools)();
40
42
  }
41
43
  // Initialize tools on module load
42
44
  initializeTools();
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":";;AAwBA,oCAGC;AAGD,kCAEC;AAGD,wCAUC;AAUD,0CAMC;AA1CD,gBAAgB;AAChB,MAAM,YAAY,GAAG,IAAI,GAAG,EAAuB,CAAC;AACpD,MAAM,eAAe,GAAG,IAAI,GAAG,EAA0B,CAAC;AAE1D,kBAAkB;AAClB,SAAgB,YAAY,CAAC,IAAoB,EAAE,OAAoB;IACrE,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,2BAA2B;AAC3B,SAAgB,WAAW;IACzB,OAAO,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,qBAAqB;AACd,KAAK,UAAU,cAAc,CAClC,IAAY,EACZ,IAA6B,EAC7B,KAA4B;IAE5B,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,qCAAqC;AACrC,uCAAiD;AACjD,uCAAiD;AACjD,iDAA0D;AAC1D,+CAAyD;AACzD,iCAA2C;AAE3C,gCAAgC;AAChC,SAAgB,eAAe;IAC7B,IAAA,8BAAoB,GAAE,CAAC;IACvB,IAAA,8BAAoB,GAAE,CAAC;IACvB,IAAA,uCAAwB,GAAE,CAAC;IAC3B,IAAA,sCAAwB,GAAE,CAAC;IAC3B,IAAA,wBAAiB,GAAE,CAAC;AACtB,CAAC;AAED,kCAAkC;AAClC,eAAe,EAAE,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":";;AAwBA,oCAGC;AAGD,kCAEC;AAGD,wCAUC;AAWD,0CAOC;AA5CD,gBAAgB;AAChB,MAAM,YAAY,GAAG,IAAI,GAAG,EAAuB,CAAC;AACpD,MAAM,eAAe,GAAG,IAAI,GAAG,EAA0B,CAAC;AAE1D,kBAAkB;AAClB,SAAgB,YAAY,CAAC,IAAoB,EAAE,OAAoB;IACrE,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,2BAA2B;AAC3B,SAAgB,WAAW;IACzB,OAAO,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,qBAAqB;AACd,KAAK,UAAU,cAAc,CAClC,IAAY,EACZ,IAA6B,EAC7B,KAA4B;IAE5B,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,qCAAqC;AACrC,uCAAiD;AACjD,uCAAiD;AACjD,iDAA0D;AAC1D,+CAAyD;AACzD,iCAA2C;AAC3C,iCAA2C;AAE3C,gCAAgC;AAChC,SAAgB,eAAe;IAC7B,IAAA,8BAAoB,GAAE,CAAC;IACvB,IAAA,8BAAoB,GAAE,CAAC;IACvB,IAAA,uCAAwB,GAAE,CAAC;IAC3B,IAAA,sCAAwB,GAAE,CAAC;IAC3B,IAAA,wBAAiB,GAAE,CAAC;IACpB,IAAA,wBAAiB,GAAE,CAAC;AACtB,CAAC;AAED,kCAAkC;AAClC,eAAe,EAAE,CAAC"}
@@ -0,0 +1,5 @@
1
+ import { ToolDefinition } from './index';
2
+ export declare const formationGetInfoTool: ToolDefinition;
3
+ export declare const formationListInfoTopicsTool: ToolDefinition;
4
+ export declare function registerInfoTools(): void;
5
+ //# sourceMappingURL=info.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,cAAc,EAAE,MAAM,SAAS,CAAC;AAevD,eAAO,MAAM,oBAAoB,EAAE,cAclC,CAAC;AA+BF,eAAO,MAAM,2BAA2B,EAAE,cAQzC,CAAC;AAsBF,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC"}
@@ -0,0 +1,81 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.formationListInfoTopicsTool = exports.formationGetInfoTool = void 0;
4
+ exports.registerInfoTools = registerInfoTools;
5
+ const index_1 = require("./index");
6
+ const index_2 = require("../resources/index");
7
+ const errors_1 = require("../errors");
8
+ // Map friendly topic names to resource URIs
9
+ const TOPIC_MAP = {
10
+ guide: 'formation://guide',
11
+ pricing: 'formation://pricing',
12
+ 'company-types': 'formation://company-types',
13
+ faq: 'formation://faq',
14
+ requirements: 'formation://requirements',
15
+ };
16
+ // formation_get_info tool
17
+ exports.formationGetInfoTool = {
18
+ name: 'formation_get_info',
19
+ description: 'Get information about Lovie formation services, pricing, company types, requirements, or FAQs. Use this to answer user questions about the formation process.',
20
+ inputSchema: {
21
+ type: 'object',
22
+ properties: {
23
+ topic: {
24
+ type: 'string',
25
+ enum: ['guide', 'pricing', 'company-types', 'faq', 'requirements'],
26
+ description: 'The topic to get information about: "guide" (step-by-step formation guide), "pricing" (Lovie pricing and Delaware fees), "company-types" (LLC vs C-Corp vs S-Corp comparison), "faq" (frequently asked questions), "requirements" (what information is needed)',
27
+ },
28
+ },
29
+ required: ['topic'],
30
+ },
31
+ };
32
+ const handleFormationGetInfo = async (args, _store) => {
33
+ const topic = args.topic;
34
+ const uri = TOPIC_MAP[topic];
35
+ if (!uri) {
36
+ const validTopics = Object.keys(TOPIC_MAP).join(', ');
37
+ throw (0, errors_1.validationError)('topic', `Invalid topic. Valid options: ${validTopics}`);
38
+ }
39
+ const content = (0, index_2.getResourceContent)(uri);
40
+ if (!content) {
41
+ throw (0, errors_1.validationError)('topic', `Content not found for topic: ${topic}`);
42
+ }
43
+ // Find the resource metadata
44
+ const resource = index_2.FORMATION_RESOURCES.find((r) => r.uri === uri);
45
+ return {
46
+ topic,
47
+ title: resource?.name || topic,
48
+ description: resource?.description || '',
49
+ content,
50
+ };
51
+ };
52
+ // formation_list_info_topics tool
53
+ exports.formationListInfoTopicsTool = {
54
+ name: 'formation_list_info_topics',
55
+ description: 'List all available information topics that can be retrieved with formation_get_info.',
56
+ inputSchema: {
57
+ type: 'object',
58
+ properties: {},
59
+ required: [],
60
+ },
61
+ };
62
+ const handleFormationListInfoTopics = async (_args, _store) => {
63
+ const topics = index_2.FORMATION_RESOURCES.map((r) => {
64
+ const topic = Object.entries(TOPIC_MAP).find(([_, uri]) => uri === r.uri)?.[0];
65
+ return {
66
+ topic,
67
+ name: r.name,
68
+ description: r.description,
69
+ };
70
+ });
71
+ return {
72
+ topics,
73
+ usage: 'Call formation_get_info with a topic to get detailed information.',
74
+ };
75
+ };
76
+ // Register tools
77
+ function registerInfoTools() {
78
+ (0, index_1.registerTool)(exports.formationGetInfoTool, handleFormationGetInfo);
79
+ (0, index_1.registerTool)(exports.formationListInfoTopicsTool, handleFormationListInfoTopics);
80
+ }
81
+ //# sourceMappingURL=info.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"info.js","sourceRoot":"","sources":["../../../src/mcp/tools/info.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lovie-ai/formation-mcp-server",
3
- "version": "1.0.4",
3
+ "version": "1.0.6",
4
4
  "description": "MCP server for company formation - Form your US company via Claude",
5
5
  "main": "dist/mcp/index.js",
6
6
  "bin": {