Update Deal

by carta6ab81016389cNo license14 starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated today

Updates an existing deal record in the Carta CRM. Use this skill when the user says things like "update a deal", "move deal to [stage]", "change deal stage", "edit deal", "update deal fields", "add a tag to deal", "assign deal lead", "update company info on deal", "link contacts to deal", or "/update-deal". Accepts a deal ID or company name (will search if no ID provided). Only the fields explicitly provided are changed — all other fields are left untouched.

Instructions onlyBusiness & Finance
AI-generated overview

Partially updates an existing deal record in the Carta CRM, changing only the fields the user specifies.

What it does
This skill guides an agent through partially updating an existing deal in the Carta CRM. It resolves a deal ID from a direct ID or a company-name search, collects the fields to change (stage, company info, comment, tags, deal lead, custom fields, linked contacts), and calls the CRM update tool. Only the fields explicitly provided are modified; all other fields are left untouched. It then reports a summary of what changed, or an error with troubleshooting suggestions.
When to use it
Use it when a user asks to update a deal, move a deal to a stage, change a deal stage, edit deal fields, add a tag, assign a deal lead, update company info on a deal, or link contacts to a deal. It also applies when the user invokes the /update-deal command.
Requirements
Requires access to the Carta CRM MCP tool crm_call_tool and the underlying CRM tools (get_deal_fields, search_deals, get_deal_pipelines_with_stages, get_deal_custom_fields, update_deal). No scripts are shipped; instructions only.
<!-- carta:plugin-version -->

<carta-plugin>carta-crm:1.14.2</carta-plugin>

Overview

Partially update an existing deal. Only fields provided are modified — this is a partial update, not a replacement. First resolve the deal ID, collect what to change, then call the update tool.

Step 1 — Resolve the deal ID

If the user provided a deal ID directly, use it and skip to Step 3.

If only a company name was given, call get_deal_fields first, then search:

crm_call_tool({ "name": "crm:get_deal_fields", "arguments": {} })crm_call_tool({ "name": "crm:search_deals", "arguments": { query: "<company name>", limit: 10 } })

If multiple deals match, present the list and ask the user to confirm which one to update (show company name, stage, and ID for each).

Step 2 — Collect what to update

Ask the user what they want to change:

FieldDescription
stageIdMove deal to a different stage
company.nameUpdate the associated company name
company.urlUpdate company URL — triggers auto-enrichment
commentReplace the deal comment/notes
tagsReplace the full tags array
dealLeadUser ID to assign as deal lead
addedAtISO 8601 date the deal was added
fieldsCustom field values keyed by field ID
people.advisersContact IDs linked as advisers
people.introducerContact IDs linked as introducers
people.managementContact IDs linked as management

If the user wants to move to a stage by name, fetch pipelines first:

crm_call_tool({ "name": "crm:get_deal_pipelines_with_stages", "arguments": {} })

If updating custom fields by label rather than ID:

crm_call_tool({ "name": "crm:get_deal_custom_fields", "arguments": {} })

Important: Only include fields that are explicitly being changed. Omit everything else.

Step 3 — Update the deal

Call:

crm_call_tool({  "name": "crm:update_deal",  "arguments": {    id: "<deal id>",    stageId: "<stage id>",    company: { name: "<name>", url: "<url>" },    comment: "<updated comment>",    tags: ["<tag1>", "<tag2>"],    dealLead: "<user id>",    addedAt: "<ISO 8601 date>",    fields: { "<field_id>": "<value>" },    people: {      advisers: ["<contact id>"],      introducer: ["<contact id>"],      management: ["<contact id>"]    }  }})

Omit any top-level key that is not being updated.

Step 4 — Report result

On success, respond with a summary of what changed:

"Deal for {company name} updated (ID: {id}). Changed: [list of changed fields]"

On error, show the error message and suggest:

  • Verify the deal ID is correct — run /search-deals to find it
  • Check that stage IDs are valid — run get_deal_pipelines_with_stages
  • Check that custom field IDs and contact IDs are valid

Updating multiple deals

If the user wants to apply the same change to multiple deals, repeat Steps 1 and 3–4 for each. Summarize at the end:

"Updated N deals: [list of company names]"

Source and attribution

Source:carta/pluginsinplugins/carta-crm/skills/update-dealat commit6ab8101

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

More from carta/plugins

Carta Fund Admin Requests

carta

Send work to your Carta Fund Admin team and track it. Opens a request the team reads, acts on, and replies to — the off-ramp for anything no other Carta skill or command can do. TRIGGER: "ask Carta to", "have Carta do", "send this to my fund admin", "ask my fund admin team", "can Carta do this for me", "check on my request", "did Carta reply", "what requests do I have open", "reply to Carta", "follow up on my request", plus ANY action request (create/change/send/restate/reconcile/split/fix) that no other skill or Carta command covers. NOT FOR: reporting a bug or feature request about this plugin (call fa:create:feedback directly); questions answerable from Carta data (use carta-explore-data); capital call reminders to LPs (that is a Carta command, not a Fund Admin request).

Awaiting classification14updated today

Carta Explore Data

carta

Answers Carta Web / Fund Admin investor data questions by querying the Carta data warehouse and formatting results.

Data & Analytics14updated today

Carta Download Tearsheet

carta

Downloads Carta tear sheets for portfolio companies and funds via the Carta MCP server.

Documents & Office14updated today

Update Note

carta

Searches for notes in the Carta CRM and helps the user update deal comments. Use this skill when the user says things like "update a note", "edit note", "update note content", "change a note", or "/update-note". Note: standalone note editing is not available via MCP — notes/comments are attached to deals and updated via the update-deal skill.

Awaiting classification14updated today

Update Investor

carta

Partially updates an existing investor record in the Carta CRM by ID or name.

Business & Finance14updated today

Update Fundraising

carta

Updates an existing fundraising record in the Carta CRM. Use this skill when the user says things like "update a fundraising", "edit fundraising", "update fundraising details", "change fundraising stage", "update fundraising fields", or "/update-fundraising". Accepts a fundraising ID or name (will search if no ID provided). Only the fields explicitly provided are changed — all other fields are left untouched.

Awaiting classification14updated today