Lovie Company Formation

Add Shareholder

formation_add_shareholder

AddShareholder adds a shareholder or LLC member

Input Schema

TableJSON Schema

Name	Required	Description
`role`	No
`email`	No
`phone`	No
`address`	No
`lastName`	No
`firstName`	No
`addressType`	No
`formationId`	Yes	UUID value wrapper.
`ownershipPercentage`	No

Output Schema

TableJSON Schema

Name	Required	Description	Default
`formationId`	No
`shareholder`	No
`totalOwnership`	No
`ownershipComplete`	No
`totalShareholders`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 8, 2026

changedOutput schema / properties / shareholder / anyOf

Previous value: -[
-  {
-    "properties": {
-      "address": {
-        "anyOf": [
-          {
-            "properties": {
-              "city": {
-                "type": "string"
-              },
-              "country": {
-                "type": "string"
-              },
-              "county": {
-                "type": "string"
-              },
-              "state": {
-                "type": "string"
-              },
-              "street1": {
-                "type": "string"
-              },
-              "street2": {
-                "type": "string"
-              },
-              "zipCode": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "addressType": {
-        "enum": [
-          "ADDRESS_TYPE_UNSPECIFIED",
-          "ADDRESS_TYPE_RESIDENTIAL",
-          "ADDRESS_TYPE_BUSINESS"
-        ],
-        "type": "string"
-      },
-      "dateOfBirth": {
-        "type": "string"
-      },
-      "effectiveDate": {
-        "anyOf": [
-          {
-            "format": "date-time",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "email": {
-        "type": "string"
-      },
-      "firstName": {
-        "type": "string"
-      },
-      "fullName": {
-        "type": "string"
-      },
-      "id": {
-        "anyOf": [
-          {
-            "description": "UUID value wrapper.",
-            "properties": {
-              "value": {
-                "format": "uuid",
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "investmentAmountCents": {
-        "type": "string"
-      },
-      "issueDate": {
-        "anyOf": [
-          {
-            "format": "date-time",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "lastName": {
-        "type": "string"
-      },
-      "ownershipPercentage": {
-        "type": "string"
-      },
-      "phone": {
-        "type": "string"
-      },
-      "role": {
-        "enum": [
-          "SHAREHOLDER_ROLE_UNSPECIFIED",
-          "SHAREHOLDER_ROLE_MANAGING_MEMBER",
-          "SHAREHOLDER_ROLE_MEMBER",
-          "SHAREHOLDER_ROLE_SHAREHOLDER",
-          "SHAREHOLDER_ROLE_DIRECTOR",
-          "SHAREHOLDER_ROLE_OFFICER"
-        ],
-        "type": "string"
-      },
-      "round": {
-        "type": "string"
-      },
-      "safeTerms": {
-        "anyOf": [
-          {
-            "properties": {
-              "discountPercentage": {
-                "type": "string"
-              },
-              "investmentAmountCents": {
-                "type": "string"
-              },
-              "postMoney": {
-                "type": "boolean"
-              },
-              "safeIssueDate": {
-                "anyOf": [
-                  {
-                    "format": "date-time",
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ]
-              },
-              "signedByName": {
-                "type": "string"
-              },
-              "signedByTitle": {
-                "type": "string"
-              },
-              "valuationCapCents": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "shareClass": {
-        "enum": [
-          "SHARE_CLASS_UNSPECIFIED",
-          "SHARE_CLASS_COMMON",
-          "SHARE_CLASS_PREFERRED",
-          "SHARE_CLASS_OPTION",
-          "SHARE_CLASS_SAFE"
-        ],
-        "type": "string"
-      },
-      "shareCount": {
-        "type": "string"
-      },
-      "signedByName": {
-        "type": "string"
-      },
-      "signedByTitle": {
-        "type": "string"
-      },
-      "signedDate": {
-        "anyOf": [
-          {
-            "format": "date-time",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "sourceBbox": {
-        "type": "string"
-      },
-      "sourcePage": {
-        "type": "integer"
-      },
-      "ssnLast4": {
-        "type": "string"
-      },
-      "stakeholderType": {
-        "enum": [
-          "STAKEHOLDER_TYPE_UNSPECIFIED",
-          "STAKEHOLDER_TYPE_FOUNDER",
-          "STAKEHOLDER_TYPE_ANGEL",
-          "STAKEHOLDER_TYPE_INVESTOR_ENTITY",
-          "STAKEHOLDER_TYPE_EMPLOYEE_POOL",
-          "STAKEHOLDER_TYPE_ADVISOR_POOL",
-          "STAKEHOLDER_TYPE_RESERVE"
-        ],
-        "type": "string"
-      },
-      "strikePriceCents": {
-        "type": "string"
-      },
-      "title": {
-        "type": "string"
-      },
-      "vestingCliffMonths": {
-        "type": "integer"
-      },
-      "vestingStartDate": {
-        "anyOf": [
-          {
-            "format": "date-time",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "vestingTotalMonths": {
-        "type": "integer"
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "properties": {
+      "address": {
+        "anyOf": [
+          {
+            "properties": {
+              "city": {
+                "type": "string"
+              },
+              "country": {
+                "type": "string"
+              },
+              "county": {
+                "type": "string"
+              },
+              "state": {
+                "type": "string"
+              },
+              "street1": {
+                "type": "string"
+              },
+              "street2": {
+                "type": "string"
+              },
+              "zipCode": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "addressType": {
+        "enum": [
+          "ADDRESS_TYPE_UNSPECIFIED",
+          "ADDRESS_TYPE_RESIDENTIAL",
+          "ADDRESS_TYPE_BUSINESS"
+        ],
+        "type": "string"
+      },
+      "dateOfBirth": {
+        "type": "string"
+      },
+      "effectiveDate": {
+        "anyOf": [
+          {
+            "format": "date-time",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "email": {
+        "type": "string"
+      },
+      "firstName": {
+        "type": "string"
+      },
+      "fullName": {
+        "type": "string"
+      },
+      "id": {
+        "anyOf": [
+          {
+            "description": "UUID value wrapper.",
+            "properties": {
+              "value": {
+                "format": "uuid",
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "investmentAmountCents": {
+        "type": "string"
+      },
+      "issueDate": {
+        "anyOf": [
+          {
+            "format": "date-time",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "lastName": {
+        "type": "string"
+      },
+      "ownershipPercentage": {
+        "type": "string"
+      },
+      "phone": {
+        "type": "string"
+      },
+      "role": {
+        "enum": [
+          "SHAREHOLDER_ROLE_UNSPECIFIED",
+          "SHAREHOLDER_ROLE_MANAGING_MEMBER",
+          "SHAREHOLDER_ROLE_MEMBER",
+          "SHAREHOLDER_ROLE_SHAREHOLDER",
+          "SHAREHOLDER_ROLE_DIRECTOR",
+          "SHAREHOLDER_ROLE_OFFICER"
+        ],
+        "type": "string"
+      },
+      "round": {
+        "type": "string"
+      },
+      "safeTerms": {
+        "anyOf": [
+          {
+            "properties": {
+              "discountPercentage": {
+                "type": "string"
+              },
+              "investmentAmountCents": {
+                "type": "string"
+              },
+              "postMoney": {
+                "type": "boolean"
+              },
+              "postMoneyStated": {
+                "type": "boolean"
+              },
+              "safeIssueDate": {
+                "anyOf": [
+                  {
+                    "format": "date-time",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "signedByName": {
+                "type": "string"
+              },
+              "signedByTitle": {
+                "type": "string"
+              },
+              "valuationCapCents": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "shareClass": {
+        "enum": [
+          "SHARE_CLASS_UNSPECIFIED",
+          "SHARE_CLASS_COMMON",
+          "SHARE_CLASS_PREFERRED",
+          "SHARE_CLASS_OPTION",
+          "SHARE_CLASS_SAFE"
+        ],
+        "type": "string"
+      },
+      "shareCount": {
+        "type": "string"
+      },
+      "signedByName": {
+        "type": "string"
+      },
+      "signedByTitle": {
+        "type": "string"
+      },
+      "signedDate": {
+        "anyOf": [
+          {
+            "format": "date-time",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "sourceBbox": {
+        "type": "string"
+      },
+      "sourcePage": {
+        "type": "integer"
+      },
+      "ssnLast4": {
+        "type": "string"
+      },
+      "stakeholderType": {
+        "enum": [
+          "STAKEHOLDER_TYPE_UNSPECIFIED",
+          "STAKEHOLDER_TYPE_FOUNDER",
+          "STAKEHOLDER_TYPE_ANGEL",
+          "STAKEHOLDER_TYPE_INVESTOR_ENTITY",
+          "STAKEHOLDER_TYPE_EMPLOYEE_POOL",
+          "STAKEHOLDER_TYPE_ADVISOR_POOL",
+          "STAKEHOLDER_TYPE_RESERVE"
+        ],
+        "type": "string"
+      },
+      "strikePriceCents": {
+        "type": "string"
+      },
+      "title": {
+        "type": "string"
+      },
+      "vestingCliffMonths": {
+        "type": "integer"
+      },
+      "vestingStartDate": {
+        "anyOf": [
+          {
+            "format": "date-time",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "vestingTotalMonths": {
+        "type": "integer"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed20 schema fields changedSep 10, 2026

removedInput schema / properties / address / properties / city / pattern
```
Removed value: -"^[A-Za-z .'-]+$"
```
removedInput schema / properties / address / properties / country / maxLength
```
Removed value: -2
```
changedInput schema / properties / address / properties / country / pattern
```
Previous value: -"^[A-Z]*$"New value: +"^[A-Z]{2}$"
```
removedInput schema / properties / address / properties / county / pattern
```
Removed value: -"^[A-Za-z ]*$"
```
changedInput schema / properties / address / properties / state / maxLength
```
Previous value: -50New value: +100
```
removedInput schema / properties / address / properties / state / minLength
```
Removed value: -1
```
removedInput schema / properties / address / properties / state / pattern
```
Removed value: -"^[A-Za-z ]+$"
```
removedInput schema / properties / address / properties / street1 / pattern
```
Removed value: -"^[A-Za-z0-9 .,#/-]+$"
```
removedInput schema / properties / address / properties / street2 / pattern
```
Removed value: -"^[A-Za-z0-9 .,#/-]*$"
```
changedInput schema / properties / address / properties / zipCode / maxLength
```
Previous value: -10New value: +20
```
removedInput schema / properties / address / properties / zipCode / minLength
```
Removed value: -5
```
removedInput schema / properties / address / properties / zipCode / pattern
```
Removed value: -"^[0-9]{5}(-[0-9]{4})?$"
```

addedInput schema / properties / addressType

Added value: +{
+  "enum": [
+    "ADDRESS_TYPE_UNSPECIFIED",
+    "ADDRESS_TYPE_RESIDENTIAL",
+    "ADDRESS_TYPE_BUSINESS"
+  ],
+  "type": "string"
+}

addedOutput schema / properties / formationId / anyOf

Added value: +[
+  {
+    "description": "UUID value wrapper.",
+    "properties": {
+      "value": {
+        "format": "uuid",
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / formationId / description
```
Removed value: -"UUID value wrapper."
```

removedOutput schema / properties / formationId / properties

Removed value: -{
-  "value": {
-    "format": "uuid",
-    "type": "string"
-  }
-}

removedOutput schema / properties / formationId / type
```
Removed value: -"object"
```

addedOutput schema / properties / shareholder / anyOf

Added value: +[
+  {
+    "properties": {
+      "address": {
+        "anyOf": [
+          {
+            "properties": {
+              "city": {
+                "type": "string"
+              },
+              "country": {
+                "type": "string"
+              },
+              "county": {
+                "type": "string"
+              },
+              "state": {
+                "type": "string"
+              },
+              "street1": {
+                "type": "string"
+              },
+              "street2": {
+                "type": "string"
+              },
+              "zipCode": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "addressType": {
+        "enum": [
+          "ADDRESS_TYPE_UNSPECIFIED",
+          "ADDRESS_TYPE_RESIDENTIAL",
+          "ADDRESS_TYPE_BUSINESS"
+        ],
+        "type": "string"
+      },
+      "dateOfBirth": {
+        "type": "string"
+      },
+      "effectiveDate": {
+        "anyOf": [
+          {
+            "format": "date-time",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "email": {
+        "type": "string"
+      },
+      "firstName": {
+        "type": "string"
+      },
+      "fullName": {
+        "type": "string"
+      },
+      "id": {
+        "anyOf": [
+          {
+            "description": "UUID value wrapper.",
+            "properties": {
+              "value": {
+                "format": "uuid",
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "investmentAmountCents": {
+        "type": "string"
+      },
+      "issueDate": {
+        "anyOf": [
+          {
+            "format": "date-time",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "lastName": {
+        "type": "string"
+      },
+      "ownershipPercentage": {
+        "type": "string"
+      },
+      "phone": {
+        "type": "string"
+      },
+      "role": {
+        "enum": [
+          "SHAREHOLDER_ROLE_UNSPECIFIED",
+          "SHAREHOLDER_ROLE_MANAGING_MEMBER",
+          "SHAREHOLDER_ROLE_MEMBER",
+          "SHAREHOLDER_ROLE_SHAREHOLDER",
+          "SHAREHOLDER_ROLE_DIRECTOR",
+          "SHAREHOLDER_ROLE_OFFICER"
+        ],
+        "type": "string"
+      },
+      "round": {
+        "type": "string"
+      },
+      "safeTerms": {
+        "anyOf": [
+          {
+            "properties": {
+              "discountPercentage": {
+                "type": "string"
+              },
+              "investmentAmountCents": {
+                "type": "string"
+              },
+              "postMoney": {
+                "type": "boolean"
+              },
+              "safeIssueDate": {
+                "anyOf": [
+                  {
+                    "format": "date-time",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "signedByName": {
+                "type": "string"
+              },
+              "signedByTitle": {
+                "type": "string"
+              },
+              "valuationCapCents": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "shareClass": {
+        "enum": [
+          "SHARE_CLASS_UNSPECIFIED",
+          "SHARE_CLASS_COMMON",
+          "SHARE_CLASS_PREFERRED",
+          "SHARE_CLASS_OPTION",
+          "SHARE_CLASS_SAFE"
+        ],
+        "type": "string"
+      },
+      "shareCount": {
+        "type": "string"
+      },
+      "signedByName": {
+        "type": "string"
+      },
+      "signedByTitle": {
+        "type": "string"
+      },
+      "signedDate": {
+        "anyOf": [
+          {
+            "format": "date-time",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "sourceBbox": {
+        "type": "string"
+      },
+      "sourcePage": {
+        "type": "integer"
+      },
+      "ssnLast4": {
+        "type": "string"
+      },
+      "stakeholderType": {
+        "enum": [
+          "STAKEHOLDER_TYPE_UNSPECIFIED",
+          "STAKEHOLDER_TYPE_FOUNDER",
+          "STAKEHOLDER_TYPE_ANGEL",
+          "STAKEHOLDER_TYPE_INVESTOR_ENTITY",
+          "STAKEHOLDER_TYPE_EMPLOYEE_POOL",
+          "STAKEHOLDER_TYPE_ADVISOR_POOL",
+          "STAKEHOLDER_TYPE_RESERVE"
+        ],
+        "type": "string"
+      },
+      "strikePriceCents": {
+        "type": "string"
+      },
+      "title": {
+        "type": "string"
+      },
+      "vestingCliffMonths": {
+        "type": "integer"
+      },
+      "vestingStartDate": {
+        "anyOf": [
+          {
+            "format": "date-time",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "vestingTotalMonths": {
+        "type": "integer"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / shareholder / properties

Removed value: -{
-  "address": {
-    "properties": {
-      "city": {
-        "type": "string"
-      },
-      "country": {
-        "type": "string"
-      },
-      "county": {
-        "type": "string"
-      },
-      "state": {
-        "type": "string"
-      },
-      "street1": {
-        "type": "string"
-      },
-      "street2": {
-        "type": "string"
-      },
-      "zipCode": {
-        "type": "string"
-      }
-    },
-    "type": "object"
-  },
-  "effectiveDate": {
-    "format": "date-time",
-    "type": "string"
-  },
-  "email": {
-    "type": "string"
-  },
-  "firstName": {
-    "type": "string"
-  },
-  "fullName": {
-    "type": "string"
-  },
-  "id": {
-    "description": "UUID value wrapper.",
-    "properties": {
-      "value": {
-        "format": "uuid",
-        "type": "string"
-      }
-    },
-    "type": "object"
-  },
-  "investmentAmountCents": {
-    "type": "string"
-  },
-  "issueDate": {
-    "format": "date-time",
-    "type": "string"
-  },
-  "lastName": {
-    "type": "string"
-  },
-  "ownershipPercentage": {
-    "type": "string"
-  },
-  "phone": {
-    "type": "string"
-  },
-  "role": {
-    "enum": [
-      "SHAREHOLDER_ROLE_UNSPECIFIED",
-      "SHAREHOLDER_ROLE_MANAGING_MEMBER",
-      "SHAREHOLDER_ROLE_MEMBER",
-      "SHAREHOLDER_ROLE_SHAREHOLDER",
-      "SHAREHOLDER_ROLE_DIRECTOR",
-      "SHAREHOLDER_ROLE_OFFICER"
-    ],
-    "type": "string"
-  },
-  "round": {
-    "type": "string"
-  },
-  "safeTerms": {
-    "properties": {
-      "discountPercentage": {
-        "type": "string"
-      },
-      "investmentAmountCents": {
-        "type": "string"
-      },
-      "postMoney": {
-        "type": "boolean"
-      },
-      "safeIssueDate": {
-        "format": "date-time",
-        "type": "string"
-      },
-      "signedByName": {
-        "type": "string"
-      },
-      "signedByTitle": {
-        "type": "string"
-      },
-      "valuationCapCents": {
-        "type": "string"
-      }
-    },
-    "type": "object"
-  },
-  "shareClass": {
-    "enum": [
-      "SHARE_CLASS_UNSPECIFIED",
-      "SHARE_CLASS_COMMON",
-      "SHARE_CLASS_PREFERRED",
-      "SHARE_CLASS_OPTION",
-      "SHARE_CLASS_SAFE"
-    ],
-    "type": "string"
-  },
-  "shareCount": {
-    "type": "string"
-  },
-  "signedByName": {
-    "type": "string"
-  },
-  "signedByTitle": {
-    "type": "string"
-  },
-  "signedDate": {
-    "format": "date-time",
-    "type": "string"
-  },
-  "sourceBbox": {
-    "type": "string"
-  },
-  "sourcePage": {
-    "type": "integer"
-  },
-  "stakeholderType": {
-    "enum": [
-      "STAKEHOLDER_TYPE_UNSPECIFIED",
-      "STAKEHOLDER_TYPE_FOUNDER",
-      "STAKEHOLDER_TYPE_ANGEL",
-      "STAKEHOLDER_TYPE_INVESTOR_ENTITY",
-      "STAKEHOLDER_TYPE_EMPLOYEE_POOL",
-      "STAKEHOLDER_TYPE_ADVISOR_POOL",
-      "STAKEHOLDER_TYPE_RESERVE"
-    ],
-    "type": "string"
-  },
-  "strikePriceCents": {
-    "type": "string"
-  },
-  "title": {
-    "type": "string"
-  },
-  "vestingCliffMonths": {
-    "type": "integer"
-  },
-  "vestingStartDate": {
-    "format": "date-time",
-    "type": "string"
-  },
-  "vestingTotalMonths": {
-    "type": "integer"
-  }
-}