Skip to main content
Overview

Carta CRM MCP


MCP Server URL: https://mcp.app.carta.com/mcp

Contact: [email protected]

Overview​

This documentation describes the Carta CRM MCP server, which provides read and write tools for managing contacts, companies, deals, fundraising opportunities, investors, fees, notes, tasks, investment committee meetings and requests, themes, reports, email campaigns, and more.

The server exposes 194 generally available tools — 109 read-only and 85 write. Tools are listed below by domain. Whether an individual tool returns data still depends on the modules your organization has enabled and on your own permissions.

A further 21 Discovery catalogue tools — 19 read-only and 2 write — appear only when LP Discovery is enabled for your organization. They are listed separately under Discovery catalogue tools.

Read-only tools​

Contacts​

  • search_contacts — Search CRM contacts by free-text query, list/folder, and structured filters (current company, titles, tags, city/country, date added, interaction frequency goal, relationship status).
  • fetch_contact_by_id — Return one contact by ID, with the deals and notes it is related to, including interaction frequency goal and derived relationship status.
  • get_contact_interactions — List email and calendar interactions with a single contact by CRM ID.
  • aggregate_contacts_added — Count contacts by when they were added to the CRM and by whom, per user or per day, month, quarter or year.
  • find_contact_duplicates — Find suspected duplicate contacts, grouped by match type (email, LinkedIn, name).
  • get_contact_lists — Return the full contact list and folder hierarchy.
  • get_contact_fields — Return all contact fields — standard and custom — with IDs and types.
  • get_contact_custom_fields — Return custom field definitions for contacts.
  • get_contact_tags_classifier_prompt — Return the organization's contact-tags classifier prompt.

People discovery (external)​

  • search_people — Search the public internet (LinkedIn) for people not yet in the CRM.
  • enrich_person — Retrieve public profile details (name, title, emails, jobs, tags, location) for one person by LinkedIn URL.

Companies​

  • search_companies — Search companies by structured filters plus a free-text query.
  • fetch_company_by_id — Return one company by CRM ID.
  • fetch_company_by_domain — Return one company by web domain.
  • find_company — Look up companies by name; returns matches with name, domain, and source.
  • preview_company — Return a company profile by domain.
  • aggregate_companies — Group and count companies by field values.
  • get_company_lists — Return all company lists.
  • get_company_list_data — Read the companies on one company list, with the fields that list is configured to show.
  • get_company_fields — Return all company fields — standard and custom — with IDs and types.
  • get_company_custom_fields — Return custom field definitions for companies.
  • get_company_interactions — List email and calendar interactions with contacts at a company.
  • get_company_relations — List aggregated relationships (one row per unique participant) at a company.

Deals​

  • search_deals — Search deals by structured filters, stage, free-text query, and date range.
  • fetch_deal_by_deal_id — Return one deal in full detail, including related notes and people.
  • aggregate_deals — Group and count deals by field values.
  • get_deal_pipelines_with_stages — Return all deal pipelines with their stages.
  • get_deal_fields — Return all deal fields — standard and custom — with IDs and types.
  • get_deal_custom_fields — Return custom field definitions for deals.
  • get_deal_stage_history — Return timestamped stage transitions for a deal.
  • list_deal_stage_changes — List recorded stage changes across deals, newest first, with who moved each deal and when.
  • get_deal_interactions — List email and calendar interactions for the company on a deal.
  • get_deal_relations — List aggregated relationships for the company on a deal.

Fundraising​

  • search_fundraising — Search and list fundraising opportunities, newest first.
  • get_fundraising — Return one fundraising opportunity by ID.
  • get_fundraising_stage_history — Return timestamped stage transitions for a fundraising opportunity.
  • aggregate_fundraising — Group and count fundraising opportunities by field values.
  • aggregate_fundraising_stage_history — Group and count fundraising stage transitions, for funnels and stage movement over time.
  • get_fundraising_stages — Return all fundraising stages and their valid stageId values.
  • get_fundraising_fields — Return all fundraising fields — standard and custom — with IDs and types.
  • get_fundraising_custom_fields — Return custom field definitions for fundraising.
  • get_fundraising_interactions — List email and calendar interactions for a fundraising opportunity.
  • get_fundraising_relations — List aggregated relationships for a fundraising opportunity.

Investors​

  • search_investors — Search and list investors.
  • get_investor — Return one investor by ID.
  • aggregate_investors — Group and count investors by field values.
  • get_investor_fields — Return all investor fields — standard and custom — with IDs and types.
  • get_investor_custom_fields — Return custom field definitions for investors.
  • get_investor_interactions — List email and calendar interactions for an investor.
  • get_investor_relations — List aggregated relationships for an investor.
  • get_investor_fund_admin_emails — List fund-admin emails sent to an investor (capital calls, distribution notices, document shares).
  • get_investor_fund_admin_email_content — Return the rendered subject and body of one fund-admin email.

