Manage opportunity records
Retrieve, update, create, and delete opportunity records and related CRM data from an MCP client using plain language.
Before you begin
Role required: admin
About this task
All changes go through the same server-side business rules, validation scripts, and access controls that apply on the standard form. Every create, update, or delete action requires explicit confirmation before the agent commits.
Procedure
Connect through your MCP client.
For information on how to connect to an MCP server from an MCP client, refer Connecting to an MCP server from an MCP client
Type a natural language prompt for the operation you want to perform.
| Operation | What to type |
|---|---|
| Retrieve | Examples by data type:
"Show me all my open opportunities" or "What's my pipeline split by stage?"
"Search the product catalog for enterprise storage solutions" or "What products are available in the networking category?"
"I'm getting on a call with <company name> — fetch the open opportunity details."
"Show me all line items on the <company name> opportunity" or "Fetch the products being sold in OPTY100001."
"What tasks do I have today including overdue?"
"Show me all my overdue tasks."
"Show me all open tasks for the <company name> opportunity."
"Show me all touchpoints logged against <company name> in the last month."
"Fetch my last touchpoint for the <company name> opportunity" or "Show me the description of the discovery call touchpoint on OPTY100001."
"Fetch all the stakeholders for this opportunity" or "Who are my contacts at <company name>?"
"Fetch all competitors for the <company name> opportunity" or "Who are the competitors on OPTY100001?"
"Show me all accounts I own." |
| Update | Examples by field or entity:
"Update the quantity of the Pro License on the <company name> deal to five."
"Move the <company name> Q3 deal to Proposal/Price Quote" or "Move OPTY100001 to the next stage."
"Change the forecast category on the <company name> deal to Commit."
"Push the close date for <company name> to end of next month." Relative expressions such as "Q3 end" or "next Friday" are supported. Close dates can't be set in the past.
"Set OPTY100001 amount to 350K." Formatted inputs such as $350,000 and 0.35M are supported.
"Add a note to <company name>: 'Budget confirmed, decision in 30 days.'" Notes are appended and never overwritten.
"Set next steps on <company name>: 'Send revised proposal by Friday'" or "Update loss reasons on OPTY100001."
"Update <company name>: stage to Negotiation, close date to June 30, forecast to Commit."
"Reassign the <company name> deal to Alex Johnson."
"Change Alex Smith's role on <company name> from Influencer to Decision Maker."
"Mark Salesforce as the incumbent on the <company name> opportunity" or "Set Oracle's incumbent status to false on OPTY100001." "Update the product family for Salesforce on the <company name> deal to Sales Cloud." "Set the product offering for Oracle on OPTY100001 to Fusion CRM."
"Mark my <company name> follow-up task as complete."
"Add a note to my <company name> call task: 'Left voicemail, retry Thursday.'"
"Reassign my <company name> follow-up task to Alex Johnson."
"Mark my <company name> touchpoint from yesterday as completed."
"Set the outcome of my last <company name> call to Positive."
"Update the notes on the last <company name> call: 'Champion requested a revised proposal.'"
"Update Alex Smith's mobile to +1-555-0199" or "Change Alex Smith's title to Chief Procurement Officer." |
| Create | Examples by record type:
"Create a new opportunity for <company name>, $200K, closing in June." The account must already exist; if it's not found, the agent asks you to clarify.
"Add the Enterprise Storage 10TB product to the <company name> opportunity" or "Add two units of the Pro License to OPTY100001."
"Add Salesforce as a competitor on the <company name> deal" or "Add Oracle to the competitor list for OPTY100001 with product family CRM." Note: The agent prevents duplicate competitor entries on the same opportunity.
"Add Jane Smith as the economic buyer on <company name>." If the contact doesn't exist, the agent asks whether to create one.
"Create a follow-up task on <company name> for next Monday." Relative due dates such as "next Thursday" are supported. The task is assigned to you by default.
"Log a 30-minute discovery call with Jane Smith at <company name> today."
"Add a note to my <company name> touchpoint from yesterday: 'Budget confirmed, decision expected in 30 days."
"Create a contact: John Doe, VP Sales at <company name>, john@abcd.com." |
| Delete | Supported operations:
"Remove the Basic Support package from the <company name> opportunity."
"Remove Salesforce from the <company name> competitor list" or "Delete Oracle as a competitor on OPTY100001."
"Deactivate Jane Smith from the <company name> opportunity" or "Disassociate John Doe from OPTY100001." |
Provide any additional information the agent asks for.
Note:
- For create operations, the agent asks for missing mandatory fields one at a time.
- For update operations, it resolves ambiguous record references by asking you to select from a list.
- Field-type validations run before any change is committed; if a value is invalid, the agent returns an error and suggests a correction.
- For create, update, and delete operations: review the confirmation card and confirm to commit.
Note: The confirmation card shows what will change before anything is saved or deleted. For update operations, it shows the old and new value for each field. Retrieve operations return results directly without a confirmation step.
The agent performs the operation and returns the result. For create operations, it returns the record name and a link. For delete operations, it confirms the record was removed. If you don't have the required access, the agent returns a permission denied message.