Introduction
Ledgy MCP is a connection that lets a compatible external AI tool - such as Claude, Cursor, or ChatGPT - read your Ledgy data in real time and, if your company allows it, make selected changes for you.
Ledgy MCP is an integration. Setting it up means configuring an external AI client and completing an authentication flow. In some organizations, connectors like MCPs require approval from IT or InfoSec teams before they can be connected. Ultimately, the user who completes the authentication flow will be the Ledgy user who wants to use the connection.
Looking for a simpler, no-setup way to ask questions about your equity data from inside Ledgy instead? Use Ledgy Agent.
Ledgy MCP is currently free to use while in Beta. As we develop its functionality, we may introduce a priced offering. Beta access now will not guarantee continued free access later. This is still beta functionality, so please report any feedback you have. Access to Ledgy MCP company-wide can only be enabled by Owners or Collaborators with the Manage AI settings permission. Ledgy MCP is not a source of legal or tax advice and AI output should be verified by an independent adviser before use.
Plan availability
Ledgy MCP is available to customers on the Scale plan and above.
What is MCP?
MCP stands for Model Context Protocol. It is an open standard that lets AI assistants connect directly to external services and query them in real time, instead of relying on information copied and pasted into a chat.
Ledgy MCP gives a compatible AI tool a live connection to your Ledgy data. Instead of exporting data or copying it manually, the AI tool can read from Ledgy directly and, if allowed, make changes - always within the limits of your existing Ledgy permissions.
Who should set this up
Since Ledgy MCP requires configuring an external AI client and completing an authentication flow, it may involve:
Your IT or InfoSec team, if your company requires approval before connecting external tools to company data
A technical or power user who is comfortable configuring AI tools such as Claude Desktop, Cursor, or ChatGPT
If you just want to ask questions about your equity data with no setup at all, use Ledgy Agent, the AI assistant built directly into Ledgy, instead.
What you can do with Ledgy MCP
Once connected, you can ask natural-language questions about your company's equity data from inside your AI tool. As the Ledgy MCP's capabilities evolve, simply ask “What can you help me with?” if you’re curious about its capabilities.
Read your data
Typical examples include:
Viewing your fully diluted cap table
Looking up the details of a specific transaction
Searching for transactions involving a particular investor or stakeholder
Reviewing current equity pools and option plans
Checking which signatures are still outstanding
Reviewing offboarding or leaver configurations
Running simple equity calculations such as dilution scenarios
Filtering stakeholders by their holdings, for example "Who owns more than 4% of the company?", "Who holds shares today?" or "Which stakeholders hold shares but have no outstanding grants?"
Searching data room documents by name or date
Looking up exercise requests
Looking up company valuations
All queries run with your existing Ledgy permissions. The AI tool only sees the data your Ledgy role is allowed to access.
Make changes
If your company admin has allowed Make changes in AI settings, and you switched on Make changes when connecting, your AI tool can also:
Create stakeholder profiles and edit existing ones, including their custom field values. This doesn't invite anyone to Ledgy or send any email.
Create and rename stakeholder custom fields
Create and edit transaction custom fields
Create share classes
Create vesting presets (templates for new grants; existing grants aren't changed)
At the moment, Ledgy MCP can't delete data, create or publish transactions, invite stakeholders, send signature requests, offboard stakeholders, or move money.
Approving changes: Ledgy tells your AI tool which actions only read data and which make changes, so the tool can decide when to ask you first. By default, the main AI tools ask you to approve every change before it's made. You can usually set your tool to ask every time or to approve changes automatically. This approval step comes from your AI tool, not from Ledgy, and each tool handles it differently, so check your tool's own settings.
What you need
A Ledgy subscription on the Scale plan or above
A Ledgy account with access to at least one company
A compatible AI tool that supports MCP
How to connect Ledgy MCP
All supported clients use the same Ledgy MCP endpoint:
https://app.ledgy.com/api/mcp
Claude Desktop
Open Settings > Connectors > Customize
Add a custom connector
Set the URL to
https://app.ledgy.com/api/mcpClick Connect and complete the Ledgy login flow
Depending on your Claude plan, a workspace admin may need to allow custom connectors first.
Cursor
Open Settings > Tools & MCPs and create a new MCP server, or open
mcp.jsonfrom the command paletteIf you are editing
mcp.json, add a server entry that points tohttps://app.ledgy.com/api/mcp
Return to Tools & MCPs and click Connect
ChatGPT
Open Settings > Apps
Create a new app
Set the URL to
https://app.ledgy.com/api/mcpComplete the Ledgy authentication flow
Claude Code
Register the server with
claude mcp add --transport http ledgy https://app.ledgy.com/api/mcpConfirm the configuration with
claude mcp get ledgyLaunch Claude Code and run
/mcpSelect ledgy, then authenticate in the browser
Finish the authorisation
After you start the connection from your AI tool, Ledgy opens a browser window for authentication.
Sign in with your Ledgy credentials if prompted.
Under Company this app can access, choose your company. Companies where MCP isn't turned on are greyed out with "MCP access isn't enabled. Turn it on in AI settings."
Under Through this connection [app] will be able to:, review the access. Reading data is always included.
Optional: to let the app make changes, switch on Make changes. The sentence at the top changes to "Authorize [app] to read and make changes to your Ledgy data". If the switch is greyed out, your company hasn't allowed changes from AI apps yet: a company admin needs to allow Make changes in AI settings first. If you can manage AI settings yourself, the screen instead shows "Go to AI settings to turn it on", with a link straight to the settings.
Check that the redirect address in the yellow box belongs to the app you're connecting.
Tick I trust this application and accept the Ledgy MCP Terms.
Click Continue.
Each connection is limited to one company. Your choice of read-only or Make changes is saved with the connection. To switch between them, or if you connected before your admin allowed Make changes, connect the app again.
Current limits and security notes
Changes only with permission - the app can make changes only if your admin allowed it and you switched it on when connecting. It can never do more than your Ledgy role allows
Permission-aware - the AI tool inherits your Ledgy access level
Every change is recorded - Ledgy's change logs show each change made through Ledgy MCP, with the person and the AI app that made it, for example "Jane Doe via Ledgy MCP (Claude)"
One company per connection - you choose the company during the login flow
Secure browser login - access is granted through an OAuth authentication flow, not a shared API key
Disconnect from the AI tool - if you want to remove access, remove Ledgy from your AI tool's MCP settings
Filters apply to a single date - questions like "Who owns more than X%?" are answered for one specific date (today, unless you name a date). Questions about how holdings changed over a period are answered without the filter, so they can take longer, and the results are worth double-checking
Supported and tested AI tools
Any MCP-compatible AI tool may work, but Ledgy has tested Ledgy MCP with:
Claude Code
Claude Desktop
Cursor
Codex
GPT / ChatGPT
Frequently asked questions
Can Ledgy MCP make changes in Ledgy?
Can Ledgy MCP make changes in Ledgy?
Yes, if your company admin has allowed it in AI settings and you switch on Make changes when you connect. See Make changes above for what it can and can't do.
Does the AI tool see all of my company data?
Does the AI tool see all of my company data?
No. Ledgy MCP follows your existing Ledgy permissions - it only returns data your role is allowed to see.
Do changes made through Ledgy MCP show up in the audit logs?
Do changes made through Ledgy MCP show up in the audit logs?
Yes. Every change made through Ledgy MCP is recorded, the same as a change made in the app. Each entry shows the person who connected the MCP and the AI tool they used, for example "Jane Doe via Ledgy MCP (Claude)". The name in brackets is the name the AI tool gives itself when it connects.
On all plans, you can see recent changes in the Latest changes list. On the Enterprise plan, admins and owners can also see the full history in the Audit Logs report, where the AI tool appears in the Agent column. See How do I view and use the Audit Logs report?
Questions and lookups don't change any data, so they don't create audit log entries.
Can I connect more than one company through one MCP authorization?
Can I connect more than one company through one MCP authorization?
No. Each connection is tied to one selected company.
How do I disconnect Ledgy MCP?
How do I disconnect Ledgy MCP?
Remove Ledgy from the MCP or app settings of the AI tool you connected.
My AI tool keeps showing an error when I reconnect. What should I do?
My AI tool keeps showing an error when I reconnect. What should I do?
Remove the Ledgy connection from your AI tool's MCP or app settings, then add it again with https://app.ledgy.com/api/mcp and finish the authorisation. If it still fails, contact Ledgy Support.
Is this the same as Ledgy Agent?
Is this the same as Ledgy Agent?
No. Ledgy Agent is the AI assistant built into Ledgy and needs no setup. Ledgy MCP is a technical integration that connects an external AI tool to your Ledgy data. See How does Ledgy Agent work?