Lovie Company Formation

Create Formation

formation_create_formation

CreateFormation creates a formation with full data (MCP/bulk use case). A request whose shareholders carry ssn_last4 is refused with INVALID_ARGUMENT and writes nothing: those four digits are recorded only by SetShareholderTaxIdentifier, after the whole identifier has reached the secret store. Accepting them here would report a saved number that nothing holds.

Input Schema

Name	Required	Description	Default
`formation`	Yes

Output Schema

Name	Required	Description	Default
`formationId`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 26, 2026
- addedInput schema / properties / formation / properties / selfReportedFilingAt
```
Added value: +{
+  "format": "date-time",
+  "type": "string"
+}
```
- addedInput schema / properties / formation / properties / stateFilingNumber
```
Added value: +{
+  "maxLength": 40,
+  "pattern": "^[A-Za-z0-9-]*$",
+  "type": "string"
+}
```
Changed2 schema fields changedOct 8, 2026
- addedInput schema / properties / formation / properties / attribution
```
Added value: +{
+  "additionalProperties": {
+    "type": "string"
+  },
+  "type": "object"
+}
```
- addedInput schema / properties / formation / properties / shareholders / items / properties / safeTerms / properties / postMoneyStated
```
Added value: +{
+  "type": "boolean"
+}
```
Changed1 schema field changedSep 16, 2026
- addedInput schema / properties / formation / properties / einFilingInfoSubmitted
```
Added value: +{
+  "type": "boolean"
+}
```

Changed101 schema fields changedSep 10, 2026

addedInput schema / properties / formation / properties / alternateName
```
Added value: +{
+  "maxLength": 200,
+  "type": "string"
+}
```

addedInput schema / properties / formation / properties / bankingIntent

