Lovie Company Formation

Submit Equity Onboarding

equity_onboarding_submit

Destructive

Finishes the intake and records the company's proof of formation. A refusal is a normal answer, not a failure: it names the sections still blocking and, for a section no tool can clear, the URL where a person finishes it. Read that back rather than retrying. On success the cap table opens for a named, documented entity, and the company's entity type, state, formation date, EIN and address are filled in on its company record where none is stored; a fact already stored there is left as it is.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`onboardingId`	Yes	UUID value wrapper.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`onboarding`	No
`blockingSections`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 8, 2026

changedOutput schema / properties / onboarding / anyOf

Previous value: -[
-  {
-    "properties": {
-      "companyId": {
-        "anyOf": [
-          {
-            "description": "UUID value wrapper.",
-            "properties": {
-              "value": {
-                "format": "uuid",
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "countryOfIncorporation": {
-        "type": "string"
-      },
-      "createdAt": {
-        "anyOf": [
-          {
-            "format": "date-time",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "documents": {
-        "items": {
-          "properties": {
-            "contentType": {
-              "type": "string"
-            },
-            "fileName": {
-              "type": "string"
-            },
-            "id": {
-              "anyOf": [
-                {
-                  "description": "UUID value wrapper.",
-                  "properties": {
-                    "value": {
-                      "format": "uuid",
-                      "type": "string"
-                    }
-                  },
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "kind": {
-              "enum": [
-                "EQUITY_ONBOARDING_DOCUMENT_KIND_UNSPECIFIED",
-                "EQUITY_ONBOARDING_DOCUMENT_KIND_CERTIFICATE_OF_INCORPORATION",
-                "EQUITY_ONBOARDING_DOCUMENT_KIND_EIN_LETTER"
-              ],
-              "type": "string"
-            },
-            "sizeBytes": {
-              "type": "string"
-            },
-            "uploadedAt": {
-              "anyOf": [
-                {
-                  "format": "date-time",
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "einNumber": {
-        "type": "string"
-      },
-      "entityType": {
-        "type": "string"
-      },
-      "formationDate": {
-        "type": "string"
-      },
-      "formationId": {
-        "anyOf": [
-          {
-            "description": "UUID value wrapper.",
-            "properties": {
-              "value": {
-                "format": "uuid",
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "id": {
-        "anyOf": [
-          {
-            "description": "UUID value wrapper.",
-            "properties": {
-              "value": {
-                "format": "uuid",
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "legalName": {
-        "anyOf": [
-          {
-            "description": "Human-readable name (1-255 Unicode chars).",
-            "properties": {
-              "value": {
-                "maxLength": 255,
-                "minLength": 1,
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "nonUs": {
-        "type": "boolean"
-      },
-      "prefillPercent": {
-        "type": "integer"
-      },
-      "provenance": {
-        "items": {
-          "properties": {
-            "confidence": {
-              "type": "number"
-            },
-            "confirmedAt": {
-              "anyOf": [
-                {
-                  "format": "date-time",
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "fieldPath": {
-              "type": "string"
-            },
-            "origin": {
-              "enum": [
-                "PROVENANCE_ORIGIN_UNSPECIFIED",
-                "PROVENANCE_ORIGIN_INVITE",
-                "PROVENANCE_ORIGIN_FORMATION",
-                "PROVENANCE_ORIGIN_CAP_TABLE",
-                "PROVENANCE_ORIGIN_IDENTITY_PROFILE",
-                "PROVENANCE_ORIGIN_EXTRACTED_DOCUMENT",
-                "PROVENANCE_ORIGIN_PROVIDER",
-                "PROVENANCE_ORIGIN_USER",
-                "PROVENANCE_ORIGIN_DEFAULT"
-              ],
-              "type": "string"
-            },
-            "sourceDocumentId": {
-              "anyOf": [
-                {
-                  "description": "UUID value wrapper.",
-                  "properties": {
-                    "value": {
-                      "format": "uuid",
-                      "type": "string"
-                    }
-                  },
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "sourceFormationId": {
-              "anyOf": [
-                {
-                  "description": "UUID value wrapper.",
-                  "properties": {
-                    "value": {
-                      "format": "uuid",
-                      "type": "string"
-                    }
-                  },
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "sourceLabel": {
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "registeredAddress": {
-        "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"
-          }
-        ]
-      },
-      "registeredAddressSource": {
-        "enum": [
-          "ADDRESS_SOURCE_UNSPECIFIED",
-          "ADDRESS_SOURCE_OWN",
-          "ADDRESS_SOURCE_NEED_ASSISTANCE"
-        ],
-        "type": "string"
-      },
-      "registeredAgentAddress": {
-        "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"
-          }
-        ]
-      },
-      "registeredAgentName": {
-        "anyOf": [
-          {
-            "description": "Human-readable name (1-255 Unicode chars).",
-            "properties": {
-              "value": {
-                "maxLength": 255,
-                "minLength": 1,
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "sections": {
-        "items": {
-          "properties": {
-            "blockers": {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            "handoffUrl": {
-              "type": "string"
-            },
-            "key": {
-              "type": "string"
-            },
-            "label": {
-              "type": "string"
-            },
-            "state": {
-              "enum": [
-                "SECTION_STATE_UNSPECIFIED",
-                "SECTION_STATE_NOT_STARTED",
-                "SECTION_STATE_WORKING",
-                "SECTION_STATE_COMPLETE"
-              ],
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "stateOfIncorporation": {
-        "type": "string"
-      },
-      "status": {
-        "enum": [
-          "EQUITY_ONBOARDING_STATUS_UNSPECIFIED",
-          "EQUITY_ONBOARDING_STATUS_DRAFT",
-          "EQUITY_ONBOARDING_STATUS_COLLECTING",
-          "EQUITY_ONBOARDING_STATUS_SUBMITTED",
-          "EQUITY_ONBOARDING_STATUS_ABANDONED"
-        ],
-        "type": "string"
-      },
-      "submittedAt": {
-        "anyOf": [
-          {
-            "format": "date-time",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "suggestedEin": {
-        "type": "string"
-      },
-      "updatedAt": {
-        "anyOf": [
-          {
-            "format": "date-time",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "properties": {
+      "companyId": {
+        "anyOf": [
+          {
+            "description": "UUID value wrapper.",
+            "properties": {
+              "value": {
+                "format": "uuid",
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "countryOfIncorporation": {
+        "type": "string"
+      },
+      "createdAt": {
+        "anyOf": [
+          {
+            "format": "date-time",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "documents": {
+        "items": {
+          "properties": {
+            "contentType": {
+              "type": "string"
+            },
+            "fileName": {
+              "type": "string"
+            },
+            "id": {
+              "anyOf": [
+                {
+                  "description": "UUID value wrapper.",
+                  "properties": {
+                    "value": {
+                      "format": "uuid",
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "kind": {
+              "enum": [
+                "EQUITY_ONBOARDING_DOCUMENT_KIND_UNSPECIFIED",
+                "EQUITY_ONBOARDING_DOCUMENT_KIND_CERTIFICATE_OF_INCORPORATION",
+                "EQUITY_ONBOARDING_DOCUMENT_KIND_EIN_LETTER"
+              ],
+              "type": "string"
+            },
+            "sizeBytes": {
+              "type": "string"
+            },
+            "uploadedAt": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "einNumber": {
+        "type": "string"
+      },
+      "entityType": {
+        "type": "string"
+      },
+      "entityTypeOther": {
+        "type": "string"
+      },
+      "formationDate": {
+        "type": "string"
+      },
+      "formationId": {
+        "anyOf": [
+          {
+            "description": "UUID value wrapper.",
+            "properties": {
+              "value": {
+                "format": "uuid",
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "id": {
+        "anyOf": [
+          {
+            "description": "UUID value wrapper.",
+            "properties": {
+              "value": {
+                "format": "uuid",
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "legalName": {
+        "anyOf": [
+          {
+            "description": "Human-readable name (1-255 Unicode chars).",
+            "properties": {
+              "value": {
+                "maxLength": 255,
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "nonUs": {
+        "type": "boolean"
+      },
+      "prefillPercent": {
+        "type": "integer"
+      },
+      "provenance": {
+        "items": {
+          "properties": {
+            "confidence": {
+              "type": "number"
+            },
+            "confirmedAt": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "fieldPath": {
+              "type": "string"
+            },
+            "origin": {
+              "enum": [
+                "PROVENANCE_ORIGIN_UNSPECIFIED",
+                "PROVENANCE_ORIGIN_INVITE",
+                "PROVENANCE_ORIGIN_FORMATION",
+                "PROVENANCE_ORIGIN_CAP_TABLE",
+                "PROVENANCE_ORIGIN_IDENTITY_PROFILE",
+                "PROVENANCE_ORIGIN_EXTRACTED_DOCUMENT",
+                "PROVENANCE_ORIGIN_PROVIDER",
+                "PROVENANCE_ORIGIN_USER",
+                "PROVENANCE_ORIGIN_DEFAULT"
+              ],
+              "type": "string"
+            },
+            "sourceDocumentId": {
+              "anyOf": [
+                {
+                  "description": "UUID value wrapper.",
+                  "properties": {
+                    "value": {
+                      "format": "uuid",
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "sourceFormationId": {
+              "anyOf": [
+                {
+                  "description": "UUID value wrapper.",
+                  "properties": {
+                    "value": {
+                      "format": "uuid",
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "sourceLabel": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "registeredAddress": {
+        "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"
+          }
+        ]
+      },
+      "registeredAddressSource": {
+        "enum": [
+          "ADDRESS_SOURCE_UNSPECIFIED",
+          "ADDRESS_SOURCE_OWN",
+          "ADDRESS_SOURCE_NEED_ASSISTANCE"
+        ],
+        "type": "string"
+      },
+      "registeredAgentAddress": {
+        "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"
+          }
+        ]
+      },
+      "registeredAgentName": {
+        "anyOf": [
+          {
+            "description": "Human-readable name (1-255 Unicode chars).",
+            "properties": {
+              "value": {
+                "maxLength": 255,
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "sections": {
+        "items": {
+          "properties": {
+            "blockers": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "handoffUrl": {
+              "type": "string"
+            },
+            "key": {
+              "type": "string"
+            },
+            "label": {
+              "type": "string"
+            },
+            "state": {
+              "enum": [
+                "SECTION_STATE_UNSPECIFIED",
+                "SECTION_STATE_NOT_STARTED",
+                "SECTION_STATE_WORKING",
+                "SECTION_STATE_COMPLETE"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "stateOfIncorporation": {
+        "type": "string"
+      },
+      "status": {
+        "enum": [
+          "EQUITY_ONBOARDING_STATUS_UNSPECIFIED",
+          "EQUITY_ONBOARDING_STATUS_DRAFT",
+          "EQUITY_ONBOARDING_STATUS_COLLECTING",
+          "EQUITY_ONBOARDING_STATUS_SUBMITTED",
+          "EQUITY_ONBOARDING_STATUS_ABANDONED"
+        ],
+        "type": "string"
+      },
+      "submittedAt": {
+        "anyOf": [
+          {
+            "format": "date-time",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "suggestedEin": {
+        "type": "string"
+      },
+      "updatedAt": {
+        "anyOf": [
+          {
+            "format": "date-time",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed1 schema field changedSep 28, 2026

changedOutput schema / properties / onboarding / anyOf

Previous value: -[
-  {
-    "properties": {
-      "companyId": {
-        "anyOf": [
-          {
-            "description": "UUID value wrapper.",
-            "properties": {
-              "value": {
-                "format": "uuid",
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "countryOfIncorporation": {
-        "type": "string"
-      },
-      "createdAt": {
-        "anyOf": [
-          {
-            "format": "date-time",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "documents": {
-        "items": {
-          "properties": {
-            "contentType": {
-              "type": "string"
-            },
-            "fileName": {
-              "type": "string"
-            },
-            "id": {
-              "anyOf": [
-                {
-                  "description": "UUID value wrapper.",
-                  "properties": {
-                    "value": {
-                      "format": "uuid",
-                      "type": "string"
-                    }
-                  },
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "kind": {
-              "enum": [
-                "EQUITY_ONBOARDING_DOCUMENT_KIND_UNSPECIFIED",
-                "EQUITY_ONBOARDING_DOCUMENT_KIND_CERTIFICATE_OF_INCORPORATION",
-                "EQUITY_ONBOARDING_DOCUMENT_KIND_EIN_LETTER"
-              ],
-              "type": "string"
-            },
-            "sizeBytes": {
-              "type": "string"
-            },
-            "uploadedAt": {
-              "anyOf": [
-                {
-                  "format": "date-time",
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "einNumber": {
-        "type": "string"
-      },
-      "entityType": {
-        "type": "string"
-      },
-      "formationDate": {
-        "type": "string"
-      },
-      "formationId": {
-        "anyOf": [
-          {
-            "description": "UUID value wrapper.",
-            "properties": {
-              "value": {
-                "format": "uuid",
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "id": {
-        "anyOf": [
-          {
-            "description": "UUID value wrapper.",
-            "properties": {
-              "value": {
-                "format": "uuid",
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "legalName": {
-        "anyOf": [
-          {
-            "description": "Human-readable name (1-255 Unicode chars).",
-            "properties": {
-              "value": {
-                "maxLength": 255,
-                "minLength": 1,
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "nonUs": {
-        "type": "boolean"
-      },
-      "prefillPercent": {
-        "type": "integer"
-      },
-      "provenance": {
-        "items": {
-          "properties": {
-            "confidence": {
-              "type": "number"
-            },
-            "confirmedAt": {
-              "anyOf": [
-                {
-                  "format": "date-time",
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "fieldPath": {
-              "type": "string"
-            },
-            "origin": {
-              "enum": [
-                "PROVENANCE_ORIGIN_UNSPECIFIED",
-                "PROVENANCE_ORIGIN_INVITE",
-                "PROVENANCE_ORIGIN_FORMATION",
-                "PROVENANCE_ORIGIN_CAP_TABLE",
-                "PROVENANCE_ORIGIN_IDENTITY_PROFILE",
-                "PROVENANCE_ORIGIN_EXTRACTED_DOCUMENT",
-                "PROVENANCE_ORIGIN_PROVIDER",
-                "PROVENANCE_ORIGIN_USER",
-                "PROVENANCE_ORIGIN_DEFAULT"
-              ],
-              "type": "string"
-            },
-            "sourceDocumentId": {
-              "anyOf": [
-                {
-                  "description": "UUID value wrapper.",
-                  "properties": {
-                    "value": {
-                      "format": "uuid",
-                      "type": "string"
-                    }
-                  },
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "sourceFormationId": {
-              "anyOf": [
-                {
-                  "description": "UUID value wrapper.",
-                  "properties": {
-                    "value": {
-                      "format": "uuid",
-                      "type": "string"
-                    }
-                  },
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "sourceLabel": {
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "registeredAddress": {
-        "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"
-          }
-        ]
-      },
-      "registeredAgentAddress": {
-        "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"
-          }
-        ]
-      },
-      "registeredAgentName": {
-        "anyOf": [
-          {
-            "description": "Human-readable name (1-255 Unicode chars).",
-            "properties": {
-              "value": {
-                "maxLength": 255,
-                "minLength": 1,
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "sections": {
-        "items": {
-          "properties": {
-            "blockers": {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            "handoffUrl": {
-              "type": "string"
-            },
-            "key": {
-              "type": "string"
-            },
-            "label": {
-              "type": "string"
-            },
-            "state": {
-              "enum": [
-                "SECTION_STATE_UNSPECIFIED",
-                "SECTION_STATE_NOT_STARTED",
-                "SECTION_STATE_WORKING",
-                "SECTION_STATE_COMPLETE"
-              ],
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "stateOfIncorporation": {
-        "type": "string"
-      },
-      "status": {
-        "enum": [
-          "EQUITY_ONBOARDING_STATUS_UNSPECIFIED",
-          "EQUITY_ONBOARDING_STATUS_DRAFT",
-          "EQUITY_ONBOARDING_STATUS_COLLECTING",
-          "EQUITY_ONBOARDING_STATUS_SUBMITTED",
-          "EQUITY_ONBOARDING_STATUS_ABANDONED"
-        ],
-        "type": "string"
-      },
-      "submittedAt": {
-        "anyOf": [
-          {
-            "format": "date-time",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "updatedAt": {
-        "anyOf": [
-          {
-            "format": "date-time",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "properties": {
+      "companyId": {
+        "anyOf": [
+          {
+            "description": "UUID value wrapper.",
+            "properties": {
+              "value": {
+                "format": "uuid",
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "countryOfIncorporation": {
+        "type": "string"
+      },
+      "createdAt": {
+        "anyOf": [
+          {
+            "format": "date-time",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "documents": {
+        "items": {
+          "properties": {
+            "contentType": {
+              "type": "string"
+            },
+            "fileName": {
+              "type": "string"
+            },
+            "id": {
+              "anyOf": [
+                {
+                  "description": "UUID value wrapper.",
+                  "properties": {
+                    "value": {
+                      "format": "uuid",
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "kind": {
+              "enum": [
+                "EQUITY_ONBOARDING_DOCUMENT_KIND_UNSPECIFIED",
+                "EQUITY_ONBOARDING_DOCUMENT_KIND_CERTIFICATE_OF_INCORPORATION",
+                "EQUITY_ONBOARDING_DOCUMENT_KIND_EIN_LETTER"
+              ],
+              "type": "string"
+            },
+            "sizeBytes": {
+              "type": "string"
+            },
+            "uploadedAt": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "einNumber": {
+        "type": "string"
+      },
+      "entityType": {
+        "type": "string"
+      },
+      "formationDate": {
+        "type": "string"
+      },
+      "formationId": {
+        "anyOf": [
+          {
+            "description": "UUID value wrapper.",
+            "properties": {
+              "value": {
+                "format": "uuid",
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "id": {
+        "anyOf": [
+          {
+            "description": "UUID value wrapper.",
+            "properties": {
+              "value": {
+                "format": "uuid",
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "legalName": {
+        "anyOf": [
+          {
+            "description": "Human-readable name (1-255 Unicode chars).",
+            "properties": {
+              "value": {
+                "maxLength": 255,
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "nonUs": {
+        "type": "boolean"
+      },
+      "prefillPercent": {
+        "type": "integer"
+      },
+      "provenance": {
+        "items": {
+          "properties": {
+            "confidence": {
+              "type": "number"
+            },
+            "confirmedAt": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "fieldPath": {
+              "type": "string"
+            },
+            "origin": {
+              "enum": [
+                "PROVENANCE_ORIGIN_UNSPECIFIED",
+                "PROVENANCE_ORIGIN_INVITE",
+                "PROVENANCE_ORIGIN_FORMATION",
+                "PROVENANCE_ORIGIN_CAP_TABLE",
+                "PROVENANCE_ORIGIN_IDENTITY_PROFILE",
+                "PROVENANCE_ORIGIN_EXTRACTED_DOCUMENT",
+                "PROVENANCE_ORIGIN_PROVIDER",
+                "PROVENANCE_ORIGIN_USER",
+                "PROVENANCE_ORIGIN_DEFAULT"
+              ],
+              "type": "string"
+            },
+            "sourceDocumentId": {
+              "anyOf": [
+                {
+                  "description": "UUID value wrapper.",
+                  "properties": {
+                    "value": {
+                      "format": "uuid",
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "sourceFormationId": {
+              "anyOf": [
+                {
+                  "description": "UUID value wrapper.",
+                  "properties": {
+                    "value": {
+                      "format": "uuid",
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "sourceLabel": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "registeredAddress": {
+        "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"
+          }
+        ]
+      },
+      "registeredAddressSource": {
+        "enum": [
+          "ADDRESS_SOURCE_UNSPECIFIED",
+          "ADDRESS_SOURCE_OWN",
+          "ADDRESS_SOURCE_NEED_ASSISTANCE"
+        ],
+        "type": "string"
+      },
+      "registeredAgentAddress": {
+        "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"
+          }
+        ]
+      },
+      "registeredAgentName": {
+        "anyOf": [
+          {
+            "description": "Human-readable name (1-255 Unicode chars).",
+            "properties": {
+              "value": {
+                "maxLength": 255,
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "sections": {
+        "items": {
+          "properties": {
+            "blockers": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "handoffUrl": {
+              "type": "string"
+            },
+            "key": {
+              "type": "string"
+            },
+            "label": {
+              "type": "string"
+            },
+            "state": {
+              "enum": [
+                "SECTION_STATE_UNSPECIFIED",
+                "SECTION_STATE_NOT_STARTED",
+                "SECTION_STATE_WORKING",
+                "SECTION_STATE_COMPLETE"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "stateOfIncorporation": {
+        "type": "string"
+      },
+      "status": {
+        "enum": [
+          "EQUITY_ONBOARDING_STATUS_UNSPECIFIED",
+          "EQUITY_ONBOARDING_STATUS_DRAFT",
+          "EQUITY_ONBOARDING_STATUS_COLLECTING",
+          "EQUITY_ONBOARDING_STATUS_SUBMITTED",
+          "EQUITY_ONBOARDING_STATUS_ABANDONED"
+        ],
+        "type": "string"
+      },
+      "submittedAt": {
+        "anyOf": [
+          {
+            "format": "date-time",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "suggestedEin": {
+        "type": "string"
+      },
+      "updatedAt": {
+        "anyOf": [
+          {
+            "format": "date-time",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed1 schema field changedSep 15, 2026

changedOutput schema / properties / onboarding / anyOf

Previous value: -[
-  {
-    "properties": {
-      "companyId": {
-        "anyOf": [
-          {
-            "description": "UUID value wrapper.",
-            "properties": {
-              "value": {
-                "format": "uuid",
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "countryOfIncorporation": {
-        "type": "string"
-      },
-      "createdAt": {
-        "anyOf": [
-          {
-            "format": "date-time",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "documents": {
-        "items": {
-          "properties": {
-            "contentType": {
-              "type": "string"
-            },
-            "fileName": {
-              "type": "string"
-            },
-            "id": {
-              "anyOf": [
-                {
-                  "description": "UUID value wrapper.",
-                  "properties": {
-                    "value": {
-                      "format": "uuid",
-                      "type": "string"
-                    }
-                  },
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "kind": {
-              "enum": [
-                "EQUITY_ONBOARDING_DOCUMENT_KIND_UNSPECIFIED",
-                "EQUITY_ONBOARDING_DOCUMENT_KIND_CERTIFICATE_OF_INCORPORATION",
-                "EQUITY_ONBOARDING_DOCUMENT_KIND_EIN_LETTER"
-              ],
-              "type": "string"
-            },
-            "sizeBytes": {
-              "type": "string"
-            },
-            "uploadedAt": {
-              "anyOf": [
-                {
-                  "format": "date-time",
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "einNumber": {
-        "type": "string"
-      },
-      "entityType": {
-        "type": "string"
-      },
-      "formationDate": {
-        "type": "string"
-      },
-      "formationId": {
-        "anyOf": [
-          {
-            "description": "UUID value wrapper.",
-            "properties": {
-              "value": {
-                "format": "uuid",
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "id": {
-        "anyOf": [
-          {
-            "description": "UUID value wrapper.",
-            "properties": {
-              "value": {
-                "format": "uuid",
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "legalName": {
-        "anyOf": [
-          {
-            "description": "Human-readable name (1-255 Unicode chars).",
-            "properties": {
-              "value": {
-                "maxLength": 255,
-                "minLength": 1,
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "nonUs": {
-        "type": "boolean"
-      },
-      "prefillPercent": {
-        "type": "integer"
-      },
-      "provenance": {
-        "items": {
-          "properties": {
-            "confidence": {
-              "type": "number"
-            },
-            "confirmedAt": {
-              "anyOf": [
-                {
-                  "format": "date-time",
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "fieldPath": {
-              "type": "string"
-            },
-            "origin": {
-              "enum": [
-                "PROVENANCE_ORIGIN_UNSPECIFIED",
-                "PROVENANCE_ORIGIN_INVITE",
-                "PROVENANCE_ORIGIN_FORMATION",
-                "PROVENANCE_ORIGIN_CAP_TABLE",
-                "PROVENANCE_ORIGIN_IDENTITY_PROFILE",
-                "PROVENANCE_ORIGIN_EXTRACTED_DOCUMENT",
-                "PROVENANCE_ORIGIN_PROVIDER",
-                "PROVENANCE_ORIGIN_USER",
-                "PROVENANCE_ORIGIN_DEFAULT"
-              ],
-              "type": "string"
-            },
-            "sourceDocumentId": {
-              "anyOf": [
-                {
-                  "description": "UUID value wrapper.",
-                  "properties": {
-                    "value": {
-                      "format": "uuid",
-                      "type": "string"
-                    }
-                  },
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "sourceFormationId": {
-              "anyOf": [
-                {
-                  "description": "UUID value wrapper.",
-                  "properties": {
-                    "value": {
-                      "format": "uuid",
-                      "type": "string"
-                    }
-                  },
-                  "type": "object"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
-            "sourceLabel": {
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "registeredAddress": {
-        "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"
-          }
-        ]
-      },
-      "sections": {
-        "items": {
-          "properties": {
-            "blockers": {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            "handoffUrl": {
-              "type": "string"
-            },
-            "key": {
-              "type": "string"
-            },
-            "label": {
-              "type": "string"
-            },
-            "state": {
-              "enum": [
-                "SECTION_STATE_UNSPECIFIED",
-                "SECTION_STATE_NOT_STARTED",
-                "SECTION_STATE_WORKING",
-                "SECTION_STATE_COMPLETE"
-              ],
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "stateOfIncorporation": {
-        "type": "string"
-      },
-      "status": {
-        "enum": [
-          "EQUITY_ONBOARDING_STATUS_UNSPECIFIED",
-          "EQUITY_ONBOARDING_STATUS_DRAFT",
-          "EQUITY_ONBOARDING_STATUS_COLLECTING",
-          "EQUITY_ONBOARDING_STATUS_SUBMITTED",
-          "EQUITY_ONBOARDING_STATUS_ABANDONED"
-        ],
-        "type": "string"
-      },
-      "submittedAt": {
-        "anyOf": [
-          {
-            "format": "date-time",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "updatedAt": {
-        "anyOf": [
-          {
-            "format": "date-time",
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "properties": {
+      "companyId": {
+        "anyOf": [
+          {
+            "description": "UUID value wrapper.",
+            "properties": {
+              "value": {
+                "format": "uuid",
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "countryOfIncorporation": {
+        "type": "string"
+      },
+      "createdAt": {
+        "anyOf": [
+          {
+            "format": "date-time",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "documents": {
+        "items": {
+          "properties": {
+            "contentType": {
+              "type": "string"
+            },
+            "fileName": {
+              "type": "string"
+            },
+            "id": {
+              "anyOf": [
+                {
+                  "description": "UUID value wrapper.",
+                  "properties": {
+                    "value": {
+                      "format": "uuid",
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "kind": {
+              "enum": [
+                "EQUITY_ONBOARDING_DOCUMENT_KIND_UNSPECIFIED",
+                "EQUITY_ONBOARDING_DOCUMENT_KIND_CERTIFICATE_OF_INCORPORATION",
+                "EQUITY_ONBOARDING_DOCUMENT_KIND_EIN_LETTER"
+              ],
+              "type": "string"
+            },
+            "sizeBytes": {
+              "type": "string"
+            },
+            "uploadedAt": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "einNumber": {
+        "type": "string"
+      },
+      "entityType": {
+        "type": "string"
+      },
+      "formationDate": {
+        "type": "string"
+      },
+      "formationId": {
+        "anyOf": [
+          {
+            "description": "UUID value wrapper.",
+            "properties": {
+              "value": {
+                "format": "uuid",
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "id": {
+        "anyOf": [
+          {
+            "description": "UUID value wrapper.",
+            "properties": {
+              "value": {
+                "format": "uuid",
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "legalName": {
+        "anyOf": [
+          {
+            "description": "Human-readable name (1-255 Unicode chars).",
+            "properties": {
+              "value": {
+                "maxLength": 255,
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "nonUs": {
+        "type": "boolean"
+      },
+      "prefillPercent": {
+        "type": "integer"
+      },
+      "provenance": {
+        "items": {
+          "properties": {
+            "confidence": {
+              "type": "number"
+            },
+            "confirmedAt": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "fieldPath": {
+              "type": "string"
+            },
+            "origin": {
+              "enum": [
+                "PROVENANCE_ORIGIN_UNSPECIFIED",
+                "PROVENANCE_ORIGIN_INVITE",
+                "PROVENANCE_ORIGIN_FORMATION",
+                "PROVENANCE_ORIGIN_CAP_TABLE",
+                "PROVENANCE_ORIGIN_IDENTITY_PROFILE",
+                "PROVENANCE_ORIGIN_EXTRACTED_DOCUMENT",
+                "PROVENANCE_ORIGIN_PROVIDER",
+                "PROVENANCE_ORIGIN_USER",
+                "PROVENANCE_ORIGIN_DEFAULT"
+              ],
+              "type": "string"
+            },
+            "sourceDocumentId": {
+              "anyOf": [
+                {
+                  "description": "UUID value wrapper.",
+                  "properties": {
+                    "value": {
+                      "format": "uuid",
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "sourceFormationId": {
+              "anyOf": [
+                {
+                  "description": "UUID value wrapper.",
+                  "properties": {
+                    "value": {
+                      "format": "uuid",
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "sourceLabel": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "registeredAddress": {
+        "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"
+          }
+        ]
+      },
+      "registeredAgentAddress": {
+        "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"
+          }
+        ]
+      },
+      "registeredAgentName": {
+        "anyOf": [
+          {
+            "description": "Human-readable name (1-255 Unicode chars).",
+            "properties": {
+              "value": {
+                "maxLength": 255,
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "sections": {
+        "items": {
+          "properties": {
+            "blockers": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "handoffUrl": {
+              "type": "string"
+            },
+            "key": {
+              "type": "string"
+            },
+            "label": {
+              "type": "string"
+            },
+            "state": {
+              "enum": [
+                "SECTION_STATE_UNSPECIFIED",
+                "SECTION_STATE_NOT_STARTED",
+                "SECTION_STATE_WORKING",
+                "SECTION_STATE_COMPLETE"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "stateOfIncorporation": {
+        "type": "string"
+      },
+      "status": {
+        "enum": [
+          "EQUITY_ONBOARDING_STATUS_UNSPECIFIED",
+          "EQUITY_ONBOARDING_STATUS_DRAFT",
+          "EQUITY_ONBOARDING_STATUS_COLLECTING",
+          "EQUITY_ONBOARDING_STATUS_SUBMITTED",
+          "EQUITY_ONBOARDING_STATUS_ABANDONED"
+        ],
+        "type": "string"
+      },
+      "submittedAt": {
+        "anyOf": [
+          {
+            "format": "date-time",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "updatedAt": {
+        "anyOf": [
+          {
+            "format": "date-time",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

AddedSep 10, 2026

TDQS

A3.9/5.0

Behavior5/5

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

Annotations supply only destructiveHint=true and openWorldHint=false, and the description goes well beyond them: it defines a refusal as a normal, non-retryable outcome that enumerates blocking sections and a human-completion URL, and it states the success side effects (cap table opens, entity facts written only where none is stored). That no-overwrite/idempotent nuance is exactly the context an agent needs to act safely on a destructive-flagged tool.

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 sentences, front-loaded with the core action, and every sentence carries information: refusal semantics, do-not-retry instruction, and success effects. Slightly dense clause stacking ('where none is stored; a fact already stored there is left as it is') but no filler.

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

Completeness4/5

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

For a destructive, nested-parameter mutation with an output schema, the description covers the outcome and error path adequately, so return values need not be explained. It leaves out prerequisites (that an onboarding session must exist) and its relationship to the sibling onboarding tools, which would have made it fully self-sufficient.

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 description coverage is 100% and there is a single required onboardingId, so the schema fully documents the parameter. The description adds no syntax, format, or sourcing guidance for onboardingId; per the high-coverage baseline this is a 3.

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: 'Finishes the intake and records the company's proof of formation.' The agent knows this completes an equity onboarding. It does not, however, name or contrast itself with the nearest siblings (equity_onboarding_start, equity_onboarding_update, equity_onboarding_preview_formation_carry), so the differentiation is only implicit from 'Finishes'.

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?

Implies this is the terminal step ('Finishes the intake') and gives clear follow-up guidance on refusal ('Read that back rather than retrying'), which is useful. But there is no explicit when-to-use/when-not-to-use framing and no mention of how this differs from the sibling update/preview tools, so the agent must infer the entry point.

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.

Submit Equity Onboarding

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources