Skip to main content
Glama

Lovie Company Formation

Import RSA

cap_table_import_rsa
Destructive

Imports a signed Restricted Stock Purchase/Award Agreement (RSA) from an uploaded PDF and stores the document in S3. USE THIS (not ExtractRsaTermsOcr + CreateCapTableAgreement, and not RecordCapTableInvestment) whenever the user provides or uploads a signed RSA PDF. The grantee (founder/employee/advisor) MUST already exist as a cap-table stakeholder — this tool matches the document to an existing stakeholder by name and does NOT create one; if there is no match the import is rejected, so add the stakeholder first. Mandatory two-step human-in-the-loop flow: (1) call GetOcrUploadUrl with kind=RSA and mime_type=application/pdf, then upload the PDF bytes to the returned PUT URL; (2) call ImportRSA with preview=true and that source_s3_uri — this runs OCR and returns the extracted founder/company names and terms (shares, vesting, price_per_share, grant_date, 83b status, acceleration) plus the resolved grantee (matched_stakeholder_id; when it is empty no stakeholder matched, the response carries a warning, and the import will be refused until the grantee is added) WITHOUT persisting anything; (3) PRESENT those terms to the user as a table, let them correct any value, and get explicit confirmation; (4) call ImportRSA again WITHOUT preview and the SAME source_s3_uri; pass rsa_terms_override with any user-corrected terms (omit it to accept the extracted terms as-is), and stakeholder_id to pin the matched grantee. This creates the common-stock holding with its vesting schedule (or updates the grantee's existing holding), records a signed RSA agreement, and links the PDF — atomically. Shares the agreement leaves vested at issuance (total less unvested) are recorded as vested_at_issuance_shares; an existing holding keeps its recorded share count. The preview and the import both carry warnings for anything recorded differently from the document — relay every one to the user. Never skip the preview + confirmation step; never persist unreviewed OCR output. Empty string / 0 / false in the extracted terms means the value was not stated in the document — never fabricate.

Tool call template

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

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

Input Schema

NameRequiredDescriptionDefault
previewNo
companyIdYesUUID value wrapper.
sourceS3UriNo
stakeholderIdNoUUID value wrapper.
consentToAiReadNo
rsaTermsOverrideNo
newStakeholderNameNo

Output Schema

NameRequiredDescriptionDefault
statusNo
createdNo
previewNo
warningsNo
securityIdNo
agreementIdNo
stakeholderIdNo
consentVersionNo
consentBodyMarkdownNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedOutput schema / properties / warnings
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
  2. Changed15 schema fields changed
    • addedOutput schema / properties / agreementId / anyOf
      Added value: +[
      +  {
      +    "description": "UUID value wrapper.",
      +    "properties": {
      +      "value": {
      +        "format": "uuid",
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / properties / agreementId / description
      Removed value: -"UUID value wrapper."
    • removedOutput schema / properties / agreementId / properties
      Removed value: -{
      -  "value": {
      -    "format": "uuid",
      -    "type": "string"
      -  }
      -}
    • removedOutput schema / properties / agreementId / type
      Removed value: -"object"
    • addedOutput schema / properties / preview / anyOf
      Added value: +[
      +  {
      +    "properties": {
      +      "companyName": {
      +        "type": "string"
      +      },
      +      "founderName": {
      +        "type": "string"
      +      },
      +      "matchedStakeholderId": {
      +        "anyOf": [
      +          {
      +            "description": "UUID value wrapper.",
      +            "properties": {
      +              "value": {
      +                "format": "uuid",
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "ocrConfidence": {
      +        "type": "string"
      +      },
      +      "resolvedStakeholderName": {
      +        "type": "string"
      +      },
      +      "rsaTerms": {
      +        "anyOf": [
      +          {
      +            "properties": {
      +              "accelerationClause": {
      +                "type": "string"
      +              },
      +              "governingLaw": {
      +                "type": "string"
      +              },
      +              "grantDate": {
      +                "anyOf": [
      +                  {
      +                    "format": "date-time",
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "ipAssignment": {
      +                "type": "boolean"
      +              },
      +              "pricePerShare": {
      +                "type": "string"
      +              },
      +              "repurchaseOptionWindowMonths": {
      +                "type": "integer"
      +              },
      +              "repurchaseRight": {
      +                "type": "boolean"
      +              },
      +              "rightOfFirstRefusal": {
      +                "type": "boolean"
      +              },
      +              "section83bFiled": {
      +                "type": "string"
      +              },
      +              "signedByName": {
      +                "type": "string"
      +              },
      +              "signedByTitle": {
      +                "type": "string"
      +              },
      +              "signedDate": {
      +                "anyOf": [
      +                  {
      +                    "format": "date-time",
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "spouseConsent": {
      +                "type": "boolean"
      +              },
      +              "totalPurchasePrice": {
      +                "type": "string"
      +              },
      +              "totalShares": {
      +                "type": "string"
      +              },
      +              "unvestedShares": {
      +                "type": "string"
      +              },
      +              "vestingCliffMonths": {
      +                "type": "integer"
      +              },
      +              "vestingProvision": {
      +                "type": "string"
      +              },
      +              "vestingStartDate": {
      +                "anyOf": [
      +                  {
      +                    "format": "date-time",
      +                    "type": "string"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "vestingTotalMonths": {
      +                "type": "integer"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "warnings": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "wouldCreate": {
      +        "type": "boolean"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / properties / preview / properties
      Removed value: -{
      -  "companyName": {
      -    "type": "string"
      -  },
      -  "founderName": {
      -    "type": "string"
      -  },
      -  "matchedStakeholderId": {
      -    "description": "UUID value wrapper.",
      -    "properties": {
      -      "value": {
      -        "format": "uuid",
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  "ocrConfidence": {
      -    "type": "string"
      -  },
      -  "resolvedStakeholderName": {
      -    "type": "string"
      -  },
      -  "rsaTerms": {
      -    "properties": {
      -      "accelerationClause": {
      -        "type": "string"
      -      },
      -      "governingLaw": {
      -        "type": "string"
      -      },
      -      "grantDate": {
      -        "format": "date-time",
      -        "type": "string"
      -      },
      -      "ipAssignment": {
      -        "type": "boolean"
      -      },
      -      "pricePerShare": {
      -        "type": "string"
      -      },
      -      "repurchaseOptionWindowMonths": {
      -        "type": "integer"
      -      },
      -      "repurchaseRight": {
      -        "type": "boolean"
      -      },
      -      "rightOfFirstRefusal": {
      -        "type": "boolean"
      -      },
      -      "section83bFiled": {
      -        "type": "string"
      -      },
      -      "signedByName": {
      -        "type": "string"
      -      },
      -      "signedByTitle": {
      -        "type": "string"
      -      },
      -      "signedDate": {
      -        "format": "date-time",
      -        "type": "string"
      -      },
      -      "spouseConsent": {
      -        "type": "boolean"
      -      },
      -      "totalPurchasePrice": {
      -        "type": "string"
      -      },
      -      "totalShares": {
      -        "type": "string"
      -      },
      -      "unvestedShares": {
      -        "type": "string"
      -      },
      -      "vestingCliffMonths": {
      -        "type": "integer"
      -      },
      -      "vestingProvision": {
      -        "type": "string"
      -      },
      -      "vestingStartDate": {
      -        "format": "date-time",
      -        "type": "string"
      -      },
      -      "vestingTotalMonths": {
      -        "type": "integer"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  "warnings": {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "wouldCreate": {
      -    "type": "boolean"
      -  }
      -}
    • removedOutput schema / properties / preview / type
      Removed value: -"object"
    • addedOutput schema / properties / securityId / anyOf
      Added value: +[
      +  {
      +    "description": "UUID value wrapper.",
      +    "properties": {
      +      "value": {
      +        "format": "uuid",
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / properties / securityId / description
      Removed value: -"UUID value wrapper."
    • removedOutput schema / properties / securityId / properties
      Removed value: -{
      -  "value": {
      -    "format": "uuid",
      -    "type": "string"
      -  }
      -}
    • removedOutput schema / properties / securityId / type
      Removed value: -"object"
    • addedOutput schema / properties / stakeholderId / anyOf
      Added value: +[
      +  {
      +    "description": "UUID value wrapper.",
      +    "properties": {
      +      "value": {
      +        "format": "uuid",
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / properties / stakeholderId / description
      Removed value: -"UUID value wrapper."
    • removedOutput schema / properties / stakeholderId / properties
      Removed value: -{
      -  "value": {
      -    "format": "uuid",
      -    "type": "string"
      -  }
      -}
    • removedOutput schema / properties / stakeholderId / type
      Removed value: -"object"
  3. First observed

TDQS

A4.7/5.0
Behavior5/5

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

Beyond the annotations, the description discloses critical behavior: preview runs OCR without persisting, the final call creates or updates a holding and agreement atomically, unmatched stakeholders cause rejection, and warnings must be relayed. It also clarifies that empty string/0/false in extracted terms means the document did not state the value.

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?

The description is long but appropriate for a multi-step destructive workflow, and it is front-loaded with the core action and alternatives. The numbered human-in-the-loop steps make it scannable, though there is some repetition around never skipping preview and relaying warnings.

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?

Given the tool's complexity, an output schema, and a 7-parameter nested input, the description is largely complete about the workflow, matching behavior, preview safety, and warning handling. The main gaps are unexplained non-core parameters such as consentToAiRead and newStakeholderName, plus the slight tension around whether a new stakeholder can be created.

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

Parameters4/5

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

Schema description coverage is low at 29%, so the description carries substantial burden and does explain the important parameters: preview, sourceS3Uri, rsaTermsOverride, and stakeholderId. However, it does not explain companyId, consentToAiRead, or newStakeholderName, and its statement that the tool does not create stakeholders sits uneasily with the presence of newStakeholderName in the schema.

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

Purpose5/5

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

The description states a specific verb and resource: it imports a signed Restricted Stock Purchase/Award Agreement from an uploaded PDF and stores the document in S3. It explicitly distinguishes the tool from named siblings such as ExtractRsaTermsOcr + CreateCapTableAgreement and RecordCapTableInvestment, so an agent can identify when this is the right tool.

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

Usage Guidelines5/5

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

It gives explicit when-to-use guidance ('whenever the user provides or uploads a signed RSA PDF') and names alternatives to avoid. It also states the prerequisite that the grantee must already exist and provides a mandatory preview/confirmation workflow, leaving little to inference.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.