Fees​

  • search_fees — Search and list fees charged in the course of a deal.
  • get_fee — Return one fee by ID.
  • aggregate_fees — Group and count fees by field values.
  • get_fee_fields — Return all fee fields — standard and custom — with IDs and types.
  • get_fee_custom_fields — Return custom field definitions for fees.
  • get_fees_by_deal — List every fee linked to a deal, with the total across them.
  • get_fees_by_contact — List every fee linked to a contact, with the total across them.

Notes​

  • search_notes — Search notes by string; omit the query to return all notes.
  • fetch_note_by_id — Return one note by ID — title, text, folder, owner, timestamps.
  • get_note_folders — Return all note folders for the organization.
  • get_note_fields — Return all note fields with their IDs, types, and the operators each takes.
  • list_linked_notes — List notes linked directly to a contact, deal, investor, fundraising opportunity, company, or calendar event.
  • list_notes_by_domain — List all notes related to a company domain, aggregated across the company and its contacts.

Tasks​

  • search_tasks — Search tasks assigned to the current user, optionally filtered by completion state and entity type.
  • list_tasks_by_entity — List tasks attached to a deal, note, contact, or fundraising opportunity.
  • fetch_task_by_id — Return one task by ID — title, comment, due date, assignees, completion state.
  • aggregate_tasks — Count tasks, the companies they belong to and the records of each type (deals, contacts, …) by status (open, overdue, closed), for the current user or, for organization admins, the whole organization.

Investment committee​

  • get_ic_meeting_fields — Return every IC meeting field — standard and organization-configured — with IDs, labels, types, and dropdown options.
  • search_ic_meetings — Search IC meetings, newest first, with each meeting's derived stage and the number of requests on its agenda.
  • fetch_ic_meeting_by_id — Return one IC meeting by ID, with its field values and derived stage.
  • list_ic_meeting_requests — List the IC requests on a meeting's agenda, in agenda order.
  • get_ic_request_fields — Return every IC request field — standard and organization-configured — with IDs, labels, types, and dropdown options.
  • search_ic_requests — Search IC requests, newest first, across all meetings including unscheduled requests, or on one meeting's agenda.
  • fetch_ic_request_by_id — Return one IC request by ID, with its field values and the meeting it is scheduled on, if any.
  • get_ic_request_votes — Return an IC request's vote sheet: each voting member's position and who recorded it, outstanding votes, totals, the allowed positions, and whether the votes are confirmed and what they decided.

Themes​

  • search_themes — Search themes by name.
  • get_theme_items — List the entities linked to a theme, optionally filtered by folder.
  • get_theme_folders — List a theme's folders, grouped by entity type (contact, company, deal, note, tag).

Relationship intelligence and interactions​

  • get_adviser_profile — Single-call relationship summary for a bank, adviser, or external company: top contacts by interaction volume, active deals, next meeting, recent notes.
  • fetch_contact_interactions_by_emails — Return the caller's past and upcoming interactions with contacts, looked up by email address.
  • list_interactions_by_domain — List email and calendar interactions with contacts at a given domain.
  • list_calendar_events — List organization-wide calendar events in a date window, deduplicated across teammates on the same event.
  • list_upcoming_meetings — List the meetings in the next few days, soonest first, for the whole organization or only the caller, with internal and external attendees and, for each external attendee, the saved contact name, the company that owns the email domain and that company's tier.
  • get_records_key_contact_last_interaction — For up to 500 investor, fundraising or deal records in one call, return the newest email or meeting across the contacts tagged as key contacts on each record, with the key contact it was with and the days since.
  • get_company_angles — Return who in the caller's network can introduce them to employees at a target company, via shared-employer paths.
  • aggregate_interactions — Count emails or calendar meetings per day, week, month, quarter or year (emails also sent vs received), from the CRM's stored copy of synced mailboxes and calendars: the caller's own, or with scope: "organization" the team's total over every non-blocked user, where an email or meeting several teammates hold counts once (a Gmail copy and an Outlook copy of one email count twice). type: "EVENT" counts external, non-declined meetings by start time. group_by: "user" (with scope: "organization") returns one count per teammate with display names only, from each teammate's own mailbox or calendar, so an email between two teammates counts for both and the counts can add up to more than the team total. Adding group_by_granularity returns periods and one series of counts per teammate, one count per period with 0 for an empty one, ready for a stacked or grouped chart; a request whose periods times teammates exceed 10,000 is rejected.

