Skip to main content
Glama

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.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "formation": "<formation>"
    },
    "name": "formation_create_formation"
  }
}

Input Schema

NameRequiredDescriptionDefault
formationYes

Output Schema

NameRequiredDescriptionDefault
formationIdYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / formation / properties / responsiblePartySsnLast4
      Added value: +{
      +  "maxLength": 4,
      +  "pattern": "^([0-9]{4})?$",
      +  "type": "string"
      +}
  2. Changed2 schema fields changed
    • 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"
      +}
  3. Changed2 schema fields changed
    • 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"
      +}
  4. Changed1 schema field changed
    • addedInput schema / properties / formation / properties / einFilingInfoSubmitted
      Added value: +{
      +  "type": "boolean"
      +}
  5. Changed101 schema fields changed
    • 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"
  6. Changed2 schema fields changed
    • 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"
      +]
  7. First observed

TDQS

A3.5/5.0
Behavior4/5

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

Annotations only say openWorldHint=false and destructiveHint=false; the description adds genuinely new behavior: requests carrying ssn_last4 are refused with INVALID_ARGUMENT and write nothing, so the whole call is atomic on that condition. That is a concrete, useful disclosure an agent cannot get from annotations. It stops short of covering other validation/idempotency behavior (e.g. what happens on a duplicate id).

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

Conciseness3/5

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

The rejection rule is front-loaded in the second sentence, which is good. The opening clause restates the tool name almost verbatim ("CreateFormation creates a formation"), and the closing sentence re-explains the same rationale in three clauses, so a third of the text is justification rather than instruction.

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

Completeness3/5

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

Return values are covered by the output schema, so that is not a gap. Against an exceptionally large nested input with no per-field descriptions, though, the description addresses exactly one hazard and leaves the agent to construct the payload blind; for a bulk-create tool of this complexity that is only minimally viable.

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

Parameters3/5

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

Schema coverage is 0% and the single parameter is an enormous nested formation object, so description normally needs to do heavy lifting. It adds crucial meaning for one field only: ssn_last4 looks schema-legal (pattern ^([0-9]{4})?$ yet is rejected at runtime, a trap worth correcting. The remaining dozens of nested fields and the required-vs-optional shape of the payload get no explanation.

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") and scopes it as "full data (MCP/bulk use case)", which hints it is not the step-by-step flow. It never names a sibling (e.g. formation_start_formation or formation_update_formation), so the agent must infer the boundary itself.

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?

The parenthetical "MCP/bulk use case" implies the scenario, and it explicitly routes SSN capture to SetShareholderTaxIdentifier, which is real alternative-routing guidance. But there is no stated condition distinguishing this create from start_formation or update_formation, and no prerequisites are given.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.