Skip to main content

How does Ledgy MCP work (Beta)?

Learn what Ledgy MCP is, how to connect AI tools such as Claude, Cursor, and ChatGPT to it, and its current capabilities.

Written by Support Team

Introduction

Ledgy MCP (Beta) is a read-only connection that lets a compatible external AI tool - such as Claude, Cursor, or ChatGPT - query your Ledgy data directly, in real time.

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.

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, read-only connection to your Ledgy data. Instead of exporting data or copying it manually, the AI tool can read from Ledgy directly - 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 today

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.

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

All queries run with your existing Ledgy permissions. The AI tool only sees the data your Ledgy role is allowed to access.

What you need

  • 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

  1. Open Settings > Connectors > Customize

  2. Add a custom connector

  3. Set the URL to https://app.ledgy.com/api/mcp

  4. Click Connect and complete the Ledgy login flow

Depending on your Claude plan, a workspace admin may need to allow custom connectors first.

Cursor

  1. Open Settings > Tools & MCPs and create a new MCP server, or open mcp.json from the command palette

  2. If you are editing mcp.json, add a server entry that points to https://app.ledgy.com/api/mcp

  4. Return to Tools & MCPs and click Connect

ChatGPT

  1. Open Settings > Apps

  2. Create a new app

  3. Set the URL to https://app.ledgy.com/api/mcp

  4. Complete the Ledgy authentication flow

Claude Code

  1. Register the server with claude mcp add --transport http ledgy https://app.ledgy.com/api/mcp

  2. Confirm the configuration with claude mcp get ledgy

  3. Launch Claude Code and run /mcp

  4. Select 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.

  1. Sign in with your Ledgy credentials if prompted

  2. Select the company you want to connect

  3. Review the permissions

  4. Click Allow

Each connection is limited to one company at a time.

Current limits and security notes

  • Read-only - Ledgy MCP cannot create, edit, publish, or delete data in Ledgy today

  • Permission-aware - the AI tool inherits your Ledgy access level

  • 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

  • Beta feature - the available tool set may change as the beta evolves

Supported and tested AI tools

Any MCP-compatible AI tool may work, but Ledgy has explicitly tested the beta with:

  • Claude Code

  • Claude Desktop

  • Cursor

  • Codex

  • GPT / ChatGPT

Frequently asked questions

Can Ledgy MCP make changes in Ledgy?

No. Ledgy MCP is read-only in the current beta.

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.

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?

Remove Ledgy from the MCP or app settings of the AI tool you connected.

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?

Where should I send beta feedback?

Reach out to Ledgy Support or your Customer Success Manager.

Related articles

Related Articles
Did this answer your question?