Skip to main content
Glama

Lovie Company Formation

by co.lovie
OverviewDiscussionsAdmin

Start Equity Onboarding

equity_onboarding_start
Idempotent

Opens a company's proof-of-formation intake so its cap table can be set up. Idempotent: a company has at most one open intake, and calling again returns the existing one rather than splitting the answers across two records. Safe to call first when you do not know whether an intake exists.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
companyIdYesUUID value wrapper.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
onboardingNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • 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"
+  }
+]
  2. Changed1 schema field changed
    • 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"
+  }
+]
  3. Changed1 schema field changed
    • 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"
+  }
+]
  4. Added

TDQS

A4/5.0
Behavior4/5

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

Annotations already declare idempotentHint=true and destructiveHint=false, but the description adds real value by explaining the mechanics: a company has at most one open intake and repeat calls return the existing record rather than splitting answers. That is behavioral detail beyond the annotations.

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

Conciseness5/5

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

Three tight sentences, front-loaded with purpose then idempotency then usage guidance. Nothing is wasted and the most important information comes first.

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?

An output schema exists so return values need not be explained, and annotations cover the safety profile. The description rounds out the picture with purpose, idempotency, and usage guidance, leaving little an agent would need to infer.

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% for the single companyId parameter, so the schema already documents it. The description adds no additional meaning about the parameter, so the baseline 3 applies.

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 ('Opens a company's proof-of-formation intake') plus the downstream goal ('so its cap table can be set up'). It is clearly distinguishable from siblings like equity_onboarding_submit or equity_onboarding_get, though it never names them explicitly.

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

Usage Guidelines4/5

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

Provides a concrete when-to-use rule: 'Safe to call first when you do not know whether an intake exists.' This gives clear context for choosing this tool over equity_onboarding_get, but stops short of explicitly naming it as the alternative.

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 toolsInspect
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.

Resources