How to integrate Carta MCP with Hermes

Connect Hermes to Carta MCP. Review carta cap table ownership changes, list outstanding equity grants by employee, and more using natural language, with authentication handled for you.

Carta logoCarta
Oauth2S2s Oauth2

Carta is an equity management platform for cap tables, compensation, portfolios, and fund administration. It helps companies and investors manage ownership data and financial operations in one place.

83 Tools

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Carta account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Carta with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,700+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Carta with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Carta

Ask your agent to connect to Carta, or simply request any Carta-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Carta connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Carta or request any Carta-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Carta MCP server, and what's possible with it?

The Carta MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Carta account. It provides structured and secure access to your equity, capitalization, compensation, portfolio, and fund administration data, so your agent can retrieve cap tables, review equity positions, manage grants and transactions, and handle investor operations on your behalf.

  • Cap table and equity visibility: Have your agent retrieve issuer and investor capitalization tables, stakeholder equity summaries, certificates, option grants, restricted stock awards, restricted stock units, convertible notes, and stock split changes.
  • Equity grant and transaction management: Direct your agent to create or review draft option grants, create and finalize secondary transactions, and retrieve issuer stakeholders and related equity records.
  • Compensation benchmarking: Let the agent retrieve valid compensation benchmark attributes and list compensation benchmarks for your corporation's Carta Total Compensation plan.
  • Fund administration tasks: Instruct your agent to create, adjust, and review investor capital calls, record management fees and carried interest allocations, and retrieve saved waterfall results.
  • Portfolio investment records: Have your agent retrieve portfolio holdings, fair market values, investment documents, and portfolio-level certificates, notes, grants, and equity awards.

Way Forward

With Carta connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

Every Carta action and event your agent gets out of the box.

Adjust Investor Capital Call

Changes a capital call's total amount and reallocates it across interests while retaining the capital call ID.

Create Draft Issuer

Create a draft version of an issuer in Carta Launch.

Create Investor Capital Call

Create a capital call and allocate its fund-level amount across selected interests, or every interest when interest_ids is empty.

Create Investor Carried Interest Allocation

Books externally calculated carried-interest changes as a manual allocation.

Create Investor Management Fee

Book an externally calculated limited-partner management fee and post its journal.

Create Issuer Draft Option Grant

Create a draft option grant in an issuer's draft option grant set.

Create Issuer Secondary Transaction

Create a secondary transaction on an issuer's capitalization table with the supplied external reference, right-of-first-refusal decision, buyer, price, and securities.

Download Portfolio Fund Investment Document

Download a portfolio fund investment document from Carta's temporary URL and return it as a stored file reference with its metadata and expiration.

Finalize Issuer Secondary Transaction

Irreversibly finalize an existing issuer secondary transaction for settlement.

Get Compensation Benchmark Attributes

Retrieve valid compensation benchmark attributes for a corporation's Carta Total Compensation plan.

Get Current User

Retrieve the Carta user associated with the access token that authorized the request.

Get Draft Issuer

Retrieve a draft issuer from Carta Launch by identifier.

Get Investor Capital Call

Retrieves a capital call, including its status and allocation across the fund's interests.

Get Investor Capitalization Table

Retrieve one capitalization table for a company investment within a specified investor firm and fund, optionally as of a date.

Get Investor Management Fee

Retrieves a management fee booked through Create Investor Management Fee, including the current state of its journal.

Get Investor Stakeholder Capitalization Table

Retrieve one page of stakeholder-group capitalization data for a company investment within a specified investor firm and fund, optionally as of a date.

Get Investor Waterfall Result

Retrieve one saved waterfall result for a Carta investment firm by result ID.

Get Issuer

Retrieve one issuer accessible to the connected account by issuer ID.

Get Issuer Capitalization Table

Retrieve an issuer's capitalization table by share class.

Get Issuer Certificate

Retrieve one certificate belonging to the specified issuer by certificate ID.

Get Issuer Convertible Note

Retrieve one convertible note belonging to the specified issuer by note ID.

Get Issuer Draft Option Grant

Retrieve a draft option grant from an issuer's draft option grant set.

Get Issuer Option Grant

Retrieve one option grant issued by the specified issuer by grant ID.

Get Issuer Restricted Stock Award

Retrieve one restricted stock award issued by the specified issuer by award ID.

Get Issuer Restricted Stock Unit

Retrieve one restricted stock unit issued by the specified issuer by unit ID.

Get Issuer Secondary Transaction

Retrieve a secondary transaction from an issuer's capitalization table.

Get Issuer Stakeholder

Retrieve one stakeholder belonging to the specified issuer by stakeholder ID.

Get Issuer Stakeholder Capitalization Table

Retrieve one page of an issuer's capitalization table grouped by stakeholder, optionally as of a date.

Get Issuer Stakeholder Equity Summary

Retrieves a summary of a stakeholder's equity positions — certificates, option grants (ISO and NSO), restricted stock awards, and restricted stock units — at a given issuer.

Get Issuer Stock Split Asset Changes

For a set of securities and a reference time, report stock-split-driven changes.

Get Open Cap Table

Get the processing record for a previously uploaded OCF package.

Get Portfolio

Retrieve a shareholder portfolio by identifier.

Get Portfolio Issuer Certificate

Retrieve one certificate for the specified issuer within the specified portfolio by certificate ID.

Get Portfolio Issuer Convertible Note

Retrieve one convertible note for the specified issuer within the specified portfolio by note ID.