Two more read-only tools, list_my_emails and get_my_email_by_id, read the caller's own emails and appear only when your organization has turned on email body reading.

Reports​

  • list_reports — List saved reports for an entity type (contact, deal, fundraising, investor, company, fees).
  • get_report — Return one saved report by ID, with its columns, filters, grid configuration, and URL.
  • get_report_data — Run a report by ID and return the matching rows plus a total count.
  • get_report_schedule — Return the caller's recurring email schedule for a deal report.
  • list_custom_columns — List the custom columns a user added to a saved report or list grid, with their ids, labels, types and options.

Email campaigns​

  • list_email_campaigns — List the organization's email campaigns, newest first, optionally filtered by status.
  • get_email_campaign — Return one email campaign by ID, including its current HTML.
  • list_email_campaign_variables — List the merge tags available in campaign HTML — standard recipient variables plus eligible contact custom fields.

Files and attachments​

  • get_file_content — Download an attached file and return its text content (Office documents, PDFs, and plain text).

Fund administration​

  • get_fund_closings_status — Return closings readiness and the ledger URL for a batch of Carta funds.
  • get_fund_closing_prospect_statuses — Return per-prospect subscription progress for one fund: contact state, KYC status, risk rating, commitment amounts.

Organization and platform​

  • get_current_user — Return the user and tenant the session is operating as.
  • list_organization_users — List every user in the organization — id, email, display name, role, status.
  • list_organization_teams — List every team in the organization — id, name, description, member count.
  • list_user_integrations — For each user in the organization, whether email and calendar sync and contact push are connected. Admins only.
  • search_help — Search the Carta CRM help topics by keyword; an empty query lists every topic.
  • read_help_topic — Return one Carta CRM help topic as markdown, by the id search_help returned.
  • get_tenant_custom_instructions — Return the tenant-wide and personal agent instructions configured for this CRM.
  • get_user_notification_settings — Return the caller's email notification settings — master switch and per-type toggles.
  • objects_count — Count all objects across the tenant: contacts, deals, fundraisings, investors, notes.
  • contact_count — Count the contacts in a single list or saved contact report.

Write tools​

Contacts​

  • create_contact — Create a contact, optionally adding it to a list, including the interaction frequency goal.
  • bulk_update_contact_tags — Add, remove or replace tags on up to 2,000 contacts, from one list or a set of contact IDs. Previews by default; writes only with dryRun: false and confirm: true.
  • update_contact — Update an existing contact by ID, including the interaction frequency goal; only supplied fields change.
  • delete_contact — Delete a contact by ID.
  • enrich_contact — Run the enrichment check against one existing contact on demand.
  • enrich_contacts_bulk — Run enrichment for a batch of contacts in one call.
  • add_contact_to_list — Add an existing contact to a list; existing list memberships are kept.
  • create_contact_list — Create a contact list at the root of the workspace.
  • update_contact_list — Rename a list, move it into a folder, or change its access permission.
  • delete_contact_list — Delete a contact list. Contacts in the list are deleted with it.
  • create_contact_folder — Create a folder for organizing contact lists.
  • update_contact_folder — Rename a folder, nest it inside another, or change its access permission.
  • delete_contact_folder — Delete a folder; its lists and sub-folders move to the root.
  • update_contact_tags_classifier_prompt — Set or reset the organization's contact-tags classifier prompt.

Companies​

  • create_company — Create a company.
  • update_company — Update an existing company by ID; only supplied fields change.
  • delete_company — Delete a company by ID.

Deals​

  • create_deal — Create a deal; pipeline and stage default to the organization's defaults.
  • update_deal — Update an existing deal by ID; only supplied fields change.
  • delete_deal — Delete a deal by ID.
  • update_deal_stage — Rename a deal stage or change its flags.
  • reorder_deal_stage — Move a deal stage to a different position in its pipeline.

Fundraising​

  • create_fundraising — Create a fundraising opportunity; stage defaults to the first stage.
  • update_fundraising — Update an existing fundraising opportunity by ID.
  • delete_fundraising — Delete a fundraising opportunity by ID.
  • update_fundraising_stage — Rename a fundraising stage or toggle its kanban visibility.
  • reorder_fundraising_stage — Move a fundraising stage to a different position.
  • initiate_fundraising_closing — Initiate — or return the existing — Fund Admin closing for the linked fund.
  • send_fundraising_subscription_docs — Send subscription documents to a prospective investor on the linked fund.
  • send_fundraising_data_room_invite — Invite a prospective investor to the linked fund's data room. Reuses the prospect staged for subscription docs, or takes a complete new prospect when none is staged.

