Carta MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Carta MCP or direct API to review cap tables, track equity grants, analyze compensation, and manage fund data through natural language.

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

Try Carta now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Carta
Try asking
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.

SETUP GUIDE

Connect Carta MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["carta"],
  mcp: true,
});
Create a session scoped to Carta and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List the stakeholders in my Carta cap table",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Carta request
SETUP GUIDE

Connect Carta API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["carta"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Carta
3

Run Carta tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List the stakeholders in my Carta cap table" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Carta tool calls through the session, and print the final answer

Why Use Composio?

AI Native Carta Integration

  • Supports both Carta MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Carta data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Carta access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Carta
  • Scoped, least privilege access to Carta resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Carta requires connections to go through your own OAuth app. You register it once with Carta, add its client ID and secret in the Composio dashboard, and from then on everyone connects by signing in to Carta as usual. Composio handles the rest of the flow and the token refresh.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Yes. Composio is SOC 2 Type II compliant and is built to keep your Carta connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

When you connect a Carta account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in Carta as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Exactly the ones Carta lists on its consent screen when you connect. Review that screen before approving. If you connect a work account, your Carta administrator may need to approve the app first, and you can revoke the access inside Carta whenever you want.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each Carta connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

Composio refreshes Carta tokens automatically, so day to day you do nothing. If you revoke access inside Carta, or Carta invalidates the session, the connection shows as expired in Composio and the agent stops acting on that account until you reconnect it, which is a single sign-in.

Composio's free Hobby plan includes 100,000 tool calls per month with no credit card, which covers most personal Carta use. Paid plans add higher limits and team features. Your Carta plan and its API limits still apply as usual.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple Carta accounts).

With Composio, you connect Carta once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with Carta.It takes 30 seconds.

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

Start building