Get Portfolio Issuer Fair Market Value

Retrieve the current fair market value of an issuer in a portfolio.

Get Portfolio Issuer Option Grant

Retrieve one option grant for the specified issuer within the specified portfolio by grant ID.

Get Portfolio Issuer Restricted Stock Award

Retrieve one restricted stock award for the specified issuer within the specified portfolio by award ID.

Get Portfolio Issuer Restricted Stock Unit

Retrieve one restricted stock unit for the specified issuer within the specified portfolio by unit ID.

List Compensation Benchmarks

Retrieve one page of compensation benchmarks for a corporation's Carta Total Compensation plan.

List Corporations

Retrieve one page of corporations that the connected Carta user can access.

List Investor Capitalization Tables

Retrieves the capitalization tables for a given firm, fund, and investment company.

List Investor Cash Balances

Retrieves one page of cash balances for a firm and fund.

List Investor Certificates

Retrieve certificates issued by an investment company to a fund within a firm.

List Investor Convertible Notes

Retrieve convertible notes and SAFEs issued by an investment company to a fund within a firm.

List Investor Firm Performance Metrics

Retrieve one page of performance metrics aggregated across selected funds in a Carta firm.

List Investor Firms

Retrieve one page of investment firms available to the connected Carta account.

List Investor Fund Interests

Retrieves one page of partner interests in a fund.

List Investor Fund Performance Metrics

Retrieve one page of Carta fund performance metrics, optionally grouped by fund, partner type, or partner.

List Investor Funds

Retrieve one page of investment funds belonging to a Carta investment firm.

List Investor Investments

Retrieve one page of portfolio-company investments held by a Carta fund.

List Investor Partner Contacts

Retrieve one page of contacts associated with partners across a Carta firm's funds.

List Investor Partners

Retrieve one page of LPs, GPs, and other partners across a Carta firm's funds.

List Investor Warrants

Retrieve investment warrants issued by an investment company to a fund within a firm.

List Investor Waterfall Holdings

List feeder-fund holdings from saved waterfall results, including value, ownership, invested capital, and MOIC.

List Investor Waterfall Results

List a firm's saved waterfall-modeling results, newest waterfall date first; unsaved runs and finalized portfolio valuations are excluded.

List Investor Waterfall Targets

List deal structures and companies a Carta investment firm can run waterfalls on, including each target's stable ID and feeder funds.

List Issuer Certificates

List one page of certificates belonging to the specified issuer, optionally filtered by last-modified time range.

List Issuer Convertible Notes

List one page of convertible notes belonging to the specified issuer.

List Issuer Fair Market Values

Retrieve the fair market values of an issuer, which are the values of the issuer's securities as determined by the issuer's 409a valuations.

List Issuer Interests

List one page of interests issued by the specified issuer, optionally as of a date.

List Issuer Option Exercises

Retrieve one page of option exercises issued by an issuer.

List Issuer Option Grants

List one page of option grants issued by the specified issuer, optionally filtered by last-modified time range.

List Issuer Points Of Contact

List the specified issuer's points of contact in a single response.

List Issuer Restricted Stock Awards

List one page of restricted stock awards issued by the specified issuer, optionally filtered by last-modified time range.

List Issuer Restricted Stock Units

List one page of restricted stock units issued by the specified issuer, optionally filtered by last-modified time range.

List Issuers

List one page of issuers accessible to the connected account.

List Issuer Share Classes

List one page of share classes issued by the specified issuer, optionally as of a date.

List Issuer Stakeholders

List one page of stakeholders belonging to the specified issuer.

List Issuer Transactions

List one page of transaction history for the specified issuer's securities, filtered by the required security type.

List Issuer Vesting Schedule Templates

List one page of vesting schedule templates belonging to the specified issuer.

List Portfolio Fund Investment Documents

Retrieve one page of fund investment documents for a portfolio.

List Portfolio Issuer Certificates

List one page of certificates for the specified issuer within the specified portfolio, optionally filtered by last-modified time range.

List Portfolio Issuer Convertible Notes

List one page of convertible notes for the specified issuer within the specified portfolio.

List Portfolio Issuer Option Grants

List one page of option grants for the specified issuer within the specified portfolio, optionally filtered by last-modified time range.

List Portfolio Issuer Restricted Stock Awards

List one page of restricted stock awards for the specified issuer within the specified portfolio, optionally filtered by last-modified time range.

List Portfolio Issuer Restricted Stock Units

List one page of restricted stock units for the specified issuer within the specified portfolio, optionally filtered by last-modified time range.

List Portfolio Issuers

Retrieve one page of issuers in a shareholder portfolio.

List Portfolio Issuer Security Transactions

List one page of security transactions for the specified issuer within the specified portfolio.

List Portfolios

Retrieve one page of shareholder portfolios.

Update Issuer Money Movement

Update money movement information for an issuer option exercise.

Update Issuer Tax Withholding

Update tax withholding information for an issuer option exercise.

Upload File

Synchronously upload a generic file to Carta as a base64-encoded JSON payload.

Upload Open Cap Table

Upload an Open Cap Table Format package in binary form for Carta to process.

FAQ

Frequently asked questions

With a standalone Carta MCP server, the agents and LLMs can only access a fixed set of Carta tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Carta and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Carta tools.

Yes, absolutely. You can configure which Carta scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Carta data and credentials are handled as safely as possible.

Start with Carta.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Carta tool your agent needs.Free to start.

Start building