Investors​

  • create_investor — Create an investor.
  • update_investor — Update an existing investor by ID; only supplied fields change.
  • delete_investor — Delete an investor by ID.

Fees​

  • create_fee — Create a fee.
  • update_fee — Update an existing fee by ID; only supplied values change.
  • delete_fee — Delete a fee by ID; the record moves to the organization's trash.

Notes​

  • create_note — Create a note, optionally placing it in a folder.
  • update_note — Update an existing note by ID; only supplied fields change.
  • delete_note — Delete a note by ID.
  • link_note — Link a note to a contact, deal, investor, fundraising opportunity, company, or calendar event.
  • unlink_note — Remove the association between a note and an entity.

Tasks​

  • create_task — Create a task attached to a deal, note, contact, or fundraising opportunity.
  • update_task — Update an existing task by ID; only supplied fields change.
  • delete_task — Delete a task by ID.

Investment committee​

  • create_ic_meeting — Create an IC meeting. Its name is the UTC date and time of its meeting date, and its stage from the meeting date and agenda decisions.
  • update_ic_meeting — Update an existing IC meeting by ID; only supplied field values change. A meetingDate in the meeting's stored UTC minute, or at UTC midnight of its stored UTC day (a bare date included), keeps the stored date and time.
  • delete_ic_meeting — Delete an IC meeting by ID. A meeting with requests on its agenda needs agenda set to delete or unschedule; a meeting whose agenda carries a decision cannot be deleted.
  • create_ic_request — Create an IC request, optionally placing it on a meeting's agenda. Decision group fields are IC secretary only (see below).
  • update_ic_request — Update an existing IC request by ID, or move it onto another meeting's agenda or off its agenda. Decision group fields are IC secretary only (see below).
  • delete_ic_request — Delete an IC request by ID; the meeting it was on is left unchanged.
  • record_ic_vote — Record one voting member's vote on an IC request, replacing any vote already recorded for them. IC secretary only; confirmed votes cannot change.
  • clear_ic_vote — Clear one voting member's recorded vote on an IC request, so they count as outstanding again. IC secretary only; confirmed votes cannot change.
  • confirm_ic_votes — Confirm an IC request's votes: lock its vote sheet and decide the request — approved when more vote for than against, declined otherwise. The outcome is written into IC Decision when that field is unset and offers the option; a set value is never overwritten. IC secretary only; needs at least one vote.
  • reopen_ic_votes — Reopen an IC request's confirmed votes so they can change again; its decision goes back to pending, and an IC Decision holding the outcome the confirmed votes wrote is cleared. IC secretary only.

Only an IC secretary or Carta staff can set or change a field in a request's Decision group: the IC Decision dropdown, Signed IC Resolution and any field the organization adds to that group. This holds for create_ic_request and update_ic_request, the public API and the app; anyone else gets IC_DECISION_GROUP_FORBIDDEN. A value equal to the field's default counts as unset.

Themes​

  • create_theme — Create a theme, or return the existing one if the name is taken.
  • create_theme_item — Link an entity to a theme.
  • delete_theme_item — Remove an entity link from a theme and clear the theme mention on the entity.
  • add_subtheme — Make an existing theme a subtheme of another theme.
  • remove_subtheme — Remove a subtheme link from a parent theme.

Reports​

  • create_report — Create a saved report with filters, group-by, and columns.
  • update_report — Update a saved report's name, filters, group-by, pipeline scope, or columns.
  • create_custom_column — Add a custom column to a saved report or list grid: text anywhere, grouping on a list when list groups are enabled. Only a report's owner or an org admin can add one to a report.
  • delete_report — Permanently delete a saved report; owner or admin only.
  • update_custom_column — Rename a custom column of a report or list grid and, for a grouping column, set its options; options left out are deleted and their values cleared.
  • delete_custom_column — Permanently delete a custom column and the value it holds on every row; report owner or admin only for a report's column.
  • create_report_schedule — Schedule a deal report to be emailed on a recurring basis.
  • update_report_schedule — Update the recurrence rule, recipients, or active flag on a report schedule.
  • set_custom_column_values — Fill a custom column's cells for many rows of a report or list at once, reporting each row as written or not found.
  • delete_report_schedule — Remove the caller's recurring schedule for a deal report.

Email campaigns​

  • create_email_campaign — Create a draft email campaign. Creating does not send it.
  • update_email_campaign — Update a draft or failed campaign; a sent campaign may only be renamed.
  • delete_email_campaign — Delete a campaign of any status; already-delivered emails are unaffected.