Added value: +{
+  "properties": {
+    "cardPreference": {
+      "enum": [
+        "CARD_PREFERENCE_UNSPECIFIED",
+        "CARD_PREFERENCE_VIRTUAL_ONLY",
+        "CARD_PREFERENCE_PHYSICAL_AND_VIRTUAL"
+      ],
+      "type": "string"
+    },
+    "cardShippingAddress": {
+      "properties": {
+        "city": {
+          "maxLength": 100,
+          "minLength": 1,
+          "type": "string"
+        },
+        "country": {
+          "pattern": "^[A-Z]{2}$",
+          "type": "string"
+        },
+        "county": {
+          "maxLength": 100,
+          "type": "string"
+        },
+        "state": {
+          "maxLength": 100,
+          "type": "string"
+        },
+        "street1": {
+          "maxLength": 200,
+          "minLength": 1,
+          "type": "string"
+        },
+        "street2": {
+          "maxLength": 200,
+          "type": "string"
+        },
+        "zipCode": {
+          "maxLength": 20,
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "expectedMonthlySpend": {
+      "enum": [
+        "MONTHLY_SPEND_BAND_UNSPECIFIED",
+        "MONTHLY_SPEND_BAND_UNDER_5K",
+        "MONTHLY_SPEND_BAND_FROM_5K_TO_25K",
+        "MONTHLY_SPEND_BAND_FROM_25K_TO_100K",
+        "MONTHLY_SPEND_BAND_OVER_100K"
+      ],
+      "type": "string"
+    },
+    "openWhenEinReady": {
+      "type": "boolean"
+    },
+    "recordedAt": {
+      "format": "date-time",
+      "type": "string"
+    },
+    "shipCardsToHomeAddress": {
+      "type": "boolean"
+    }
+  },
+  "type": "object"
+}

addedInput schema / properties / formation / properties / cohortDeal

Added value: +{
+  "properties": {
+    "currencyCode": {
+      "maxLength": 3,
+      "pattern": "^([A-Z]{3})?$",
+      "type": "string"
+    },
+    "discountRate": {
+      "maxLength": 10,
+      "pattern": "^([0-9]+\\.[0-9]{1,4})?$",
+      "type": "string"
+    },
+    "displayHeadline": {
+      "description": "Free-form description (max 5000 chars).",
+      "properties": {
+        "value": {
+          "maxLength": 5000,
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "instrument": {
+      "maxLength": 40,
+      "pattern": "^[A-Z_]*$",
+      "type": "string"
+    },
+    "investmentAmount": {
+      "maxLength": 30,
+      "pattern": "^([0-9]+\\.[0-9]{1,4})?$",
+      "type": "string"
+    },
+    "investorLegalName": {
+      "description": "Human-readable name (1-255 Unicode chars).",
+      "properties": {
+        "value": {
+          "maxLength": 255,
+          "minLength": 1,
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "mfn": {
+      "type": "boolean"
+    },
+    "proRata": {
+      "type": "boolean"
+    },
+    "valuationCap": {
+      "maxLength": 30,
+      "pattern": "^([0-9]+\\.[0-9]{1,4})?$",
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

addedInput schema / properties / formation / properties / cohortDealTermsId

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

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

addedInput schema / properties / formation / properties / companyStage

Added value: +{
+  "enum": [
+    "COMPANY_STAGE_UNSPECIFIED",
+    "COMPANY_STAGE_IDEA",
+    "COMPANY_STAGE_BUILDING",
+    "COMPANY_STAGE_REVENUE"
+  ],
+  "type": "string"
+}

changedInput schema / properties / formation / properties / currentStep / enum

Previous value: -[
-  "FORMATION_STEP_UNSPECIFIED",
-  "FORMATION_STEP_CREATED",
-  "FORMATION_STEP_BUSINESS_DESCRIBED",
-  "FORMATION_STEP_STATE_SELECTED",
-  "FORMATION_STEP_TYPE_SELECTED",
-  "FORMATION_STEP_ENDING_SELECTED",
-  "FORMATION_STEP_NAME_SET",
-  "FORMATION_STEP_NAME_CHECKED",
-  "FORMATION_STEP_COMPANY_ADDRESS_SET",
-  "FORMATION_STEP_AGENT_SET",
-  "FORMATION_STEP_SHARES_SET",
-  "FORMATION_STEP_SHAREHOLDERS_ADDED",
-  "FORMATION_STEP_AUTHORIZED_PARTY_SET",
-  "FORMATION_STEP_CERTIFICATE_GENERATED",
-  "FORMATION_STEP_CERTIFICATE_APPROVED",
-  "FORMATION_STEP_COMPLETED"
-]New value: +[
+  "FORMATION_STEP_UNSPECIFIED",
+  "FORMATION_STEP_CREATED",
+  "FORMATION_STEP_BUSINESS_DESCRIBED",
+  "FORMATION_STEP_STATE_SELECTED",
+  "FORMATION_STEP_TYPE_SELECTED",
+  "FORMATION_STEP_ENDING_SELECTED",
+  "FORMATION_STEP_NAME_SET",
+  "FORMATION_STEP_NAME_CHECKED",
+  "FORMATION_STEP_COMPANY_ADDRESS_SET",
+  "FORMATION_STEP_AGENT_SET",
+  "FORMATION_STEP_SHARES_SET",
+  "FORMATION_STEP_SHAREHOLDERS_ADDED",
+  "FORMATION_STEP_AUTHORIZED_PARTY_SET",
+  "FORMATION_STEP_CERTIFICATE_GENERATED",
+  "FORMATION_STEP_CERTIFICATE_APPROVED",
+  "FORMATION_STEP_COMPLETED",
+  "FORMATION_STEP_FOUNDER_PROFILE_SET",
+  "FORMATION_STEP_TEAM_EQUITY_SET",
+  "FORMATION_STEP_DEAL_CONFIRMED",
+  "FORMATION_STEP_BANKING_INTENT_SET",
+  "FORMATION_STEP_SIGNED",
+  "FORMATION_STEP_INDUSTRY_SET"
+]

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

changedInput schema / properties / formation / properties / election83b / properties / irsServiceCenter / enum

Previous value: -[
-  "IRS_SERVICE_CENTER_UNSPECIFIED",
-  "IRS_SERVICE_CENTER_AUSTIN",
-  "IRS_SERVICE_CENTER_KANSAS_CITY",
-  "IRS_SERVICE_CENTER_OGDEN"
-]New value: +[
+  "IRS_SERVICE_CENTER_AUSTIN",
+  "IRS_SERVICE_CENTER_KANSAS_CITY",
+  "IRS_SERVICE_CENTER_OGDEN"
+]

addedInput schema / properties / formation / properties / election83bIntent
```
Added value: +{
+  "type": "boolean"
+}
```

addedInput schema / properties / formation / properties / fieldProvenance

Added value: +{
+  "additionalProperties": true,
+  "type": "object"
+}

addedInput schema / properties / formation / properties / founderInviteId

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

addedInput schema / properties / formation / properties / founderProfile

Added value: +{
+  "properties": {
+    "companyRole": {
+      "enum": [
+        "FOUNDER_COMPANY_ROLE_UNSPECIFIED",
+        "FOUNDER_COMPANY_ROLE_CEO",
+        "FOUNDER_COMPANY_ROLE_CTO",
+        "FOUNDER_COMPANY_ROLE_OTHER"
+      ],
+      "type": "string"
+    },
+    "companyRoleOther": {
+      "maxLength": 120,
+      "type": "string"
+    },
+    "dateOfBirth": {
+      "pattern": "^([0-9]{4}-[0-9]{2}-[0-9]{2})?$",
+      "type": "string"
+    },
+    "email": {
+      "maxLength": 254,
+      "pattern": "^([a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,})?$",
+      "type": "string"
+    },
+    "firstName": {
+      "maxLength": 100,
+      "minLength": 1,
+      "type": "string"
+    },
+    "homeAddress": {
+      "properties": {
+        "city": {
+          "maxLength": 100,
+          "minLength": 1,
+          "type": "string"
+        },
+        "country": {
+          "pattern": "^[A-Z]{2}$",
+          "type": "string"
+        },
+        "county": {
+          "maxLength": 100,
+          "type": "string"
+        },
+        "state": {
+          "maxLength": 100,
+          "type": "string"
+        },
+        "street1": {
+          "maxLength": 200,
+          "minLength": 1,
+          "type": "string"
+        },
+        "street2": {
+          "maxLength": 200,
+          "type": "string"
+        },
+        "zipCode": {
+          "maxLength": 20,
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "lastName": {
+      "maxLength": 100,
+      "minLength": 1,
+      "type": "string"
+    },
+    "linkedinUrl": {
+      "maxLength": 300,
+      "pattern": "^(https://([a-z]{2,3}\\.)?linkedin\\.com/[A-Za-z0-9_/.-]*)?$",
+      "type": "string"
+    },
+    "livesOutsideUs": {
+      "type": "boolean"
+    },
+    "phone": {
+      "maxLength": 30,
+      "pattern": "^[0-9 ()-]*$",
+      "type": "string"
+    },
+    "phoneCountryCode": {
+      "maxLength": 5,
+      "pattern": "^(\\+[0-9]{1,4})?$",
+      "type": "string"
+    },
+    "primaryLocationCountry": {
+      "maxLength": 2,
+      "pattern": "^([A-Z]{2})?$",
+      "type": "string"
+    },
+    "updatedAt": {
+      "format": "date-time",
+      "type": "string"
+    },
+    "usWorkAuthorization": {
+      "enum": [
+        "US_WORK_AUTHORIZATION_UNSPECIFIED",
+        "US_WORK_AUTHORIZATION_CITIZEN_OR_PERMANENT_RESIDENT",
+        "US_WORK_AUTHORIZATION_VISA_HOLDER",
+        "US_WORK_AUTHORIZATION_NOT_AUTHORIZED"
+      ],
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

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

addedInput schema / properties / formation / properties / naicsCode

Added value: +{
+  "maxLength": 6,
+  "pattern": "^([0-9]{2,6})?$",
+  "type": "string"
+}

addedInput schema / properties / formation / properties / partnerCohortId

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

addedInput schema / properties / formation / properties / partnerOrgId

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

addedInput schema / properties / formation / properties / partnerPays
```
Added value: +{
+  "type": "boolean"
+}
```

addedInput schema / properties / formation / properties / physicalBusinessAddress

Added value: +{
+  "properties": {
+    "city": {
+      "maxLength": 100,
+      "minLength": 1,
+      "type": "string"
+    },
+    "country": {
+      "pattern": "^[A-Z]{2}$",
+      "type": "string"
+    },
+    "county": {
+      "maxLength": 100,
+      "type": "string"
+    },
+    "state": {
+      "maxLength": 100,
+      "type": "string"
+    },
+    "street1": {
+      "maxLength": 200,
+      "minLength": 1,
+      "type": "string"
+    },
+    "street2": {
+      "maxLength": 200,
+      "type": "string"
+    },
+    "zipCode": {
+      "maxLength": 20,
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

addedInput schema / properties / formation / properties / referenceCode

Added value: +{
+  "maxLength": 32,
+  "pattern": "^[A-Z0-9-]*$",
+  "type": "string"
+}

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

changedInput schema / properties / formation / properties / registeredAgent / properties / email / pattern

Previous value: -"^[a-zA-Z0-9._%+-]*@?[a-zA-Z0-9.-]*\\.?[a-zA-Z]*$"New value: +"^([a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,})?$"

addedInput schema / properties / formation / properties / selectedDomain

Added value: +{
+  "maxLength": 253,
+  "pattern": "^([A-Za-z0-9]([A-Za-z0-9-]*[A-Za-z0-9])?(\\.[A-Za-z0-9]([A-Za-z0-9-]*[A-Za-z0-9])?)+\\.?)?$",
+  "type": "string"
+}

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

addedInput schema / properties / formation / properties / shareholders / items / properties / addressType

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

addedInput schema / properties / formation / properties / shareholders / items / properties / dateOfBirth

Added value: +{
+  "maxLength": 10,
+  "pattern": "^([0-9]{4}-[0-9]{2}-[0-9]{2})?$",
+  "type": "string"
+}

addedInput schema / properties / formation / properties / shareholders / items / properties / ssnLast4
```
Added value: +{
+  "maxLength": 4,
+  "pattern": "^([0-9]{4})?$",
+  "type": "string"
+}
```

changedInput schema / properties / formation / properties / status / enum

Previous value: -[
-  "FORMATION_STATUS_UNSPECIFIED",
-  "FORMATION_STATUS_INITIATED",
-  "FORMATION_STATUS_IN_PROGRESS",
-  "FORMATION_STATUS_PAYMENT_PENDING",
-  "FORMATION_STATUS_PAYMENT_COMPLETE",
-  "FORMATION_STATUS_FILING_IN_PROGRESS",
-  "FORMATION_STATUS_COMPLETED",
-  "FORMATION_STATUS_FAILED",
-  "FORMATION_STATUS_CANCELLED"
-]New value: +[
+  "FORMATION_STATUS_UNSPECIFIED",
+  "FORMATION_STATUS_INITIATED",
+  "FORMATION_STATUS_IN_PROGRESS",
+  "FORMATION_STATUS_PAYMENT_PENDING",
+  "FORMATION_STATUS_PAYMENT_COMPLETE",
+  "FORMATION_STATUS_FILING_IN_PROGRESS",
+  "FORMATION_STATUS_COMPLETED",
+  "FORMATION_STATUS_FAILED",
+  "FORMATION_STATUS_CANCELLED",
+  "FORMATION_STATUS_IMPORTED"
+]

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

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"
```

Changed2 schema fields changedAug 13, 2026

addedInput schema / properties / formation / properties / filingFeeCollectedAt
```
Added value: +{
+  "format": "date-time",
+  "type": "string"
+}
```

changedInput schema / properties / formation / properties / source / enum

Previous value: -[
-  "FORMATION_SOURCE_UNSPECIFIED",
-  "FORMATION_SOURCE_WEB",
-  "FORMATION_SOURCE_MCP",
-  "FORMATION_SOURCE_CLI",
-  "FORMATION_SOURCE_AGENTS",
-  "FORMATION_SOURCE_CONVERSATIONAL",
-  "FORMATION_SOURCE_NAME_GEN",
-  "FORMATION_SOURCE_WHATSAPP",
-  "FORMATION_SOURCE_TELEGRAM"
-]New value: +[
+  "FORMATION_SOURCE_UNSPECIFIED",
+  "FORMATION_SOURCE_WEB",
+  "FORMATION_SOURCE_MCP",
+  "FORMATION_SOURCE_CLI",
+  "FORMATION_SOURCE_AGENTS",
+  "FORMATION_SOURCE_CONVERSATIONAL",
+  "FORMATION_SOURCE_NAME_GEN",
+  "FORMATION_SOURCE_WHATSAPP",
+  "FORMATION_SOURCE_TELEGRAM",
+  "FORMATION_SOURCE_LANDING"
+]

First observedAug 11, 2026

TDQS

B3.3/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Adds substantial value beyond the annotations (which only say openWorldHint=false, destructiveHint=false): it specifies an exact failure mode (INVALID_ARGUMENT), guarantees atomicity ("writes nothing"), and explains the rationale tied to SetShareholderTaxIdentifier and the secret store. It does not cover permissions or what the creation triggers downstream, keeping it short of a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three tight sentences with the verb and scope front-loaded and no filler. The allocation is skewed though: two of three sentences cover a single edge case while the core 'full data' payload contract gets one clause.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a mutation with a very large nested payload and no per-field schema descriptions, the description should explain payload expectations and how this differs from start_formation/update_formation. An output schema exists so return values need no coverage, but the input side is left largely unexplained.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There is one required parameter, but it is a deeply nested formation object with 0% schema description coverage across dozens of fields. The description clarifies exactly one nested field (shareholders[].ssnLast4); the remaining payload semantics are undocumented in both schema and description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ("creates a formation with full data") and adds a scoping qualifier ("MCP/bulk use case"). It does not name siblings such as formation_start_formation or formation_update_formation, so the agent must still infer which creation path applies.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

"MCP/bulk use case" implies the bulk-import scenario and the ssn_last4 refusal acts as an implicit constraint, but the description never says when to prefer this over formation_start_formation or formation_update_formation. Alternatives are only inferable from the sibling list.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Lovie Company Formation tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.