Skip to main content
Glama

Lovie Company Formation

Get Cap Table Agreement

cap_table_get_cap_table_agreement
Read-only

Returns one equity agreement by id — a SAFE, a stock purchase agreement or a grant — with its terms and the two signature blocks it prints. Read-only. Use this to answer questions about a specific agreement's valuation cap, discount, amount or signing state. To find the id, list a company's agreements first.

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": {
      "id": "<id>"
    },
    "name": "cap_table_get_cap_table_agreement"
  }
}

Input Schema

NameRequiredDescriptionDefault
idYesUUID value wrapper.
companyIdNoUUID value wrapper.

Output Schema

NameRequiredDescriptionDefault
agreementNo
signatureBlockNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / companyId
      Added value: +{
      +  "description": "UUID value wrapper.",
      +  "properties": {
      +    "value": {
      +      "format": "uuid",
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
  2. Changed6 schema fields changed
    • addedOutput schema / properties / agreement / anyOf
      Added value: +[
      +  {
      +    "properties": {
      +      "approvedAt": {
      +        "anyOf": [
      +          {
      +            "format": "date-time",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "companyId": {
      +        "anyOf": [
      +          {
      +            "description": "UUID value wrapper.",
      +            "properties": {
      +              "value": {
      +                "format": "uuid",
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "createdAt": {
      +        "anyOf": [
      +          {
      +            "format": "date-time",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "discountRate": {
      +        "type": "string"
      +      },
      +      "envelopeId": {
      +        "anyOf": [
      +          {
      +            "description": "UUID value wrapper.",
      +            "properties": {
      +              "value": {
      +                "format": "uuid",
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "expiresAt": {
      +        "anyOf": [
      +          {
      +            "format": "date-time",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "fileName": {
      +        "type": "string"
      +      },
      +      "generatedAt": {
      +        "anyOf": [
      +          {
      +            "format": "date-time",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "granteeName": {
      +        "type": "string"
      +      },
      +      "id": {
      +        "anyOf": [
      +          {
      +            "description": "UUID value wrapper.",
      +            "properties": {
      +              "value": {
      +                "format": "uuid",
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "instrumentType": {
      +        "type": "string"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "pipelineStatus": {
      +        "type": "string"
      +      },
      +      "progressApproved": {
      +        "type": "integer"
      +      },
      +      "progressTotal": {
      +        "type": "integer"
      +      },
      +      "purchaseAmount": {
      +        "type": "string"
      +      },
      +      "roundId": {
      +        "anyOf": [
      +          {
      +            "description": "UUID value wrapper.",
      +            "properties": {
      +              "value": {
      +                "format": "uuid",
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "sentAt": {
      +        "anyOf": [
      +          {
      +            "format": "date-time",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "signedAt": {
      +        "anyOf": [
      +          {
      +            "format": "date-time",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "stakeholderId": {
      +        "anyOf": [
      +          {
      +            "description": "UUID value wrapper.",
      +            "properties": {
      +              "value": {
      +                "format": "uuid",
      +                "type": "string"
      +              }
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "stakeholderName": {
      +        "type": "string"
      +      },
      +      "stakeholderType": {
      +        "type": "string"
      +      },
      +      "status": {
      +        "enum": [
      +          "CAP_TABLE_AGREEMENT_STATUS_UNSPECIFIED",
      +          "CAP_TABLE_AGREEMENT_STATUS_DRAFT",
      +          "CAP_TABLE_AGREEMENT_STATUS_PENDING",
      +          "CAP_TABLE_AGREEMENT_STATUS_GENERATING",
      +          "CAP_TABLE_AGREEMENT_STATUS_SENT",
      +          "CAP_TABLE_AGREEMENT_STATUS_PARTIALLY_APPROVED",
      +          "CAP_TABLE_AGREEMENT_STATUS_SIGNED",
      +          "CAP_TABLE_AGREEMENT_STATUS_COMPLETED",
      +          "CAP_TABLE_AGREEMENT_STATUS_APPROVED",
      +          "CAP_TABLE_AGREEMENT_STATUS_VOID",
      +          "CAP_TABLE_AGREEMENT_STATUS_DECLINED",
      +          "CAP_TABLE_AGREEMENT_STATUS_EXPIRED",
      +          "CAP_TABLE_AGREEMENT_STATUS_FAILED"
      +        ],
      +        "type": "string"
      +      },
      +      "type": {
      +        "enum": [
      +          "CAP_TABLE_AGREEMENT_TYPE_UNSPECIFIED",
      +          "CAP_TABLE_AGREEMENT_TYPE_SAFE",
      +          "CAP_TABLE_AGREEMENT_TYPE_OPTION",
      +          "CAP_TABLE_AGREEMENT_TYPE_RSU",
      +          "CAP_TABLE_AGREEMENT_TYPE_RSA",
      +          "CAP_TABLE_AGREEMENT_TYPE_FAST",
      +          "CAP_TABLE_AGREEMENT_TYPE_BOARD_CONSENT",
      +          "CAP_TABLE_AGREEMENT_TYPE_CONVERTIBLE_LOAN",
      +          "CAP_TABLE_AGREEMENT_TYPE_VENTURE_DEBT",
      +          "CAP_TABLE_AGREEMENT_TYPE_OTHER"
      +        ],
      +        "type": "string"
      +      },
      +      "updatedAt": {
      +        "anyOf": [
      +          {
      +            "format": "date-time",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "valuationCap": {
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / properties / agreement / properties
      Removed value: -{
      -  "approvedAt": {
      -    "format": "date-time",
      -    "type": "string"
      -  },
      -  "companyId": {
      -    "description": "UUID value wrapper.",
      -    "properties": {
      -      "value": {
      -        "format": "uuid",
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  "createdAt": {
      -    "format": "date-time",
      -    "type": "string"
      -  },
      -  "discountRate": {
      -    "type": "string"
      -  },
      -  "envelopeId": {
      -    "description": "UUID value wrapper.",
      -    "properties": {
      -      "value": {
      -        "format": "uuid",
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  "expiresAt": {
      -    "format": "date-time",
      -    "type": "string"
      -  },
      -  "fileName": {
      -    "type": "string"
      -  },
      -  "generatedAt": {
      -    "format": "date-time",
      -    "type": "string"
      -  },
      -  "granteeName": {
      -    "type": "string"
      -  },
      -  "id": {
      -    "description": "UUID value wrapper.",
      -    "properties": {
      -      "value": {
      -        "format": "uuid",
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  "instrumentType": {
      -    "type": "string"
      -  },
      -  "name": {
      -    "type": "string"
      -  },
      -  "pipelineStatus": {
      -    "type": "string"
      -  },
      -  "progressApproved": {
      -    "type": "integer"
      -  },
      -  "progressTotal": {
      -    "type": "integer"
      -  },
      -  "purchaseAmount": {
      -    "type": "string"
      -  },
      -  "roundId": {
      -    "description": "UUID value wrapper.",
      -    "properties": {
      -      "value": {
      -        "format": "uuid",
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  "sentAt": {
      -    "format": "date-time",
      -    "type": "string"
      -  },
      -  "signedAt": {
      -    "format": "date-time",
      -    "type": "string"
      -  },
      -  "stakeholderId": {
      -    "description": "UUID value wrapper.",
      -    "properties": {
      -      "value": {
      -        "format": "uuid",
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  "stakeholderName": {
      -    "type": "string"
      -  },
      -  "stakeholderType": {
      -    "type": "string"
      -  },
      -  "status": {
      -    "enum": [
      -      "CAP_TABLE_AGREEMENT_STATUS_UNSPECIFIED",
      -      "CAP_TABLE_AGREEMENT_STATUS_DRAFT",
      -      "CAP_TABLE_AGREEMENT_STATUS_PENDING",
      -      "CAP_TABLE_AGREEMENT_STATUS_GENERATING",
      -      "CAP_TABLE_AGREEMENT_STATUS_SENT",
      -      "CAP_TABLE_AGREEMENT_STATUS_PARTIALLY_APPROVED",
      -      "CAP_TABLE_AGREEMENT_STATUS_SIGNED",
      -      "CAP_TABLE_AGREEMENT_STATUS_COMPLETED",
      -      "CAP_TABLE_AGREEMENT_STATUS_APPROVED",
      -      "CAP_TABLE_AGREEMENT_STATUS_VOID",
      -      "CAP_TABLE_AGREEMENT_STATUS_DECLINED",
      -      "CAP_TABLE_AGREEMENT_STATUS_EXPIRED",
      -      "CAP_TABLE_AGREEMENT_STATUS_FAILED"
      -    ],
      -    "type": "string"
      -  },
      -  "type": {
      -    "enum": [
      -      "CAP_TABLE_AGREEMENT_TYPE_UNSPECIFIED",
      -      "CAP_TABLE_AGREEMENT_TYPE_SAFE",
      -      "CAP_TABLE_AGREEMENT_TYPE_OPTION",
      -      "CAP_TABLE_AGREEMENT_TYPE_RSU",
      -      "CAP_TABLE_AGREEMENT_TYPE_RSA",
      -      "CAP_TABLE_AGREEMENT_TYPE_FAST",
      -      "CAP_TABLE_AGREEMENT_TYPE_BOARD_CONSENT",
      -      "CAP_TABLE_AGREEMENT_TYPE_CONVERTIBLE_LOAN",
      -      "CAP_TABLE_AGREEMENT_TYPE_VENTURE_DEBT",
      -      "CAP_TABLE_AGREEMENT_TYPE_OTHER"
      -    ],
      -    "type": "string"
      -  },
      -  "updatedAt": {
      -    "format": "date-time",
      -    "type": "string"
      -  },
      -  "valuationCap": {
      -    "type": "string"
      -  }
      -}
    • removedOutput schema / properties / agreement / type
      Removed value: -"object"
    • addedOutput schema / properties / signatureBlock / anyOf
      Added value: +[
      +  {
      +    "properties": {
      +      "companyAddress": {
      +        "type": "string"
      +      },
      +      "companyEmail": {
      +        "type": "string"
      +      },
      +      "companySignerName": {
      +        "type": "string"
      +      },
      +      "companySignerTitle": {
      +        "type": "string"
      +      },
      +      "investorAddress": {
      +        "type": "string"
      +      },
      +      "investorEmail": {
      +        "type": "string"
      +      },
      +      "investorTitle": {
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / properties / signatureBlock / properties
      Removed value: -{
      -  "companyAddress": {
      -    "type": "string"
      -  },
      -  "companyEmail": {
      -    "type": "string"
      -  },
      -  "companySignerName": {
      -    "type": "string"
      -  },
      -  "companySignerTitle": {
      -    "type": "string"
      -  },
      -  "investorAddress": {
      -    "type": "string"
      -  },
      -  "investorEmail": {
      -    "type": "string"
      -  },
      -  "investorTitle": {
      -    "type": "string"
      -  }
      -}
    • removedOutput schema / properties / signatureBlock / type
      Removed value: -"object"
  3. Changed1 schema field changed
    • addedOutput schema / properties / signatureBlock
      Added value: +{
      +  "properties": {
      +    "companyAddress": {
      +      "type": "string"
      +    },
      +    "companyEmail": {
      +      "type": "string"
      +    },
      +    "companySignerName": {
      +      "type": "string"
      +    },
      +    "companySignerTitle": {
      +      "type": "string"
      +    },
      +    "investorAddress": {
      +      "type": "string"
      +    },
      +    "investorEmail": {
      +      "type": "string"
      +    },
      +    "investorTitle": {
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
  4. First observed

TDQS

A4.2/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true and destructiveHint=false, so "Read-only" at the start of the description is redundant. The genuinely additive detail is that the response carries the agreement's terms plus exactly two printed signature blocks, which tells the agent what signing state data is available, but no other behavior (permissions, not-found handling, scope by company) is disclosed.

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 short sentences, front-loaded with the return value, then the use case, then the id-discovery hint. Each sentence carries distinct information and nothing repeats the name or title.

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?

With an output schema present, the description does not need to enumerate return fields, and it still summarizes the return shape well. The only meaningful gap is the unexplained optional companyId parameter, which matters given the nested UUID wrapper structure.

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%, but the coverage is hollow — both id and companyId are documented only as "UUID value wrapper." The description partly compensates by telling the agent where to get the id, yet it never explains what companyId is for or whether it is an optional scoping filter, leaving a nested-object parameter semantically unexplained.

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 gives a specific verb and resource ("Returns one equity agreement by id") and then enumerates the concrete kinds covered — SAFE, stock purchase agreement, grant — plus what is included (terms, two signature blocks). That is enough to distinguish it from cap_table_get_list_cap_table_agreements and the update/pdf siblings without opening either schema.

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 states the use case explicitly ("answer questions about a specific agreement's valuation cap, discount, amount or signing state") and names the prerequisite path for obtaining the id by listing a company's agreements first. Both when-to-use and the alternative discovery step are spelled out.

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.