Files and attachments​

  • get_signed_upload_url — Return a presigned S3 upload URL plus a file_id for the two-step upload-then-attach flow.
  • attach_file_to_entity — Attach an uploaded file to a deal, investor, company, fundraising opportunity, or note.
  • delete_file_from_entity — Remove an attached file from an entity and delete it from storage.
  • generate_pdf_from_html — Render an HTML document to PDF and return a short-lived signed download URL.
  • generate_csv_from_entities — Export investors, fundraisings, deals, contacts, or companies to CSV and return a signed download URL.

Custom fields​

  • create_custom_field — Add a custom field to a supported entity schema.
  • update_custom_field — Partially update an existing custom field.
  • reorder_custom_field — Change a field's position in an entity's field list.
  • delete_custom_field — Delete a custom field from an entity schema.
  • link_entity_fields — Link a source field to a field of another entity so the target mirrors its value and becomes read-only. Admin-only.
  • unlink_entity_fields — Remove the link a source field declares; the target becomes editable and keeps its values. Admin-only.

A field's groupInSearch designates the one field per schema whose value groups the results of an entity-linking search. Only fundraising opportunities render those groups today — every other entity accepts the flag and ignores it, so setting it there saves and changes nothing.

Organization and platform​

  • update_user_notification_settings — Change the caller's email notification settings — master switch and per-type toggles.
  • product_support_hotline — Send a bug report, feature request, data issue, or other feedback to the CRM product team.

Discovery catalogue tools​

The Discovery tools read Carta's shared catalogue of LPs, GPs and funds. It is reference data, not your organization's own records, and the tools appear only when LP Discovery is enabled for your organization.

The same data is available over REST. See the Discovery catalogue guide for the endpoints.

Read-only​

  • search_lp_catalogue — Search the LP catalogue by name, type, region, headquarters country and assets under management.
  • get_lp_catalogue_facets — List the LP types, regions and headquarters countries present in the catalogue, with counts.
  • get_lp_catalogue_fields — List the LP catalogue's fields, with their types, that can be grouped, filtered or measured.
  • aggregate_lp_catalogue — Count catalogue LPs grouped by a field such as type, region, headquarters country or data source, optionally with the sum, average, minimum or maximum of assets under management.
  • get_lp_capital_map — Return where institutional LP capital is concentrated, by LP type and region.
  • get_lp_from_catalogue — Fetch one LP profile from the catalogue by id.
  • get_lp_allocations — List the GPs one catalogue LP invests with, or, given a GP, the LP's commitment panel for it with committed, contributed, distributed and NAV figures.
  • search_gp_catalogue — Search the GP catalogue by name, strategy, region, headquarters country, assets under management, founding year, fund count and LP backer count.
  • get_gp_catalogue_fields — List the GP catalogue's fields, with their types, that can be grouped, filtered or measured.
  • aggregate_gp_catalogue — Count catalogue GPs grouped by a field such as strategy, region, headquarters country or founding year, optionally with the sum, average, minimum or maximum of a number field such as AUM.
  • get_gp_from_catalogue — Fetch one GP from the catalogue by id, with its funds and backing LPs.
  • get_gp_peers — List the GPs most similar to one GP, and the GPs that list it as a peer. Requires Discovery Phase 4.
  • search_fund_catalogue — Search the fund catalogue by free text, GP, vintage, strategy, GP location, median IRR, median TVPI and LP count.
  • get_fund_catalogue_fields — List the fund catalogue's fields, with their types, that can be grouped, filtered or measured.
  • aggregate_fund_catalogue — Count catalogue funds grouped by a field such as vintage, strategy, GP or region, optionally with the sum, average, minimum or maximum of a number field.
  • get_fund_benchmarks — IRR percentiles (p25, median, p75, p90) by vintage year over each fund's median LP-reported IRR, optionally for one strategy (growth, credit, buyout and the rest) and a vintage range.
  • get_fund_from_catalogue — Fetch one fund from the catalogue by id, with its managing GP and per-LP data points.
  • get_lp_commitment_fields — List the fields of the catalogue's LP→fund commitments, with their types, that can be grouped, filtered or measured.
  • aggregate_lp_commitments — Total the catalogue's LP→fund commitments grouped by a field such as LP type, LP region, GP, fund or vintage, with the sum, average, minimum or maximum of a USD amount, IRR or TVPI and the number of commitment records behind each total.

Write​

  • add_lp_to_investors — Copy an LP from the catalogue into your Investors module.
  • add_lp_to_fundraising — Copy an LP from the catalogue into your Fundraising pipeline at the first stage.