Tools
The Solk MCP server's read, write and permanent-delete tools, their parameters, and example prompts.
Tools run on top of the REST API: each tool call invokes the corresponding API endpoint under your account, and the same rules apply (permissions, visibility, stage gates, duplicate protection). The client sees only the tools you can use:
- Without the
crm.readscope, read tools don't appear in the list; withoutcrm.write, write tools don't. Delete tools appear only when the separate Permanent delete (crm.delete) box was ticked on the consent screen. - Tools of integrations that aren't connected (WhatsApp Business, phone system, SMS, call recording) and admin tools (workflow drafts, billing summary, merge, archive, opportunity delete) aren't listed for sales users.
- Tools for modules that are disabled on your license or for your user aren't listed (for example, if the Fair leads module is disabled, its tools are hidden).
Tool names and descriptions are in English so that models understand them better; you can still talk to the assistant in Turkish.
Read tools
Read tools are reported to the client with readOnlyHint: true — Claude offers an "always allow" option for them.
| Tool | Description | Parameters | Example prompt |
|---|---|---|---|
search |
Find companies, contacts, opportunities and fair leads by name, city, phone or e-mail (min 2 characters). Also resolves a 15-character record ID. | query* |
Find Kumsal Plastik |
list_companies |
List companies (customers) with filters. Returns rows with id, status (AC/Prospect), owner, city, visit state, plus counts. | page, query, scope (mine · all), sort (name · visit · priority), status (AC · Prospect), visit (overdue · soon · ok · none) |
List my active customers with overdue visits |
get_company |
Full company card: contacts, opportunities, recent visits/demos, open actions, offers, notes, email threads and key fields. | company_id* |
Summarize the Alize Paketleme company card |
list_contacts |
List contacts (people) across companies. | query, scope (mine · all) |
Show contacts whose title is purchasing manager |
list_opportunities |
List opportunities (sales projects). stage: open (default), closed, account (customer follow-up containers) or a stage key Lead, In Progress, Win, Lost, Cancel. | page, query, scope (mine · all), sort (update · health · value · sla), stage |
Sort opportunities in Negotiation by value |
get_opportunity |
Full opportunity: stage, value, probability, health, checklist steps, BANT, gate problems, visits, demos, offers, stage history, notes. | opportunity_id* |
What is the stretch film opportunity waiting on to move to the next stage? |
list_actions |
Open to-dos: tasks, next actions from visits and demos, and dated project steps. Each row has kind + id (use with complete_action). | company_id, scope (mine · all), state (today · overdue · soon · open · week) |
Which of my actions are overdue this week? |
get_action |
One action / task with its context (company, opportunity, history). | id, kind (visit · demo · task · step) |
Open the details of the price list task |
list_calendar |
Calendar: meetings and events in a date range, plus derived entries (due actions, visit due dates). | from, to |
What's on my calendar next week? |
list_email_threads |
E-mail conversations synced from the users' mailboxes. Either for a record (record_type + record_id) or the inbox (filter, query). | filter (all · waiting · replied · mine), query, record_id, record_type (customer · opp · visit · demo · task · offer · ticket · contract) |
Show customer emails waiting for a reply |
get_email_thread |
Messages of one e-mail conversation (bodies may be hidden if the user may not see them) and its linked records. | thread_id* |
Summarize the latest thread with Kuzey Plastik |
get_dashboard |
KPIs: pipeline by stage (count and value in base currency), weekly visit targets, SLA overruns, visits due, next steps, upcoming items. | scope |
Give me a pipeline summary |
get_today |
My day: today's meetings and to-dos, overdue items, recently viewed records and this week's activity. | — | What do I need to do today? |
list_team |
Active users (id, name, role, department) — use ids for assigned_to / owner_id. | — | Who is on the team? |
list_comments |
Comment threads (team discussion, not notes). Either for one record (record_type + record_id; filter open|all) or my inbox without a record (filter: mentions = threads mentioning me, mine = threads I wrote in, open = all unresolved I can see, all). | filter (open · all · mentions · mine), record_id, record_type (customer · opp · contact · thread · lentry · canvas) |
Show open comment threads that mention me |
list_lists |
Purpose lists (e.g. 'Q4 targets'): id, object (customer/contact/opp), list stages, list-only fields, entry count, whether I can edit. | object (customer · contact · opp) |
Which lists do we have? |
get_list_entries |
Entries of a list with the record, list stage and list field values (100 per page). | list_id*, page, stage |
Show entries in the 'Quote' stage of the trade fair follow-up list |
list_reports |
Saved reports I can see and built-in report templates (incl. funnel, time in stage, stage changes, historical values) plus date ranges. | — | Which reports can I run? |
run_report |
Run a saved report (report_id) or a built-in template; optional range overrides its period. Returns labels, series, totals and the table (funnel adds conversion and win rate). Amounts are in the base currency. | range, report_id, template |
Run this quarter's sales funnel with the win rate |
get_relations |
Relationships of a company, contact or opportunity (e.g. parent company ↔ branches, a contact's other companies, partner on an opportunity) and the relation keys available to add (relation = 'key:a|b'). | record_id, record_type (customer · contact · opp) |
Which companies are related to Kuzey Plastik? |
list_canvases |
Whiteboard canvases I can see (optionally for one company / opportunity or by name) and the canvas templates. | query, record_id, record_type (customer · opp) |
List the canvases of Kuzey Plastik |
read_canvas |
Read a canvas: outline (frames with their sticky notes, shapes, cards, votes and connectors — default), json (all elements with positions and ids, plus card record data) or svg (rendered picture). | canvas_id*, format (outline · json · svg) |
Summarize the post-fair brainstorm canvas — which notes got the most votes? |
list_products |
Product catalog for quoting: code, name, group, unit, currency and list price per unit. With company_id adds that company's contracted prices; include_stock adds live ERP stock for the first 5 products (if an ERP connection reads stock). | company_id, group, include_inactive, include_stock, limit, query |
Show the products in the film group with their list prices |
list_offers |
Quotes with status (draft, awaiting approval, approved, presented, accepted = won, rejected, expired, revised), totals and approval flag. status=open (default) = not yet decided. Amounts: monthly and annual in the offer currency plus annual in the base currency. | company_id, opportunity_id, page, query, scope (mine · all), status (open · all · draft · review · approved · denied · presented · expired) |
List the quotes waiting for approval |
get_offer |
One quote with line items (product, monthly quantity, unit, list price, net unit price, discount %), totals, approval reasons and state, versions, payment terms, validity and the PDF link. | offer_id* |
Show the line items and discounts of quote TKL-2026-0044 |
list_orders |
Customer orders with PO number, product, quantity, shipped / remaining quantity, status, due date and the ERP sending status. | company_id, opportunity_id, page, query, status (open · late · partial · closed · all) |
Which open orders are past their due date? |
get_company_finance |
Accounts receivable from the connected accounting / ERP system (read-only): balance, overdue amount, credit limit and risk %, open and overdue invoices, 12-month revenue, average payment terms, and the invoice list. Invoices are issued in the ERP, not in Solk. | company_id*, limit, status (all · open · overdue · paid) |
What are Kuzey Plastik's balance and overdue invoices? |
list_tickets |
Support tickets (complaints, technical support, questions, returns…) with priority, status, assignee and SLA state. status=open (default: new, in progress, on hold) sorts by SLA due time. | assigned (me · unassigned · all), company_id, page, priority (Düşük · Normal · Yüksek · Acil), query, sla (overdue · soon), status (open · all · new · in_progress · on_hold · resolved · closed) |
Show open support tickets past their SLA |
get_ticket |
One support ticket: details, resolution, SLA times, linked product / lot, order and opportunity, and the timeline (internal notes, replies to the customer, status and assignment changes). | ticket_id* |
What has been done so far on the tearing complaint? |
list_contracts |
Customer contracts (supply / service / subscription) with dates, days left, renewal (auto-renew, notice days), value and status. status=active (default) = signed and running; expiring = inside the notice period. | company_id, expiring_within_days, page, query, status (active · expiring · draft · awaiting_signature · signed · completed · terminated · all) |
List contracts ending in the next 60 days |
list_automations |
What runs automatically in this workspace: workflows (trigger, conditions, steps, runs) and the record events they react to; for admins also connected apps (Slack, Teams, webhooks…) with their events and ERP order sync. Changes made with these tools trigger them as in the app. | — | Which automations run when an opportunity is won? |
list_phone_calls |
Calls from the connected phone system (Netgsm, Verimor, Bulutfon, AloTech, Tegsoft or another PBX): direction, status (answered = 'done', missed, no answer), company / contact, user and extension, talk time, queue wait, the logged visit, call recording and whether a missed call was returned (callback_at). Includes totals: answered rate, missed vs returned, median callback time, talk time. | company_id, days, direction (in · out), limit, mine, status (missed · answered), unreturned |
Which missed calls from yesterday haven't we returned? |
get_activity |
Activity feed of a company or one opportunity, newest first: e-mails, calls and SMS, visits and meetings, quotes, orders, e-invoices and shipments, notes and comments, tasks, stage / value / date / owner changes, lead assignment, win-score jumps and deal alerts. Each item has id, time, group, title, detail, who and where it came from (via: mobile, app, mail, pbx, mcp, flow, form, api, system). Planned items (next actions, visit due) come separately. Page with cursor. | before, company_id, group (all · mail · call · wa · meet · deal · note · task), limit, opportunity_id |
What happened at Kuzey Plastik in the last two weeks? |
search_activities |
Search activity across all records, newest first: visits and meetings, demos, phone-system calls, SMS, e-mails (individual messages), WhatsApp messages, notes, call / meeting recordings, completed tasks, quotes and orders. Filter by types, company, opportunity, user, date range, text and direction. For one record's full timeline use get_activity. Page with cursor → before. | before, company_id, date_from, date_to, direction (in · out), limit, mine, opportunity_id, query, types, user_id |
List the e-mails the team sent this week |
aggregate |
Count, sum or average records grouped by up to two dimensions — e.g. e-mails sent this week by user, visits per month, pipeline value by stage, won opportunities by owner, tickets by category. Call get_fields first to see objects, dimensions, date fields and numeric fields. Time buckets: day, week, month, quarter, year (of date_field). Money is in the base currency. Only records the user can see are counted. | company_id, date_field, date_from, date_to, field, filters, group_by, limit, metric (count · sum · avg · min · max), mine, object* (companies · opportunities · visits · demos · tasks · offers · orders · emails), opportunity_id |
How many visits did each rep make this quarter? |
get_fields |
Fields the aggregate tool can use. Without arguments: overview of every object (dimensions, date fields, numeric fields). With object: the values of each dimension (statuses, stages, sources …) and the object's custom fields; narrow with name_contains. | name_contains, object |
Which fields can I group opportunities by? |
search_help |
Search the Solk user guide, in-app tours and tips — how to use a feature, where a setting is, what a term means. Answers come from this workspace's own guide; links open the page. Product docs: https://docs.solk.app. | limit, query* |
How do I change an opportunity's stage? |
get_workspace |
Workspace and signed-in user: app version, base currency, time zone, enabled modules, the pipeline (stage keys, renamed labels, probability, forecast category), record visibility, license state and connected integrations (mailbox, WhatsApp Business, phone system, SMS, AI, ERP). | — | What are our sales stages and their probabilities? |
get_contact |
One contact (person) with company, title, e-mail, phone, custom fields, recent e-mails and visits. | contact_id* |
When did we last talk to Merve Ak? |
list_call_recordings |
Recorded calls and online meetings (bot, browser recorder, phone system, native Google Meet / Microsoft Teams transcripts) with title, company, duration and AI summary state. | company_id, filter (all · mine), query |
Get the meeting recordings with Kuzey Plastik |
get_call_recording |
One call / meeting recording: speakers and talk ratio, AI summary sections, action items, chapters and the speaker-labelled transcript. | recording_id* |
Pull the action items from yesterday's meeting |
list_notes |
Notes across companies, opportunities, tickets and contracts — mine, mentioning me, favourites, or one record's notes. | filter (all · mine · mentions · favs), limit, query, record_id, record_type (customer · opp · ticket · contract) |
Show the notes that mention me |
get_note |
One note with its record, author, labels and mentions. | note_id* |
Open this note in full |
list_email_templates |
E-mail templates I can use (shared and my own). | query |
Do we have a template for quote follow-ups? |
get_email_template |
One e-mail template with its subject and body (variables in braces). | template_id* |
Show the quote follow-up template |
render_email_template |
Fill a template's variables for a company / contact / opportunity and return the ready subject and body (nothing is saved or sent). | company_id, contact_id, opportunity_id, template_id* |
Fill the quote follow-up template for Merve Ak |
list_notifications |
My inbox: the latest 50 notifications (mentions, assignments, approvals, incoming WhatsApp, overdue items …) with read state. | — | What notifications haven't I read? |
list_saved_views |
Saved list filters (opportunities, tickets, contracts, orders) — mine and shared — with the link that opens them. | kind (opp · ticket · contract · order) |
List my saved views |
list_custom_fields |
Custom fields defined for companies, contacts and opportunities: key, label, type, choices (select), currency, AI-filled fields. | record_type (customer · contact · opp) |
Which custom fields do opportunities have? |
list_object_types |
Custom object types of this workspace (e.g. production line, branch, equipment) with record counts. | — | Which custom objects do we have? |
list_object_records |
Records of one custom object type (40 per page), optionally of one company. | archived (1), company_id, object_key*, page, query |
List Kuzey Plastik's production lines |
get_object_record |
One custom object record with all field values and its links. | object_key, record_id |
Open the details of line 3 |
get_workflow |
One automation (workflow): trigger, conditions, actions, on / off, run count (admins). | workflow_id* |
What does the 'Quote reminder' workflow do? |
list_roles |
Roles and module access in this workspace, record visibility mode and each active member's role. | — | Who has which role? |
get_billing_summary |
Plan, billing period, seats used / licensed, license end and recent Solk invoices (admins). | — | How many seats do we have free? |
list_whatsapp_chats |
WhatsApp Business conversations: contact, company, last message, unread count and whether the 24-hour reply window is open. | company_id, filter (all · unread · open · unlinked), query |
Are there WhatsApp messages waiting for a reply? |
get_whatsapp_chat |
Messages of one WhatsApp conversation (newest 50), delivery states and the approved templates usable now. | chat_id* |
Summarize the WhatsApp chat with Merve Ak |
* required parameter.
Write tools
Write tools create or modify records; none of them delete records. Tools that change existing data are declared destructiveHint: true: the update_* tools, postpone_action, fill_ai_field, send_whatsapp, update_company, change_opportunity_stage, complete_action, log_activity (can close open actions), resolve_comment, upsert_list_entries, add_relation (replaces the old link on a single-valued relationship), remove_relation, update_canvas, create_offer (becomes the primary quote and updates the opportunity's price), update_offer_status, create_order (can mark the company as a customer and send the order to the ERP), update_ticket, run_workflow. Tools that only add (other create_*, add_note, add_comment) are false. create_order, run_workflow and send_whatsapp are also openWorldHint: true — they can reach an external system (your ERP, a workflow's HTTP step, the customer's WhatsApp). create_email_draft only saves a draft and never sends e-mail; create_workflow creates the workflow switched off. Claude asks for approval before every write call. If an admin turned on the read-only rule, write tools aren't listed.
| Tool | Description | Parameters | Example prompt |
|---|---|---|---|
create_company |
Create a company (status Prospect unless given). Fails if the name exists; similar names need confirm_new=true. Optional first contact. | address, city, confirm_new, contact_email, contact_name, contact_phone, contact_title, name*, note, owner_id, phone, sector, status (AC · Prospect), website |
Create a new prospect called Anadolu Gıda Ambalaj in Konya |
update_company |
Update company fields (only the given ones change). | address, city, company_id*, name, note, owner_id, phone, sector, status (AC · Prospect), visit_period_days, website |
Mark Kuzey Plastik as an active customer and set a 30-day visit cycle |
create_contact |
Add a person to a company. | company_id, department, email, is_main, name, note, phone, title |
Add Emre Yıldız to Kuzey Plastik as production lead |
create_opportunity |
Open a new sales project for a company (starts in the first stage). | company_id*, competitor, name, note, type, value |
Open a 'Stretch film supply' opportunity for Kuzey Plastik |
change_opportunity_stage |
Move an opportunity to another stage. Keys: Lead, In Progress, Win, Lost, Cancel. Pipeline gates apply; refused changes return the reasons. | note, opportunity_id, reason, stage (Lead · In Progress · Win · Lost · Cancel) |
Move the stretch film opportunity to Viable |
create_task |
Create a task (to-do). Assigned to me unless assigned_to is given. Linking a company is optional; no project is opened automatically. | assigned_to, company_id, company_name, detail, due_date, due_time, opportunity_id, priority (Düşük · Normal · Yüksek · Acil), title* |
Create a task to call Kuzey Plastik tomorrow at 10:30 |
complete_action |
Mark an action done (task, visit/demo next action, project step). done_on = completion day YYYY-MM-DD (default today). | done_on, id, kind (visit · demo · task · step), result |
Mark the price list task as done |
log_activity |
Record a call or face-to-face visit with a company (Quick Entry): note, result and the next action + date. Closes matching open actions and advances the project like the web form. Unknown company names create a new lead unless similar names exist (then confirm_new=true). | action_date, company, confirm_new, contact, next_action, note, opportunity_id, result, topic, visit_date, visit_type (F2F · Online · Call) |
Log my call with Kuzey Plastik just now and add a follow-up to send a quote on Thursday |
add_note |
Add a note to a company, opportunity, support ticket or contract. | body, record_id, record_type* (customer · opp · ticket · contract) |
Add a note 'asked for a price revision' to Alize Paketleme |
add_comment |
Start a comment thread on a record or reply to one (reply_to = any comment id of the thread). mention_user_ids notify team members (ids from list_team); their @Name is added to the text if missing. Resolved threads reopen on reply. | body, mention_user_ids, record_id, record_type* (customer · opp · contact · thread · lentry · canvas), reply_to |
Comment on Kuzey Plastik asking when the samples ship and mention Ayşe |
resolve_comment |
Mark a comment thread resolved (resolved=false reopens). | comment_id*, resolved |
Resolve the comment thread about the samples |
upsert_list_entries |
Key-based upsert: for each row the record (record_id, or record_name resolved like search) is added to the list if missing, then its list stage and list field values (keys or labels from list_lists) are set. Up to 200 rows; per-row errors are returned. | list_id, rows |
Add these five companies to the Q4 targets list with stage 'First contact' |
add_relation |
Link this record to another (relation from get_relations.available, target_id of target_type). Single-valued relations replace the old link; cycles in parent chains are refused. | note, record_id, record_type (customer · contact · opp), relation, target_id |
Make Kuzey Plastik Bursa a branch of Kuzey Plastik |
remove_relation |
Remove one relationship link (relation_id from get_relations). | relation_id* |
Remove the reseller relationship |
create_canvas |
Create a whiteboard canvas from one of 67 templates (keys in list_canvases; record templates: stakeholders, orgchart, account_plan — company; deal_plan — opportunity; others e.g. kanban, journey, mindmap, roadmap, swot, retro, flowchart, swimlane, bmc, slides), from a Mermaid flowchart (mermaid: 'flowchart LR' + nodes/edges, laid out automatically) or from elements. Record templates fill in contacts, opportunities, risks and next steps from the CRM. Element: {id?, type: sticky|text|shape|frame|card|connector|line|draw|table|dtable|tline|aib|emoji, x, y, w, h, text, color: yellow|orange|pink|red|purple|blue|teal|green|gray|white, shape: rect|round|ellipse|diamond|triangle|hexagon|parallelogram|cylinder|barrow|star|pentagon|octagon|trapezoid|cross|callout|cloud|document|chevron|larrow|darrow|process (shape), size: s|m|l|xl (text), ref: {kind: contact|customer|opp|user, id} (card), from, to (element ids), label, style: arrow|line|dashed, route: elbow|curve (connector; omit = straight), pts: [[x, y], …] 0–1000 inside the element box + style, elbow, width (line), pts + width (draw: free-hand stroke), cells: [[text, …], …] first row = header (table), dtable = smart table: text (title), cols: [{id, n (name), t: text|num|date|person|tag|status|check, w, o: [{v, c}] options for tag/status}], groups: [{id, n, c}], rows: [{id, g (group id), v: {col id: value — text, number, YYYY-MM-DD, user id, [tag…], status option, true/false}}]; dtable views: view: board|tl (omit = table), vb: {c: status/person/check column id (board columns), l: g (groups as swimlanes) | column id}, vt: {s: start date column id, e: end date column id, sc: day|week|month, st: YYYY-MM-DD, n, l: g|column id|-}, gb: column id (group table rows by column), hide: [column ids], srt: {c, d: 1|-1}, flt: [{c, v}]; aib = AI block (runs in the editor; connectors pointing to it are its context, its output appears below it): kind: doc|table|board|timeline|diagram|slides|notes, text (title), prompt; tline = timeline/roadmap: text, scale: day|week|month, start: YYYY-MM-DD, n (units), groups: [{id, n, c}], items: [{id, g, n, s, e (YYYY-MM-DD), c}]; st (style, any text element): {ff: inter|open|mont|nunito|lora|playfair|slab|caveat|mono, fs (px), b, i, u, k (strike) 1, ta: l|c|r, va: t|m|b, tc, fill, bc (palette: white|snow|silver|gray|ink|black|lyellow|lorange|lred|lpink|lviolet|lblue|lcyan|lgreen|yellow|orange|red|pink|violet|blue|cyan|green, fill/bc may be none), bw (border px), bs: solid|dashed|dotted, op (10–100), sh (shadow) 1, ah: end|start|both|none (connector arrows)}; text = one emoji (emoji), lk: 1 = locked (any box element; it cannot be moved, edited or deleted until an update sets lk: null)}. Coordinates in px; stickies ~200×200, frames hold items placed inside their box (frames are slides in presentation mode). Give new elements your own short ids (4–16 lowercase letters/digits) to connect them in the same call. | access (edit · read · private), elements, mermaid, name, record_id, record_type (customer · opp), template (blank · stakeholders · orgchart · account_plan · deal_plan · swot · retro · pipeline) |
Create an account plan canvas for Kuzey Plastik |
update_canvas |
Change a canvas as a diff: add elements, update elements by id (only given fields change), delete ids (their connectors go too) and/or append a Mermaid flowchart next to the existing content. Element: {id?, type: sticky|text|shape|frame|card|connector|line|draw|table|dtable|tline|aib|emoji, x, y, w, h, text, color: yellow|orange|pink|red|purple|blue|teal|green|gray|white, shape: rect|round|ellipse|diamond|triangle|hexagon|parallelogram|cylinder|barrow|star|pentagon|octagon|trapezoid|cross|callout|cloud|document|chevron|larrow|darrow|process (shape), size: s|m|l|xl (text), ref: {kind: contact|customer|opp|user, id} (card), from, to (element ids), label, style: arrow|line|dashed, route: elbow|curve (connector; omit = straight), pts: [[x, y], …] 0–1000 inside the element box + style, elbow, width (line), pts + width (draw: free-hand stroke), cells: [[text, …], …] first row = header (table), dtable = smart table: text (title), cols: [{id, n (name), t: text|num|date|person|tag|status|check, w, o: [{v, c}] options for tag/status}], groups: [{id, n, c}], rows: [{id, g (group id), v: {col id: value — text, number, YYYY-MM-DD, user id, [tag…], status option, true/false}}]; dtable views: view: board|tl (omit = table), vb: {c: status/person/check column id (board columns), l: g (groups as swimlanes) | column id}, vt: {s: start date column id, e: end date column id, sc: day|week|month, st: YYYY-MM-DD, n, l: g|column id|-}, gb: column id (group table rows by column), hide: [column ids], srt: {c, d: 1|-1}, flt: [{c, v}]; aib = AI block (runs in the editor; connectors pointing to it are its context, its output appears below it): kind: doc|table|board|timeline|diagram|slides|notes, text (title), prompt; tline = timeline/roadmap: text, scale: day|week|month, start: YYYY-MM-DD, n (units), groups: [{id, n, c}], items: [{id, g, n, s, e (YYYY-MM-DD), c}]; st (style, any text element): {ff: inter|open|mont|nunito|lora|playfair|slab|caveat|mono, fs (px), b, i, u, k (strike) 1, ta: l|c|r, va: t|m|b, tc, fill, bc (palette: white|snow|silver|gray|ink|black|lyellow|lorange|lred|lpink|lviolet|lblue|lcyan|lgreen|yellow|orange|red|pink|violet|blue|cyan|green, fill/bc may be none), bw (border px), bs: solid|dashed|dotted, op (10–100), sh (shadow) 1, ah: end|start|both|none (connector arrows)}; text = one emoji (emoji), lk: 1 = locked (any box element; it cannot be moved, edited or deleted until an update sets lk: null)}. Coordinates in px; stickies ~200×200, frames hold items placed inside their box (frames are slides in presentation mode). Give new elements your own short ids (4–16 lowercase letters/digits) to connect them in the same call. | add, canvas_id*, delete, mermaid, update |
Add three sticky notes to the 'Risks' frame of the account plan |
create_offer |
Create a quote with line items for an opportunity. It becomes the primary quote and updates the opportunity's price, quantity and annual value (quantity × price × 12). Discounts above the workspace limit or prices under a product's floor need manager approval (state 'review'). Returns the quote with totals, approval reasons and the PDF link. | currency, lines, note, opportunity_id, payment_days, terms, valid_until |
Prepare a quote on the stretch film opportunity: 1,000 kg film at €2.40 and 50 kg labels |
update_offer_status |
approve / deny a quote awaiting approval (admins), mark_presented (sent to the customer), make_primary (this quote feeds the opportunity). Refused changes return the reason. | action (approve · deny · mark_presented · make_primary), note, offer_id |
Approve quote TKL-2026-0044 |
create_order |
Create a customer order: either from an accepted quote (offer_id — the opportunity must be Won; one order per line) or directly (company_id + product + quantity). customer_po = the customer's purchase order number. If the workspace sends orders to its ERP automatically, the new order goes there (the ERP issues the invoice). | company_id, currency, customer_po, due_date, kind (İlk Sipariş · Yeni Sipariş · Geri Kazanım), offer_id, product, product_id, quantity, unit_price |
Create an order from the accepted quote with PO 4500123 |
create_ticket |
Open a support ticket for a company (or a person / company name not in the CRM). The workspace's ticket form template sets the SLA target, default assignee and first tasks; the assignee is notified. | assigned_to, category (Ürün kalitesi · Uygulama / proses · Teslimat / lojistik · Ambalaj / etiket · Doküman (TDS / SDS / CoA) · Fatura / ödeme · Diğer), company_id, company_name, contact_id, contact_name, detail, kind (Şikâyet · Teknik destek · Soru / bilgi · Numune / deneme · İade · Öneri), lot_no, opportunity_id, order_id, priority (Düşük · Normal · Yüksek · Acil), product, source (Telefon · E-posta · Ziyaret · WhatsApp · Web · Mobil), subject* |
Open a 'film is tearing' complaint for Kuzey Plastik, high priority, lot L-2291 |
update_ticket |
Change a ticket's status (resolved needs a resolution text), priority (resets the SLA target), assignee, and/or add a comment (internal note or reply to the customer — a reply counts as first response). | assigned_to, comment, comment_type (note · reply), priority (Düşük · Normal · Yüksek · Acil), resolution, status (new · in_progress · on_hold · resolved · closed), ticket_id* |
Resolve the tearing complaint: winding tension adjusted |
run_workflow |
Run a manual workflow (list_automations: manual=true) on up to 200 opportunities or companies. Its steps run now (tasks, notifications, field updates, app / HTTP calls); records that don't match its conditions or that you may not edit are skipped. | record_ids, record_type (opp · customer), workflow_id* |
Run the 'Hand over won deal' workflow on these three opportunities |
send_sms |
Send one SMS to a contact or company phone through the workspace's SMS provider. kind=info (default; order, delivery, appointment, payment notices — no campaign wording) or tacir (commercial message to a business's corporate line, not an employee's personal mobile; the workspace's sender-identity and opt-out line is appended; only on providers with an İYS filter). Refuses numbers on the opt-out list and informational texts that contain campaign wording. The SMS is logged on the company timeline. Confirm with the user first. | company_id, contact_id, kind (info · tacir), phone, text* |
Text Can that the sample ships tomorrow |
update_contact |
Update a contact (only given fields change). is_former=true marks someone who left (preferred over deleting). | contact_id*, department, email, is_former, is_main, name, note, phone, title |
Change Merve Ak's title to purchasing specialist |
update_opportunity |
Update opportunity fields (only given ones change): name, type, product line, monthly quantity, unit price, payment days, close date, next step date, note, forecast category. Stage changes go through change_opportunity_stage (gates apply). | close_date, forecast_cat (Pipeline · Best Case · Commit · Omitted), line, name, next_step_date, note, offer_price, opportunity_id*, payment_days, potential_kg, product_id, type |
Move the stretch film deal's close date to 15 December |
update_task |
Change a task: title, details, due date / time, priority, status, assignee (only given fields change). | assigned_to, detail, done_on, due_date, due_time, priority (Düşük · Normal · Yüksek · Acil), status (Açık · Devam Ediyor · Tamamlandı), task_id*, title |
Assign the price list task to Ozan, due tomorrow |
postpone_action |
Snooze an open action (task, visit / demo next action, project step) by days or to a date, with a reason that is kept in the history. | date, days, id, kind (visit · demo · task · step), note |
Postpone the sample follow-up a week: customer on leave |
update_note |
Replace the text (and title) of a note I wrote (admins: any note). | body, note_id, title |
Correct my last note to 'sample ships Monday' |
create_email_template |
Save a new e-mail template. Variables in braces: {firma}, {kişi_ad}, {fırsat}, {ben_ad} …; fallback {kişi_ad|Merhaba}. Signature is added from the sender's mailbox. | body, name, shared, subject |
Create a shared template for sample follow-ups |
update_email_template |
Change my template (admins: any). Only given fields change. | body, name, shared, subject, template_id* |
Shorten the subject of the quote follow-up template |
create_email_draft |
Save an e-mail as a DRAFT for the user to review and send from E-postalar › Taslaklar — it is never sent by this tool. Give subject + body, or template_id (filled for the company / contact / opportunity). To reply in a thread pass in_reply_to_email_id (from get_email_thread). The sender's signature is added when sent. | bcc, body, cc, company_id, contact_id, in_reply_to_email_id, opportunity_id, subject, template_id, to |
Draft a quote follow-up to Merve Ak |
update_email_draft |
Change one of my unsent drafts (only given fields change). Never sends. | bcc, body, cc, draft_id*, subject, to |
Add the delivery date to the draft |
mark_notifications_read |
Mark my notifications as read — the given ids, or all unread ones. | ids |
Mark all my notifications as read |
create_object_record |
Create a record of a custom object type, optionally on a company, with field values. | company_id, fields, links, name, object_key |
Add line 4 to Kuzey Plastik |
update_object_record |
Change a custom object record's name, owner, active state, field values or links. | active, fields, links, name, object_key, owner_id, record_id |
Set line 3's capacity to 1,200 kg |
create_workflow |
Create an automation as a DISABLED draft (admins) — from a ready template key or from a plain-language description (AI). The user reviews and switches it on in the web app. | description, name, template (contract_service · cross_sell · deal_nudge · email_followup · health_check · install_anniv · lead_triage · lost_retry) |
Draft a workflow that creates a call task when a quote has waited 7 days |
create_calendar_event |
Add an event to my calendar, optionally linked to a company. | all_day, company_id, company_name, end, location, note, start, title |
Add a Kuzey Plastik meeting on Thursday at 14:00 |
fill_ai_field |
Let AI fill one AI custom field of a company, contact or opportunity from the record's own data (summary, classification or instruction) and save it. list_custom_fields shows the AI fields. | field_key, record_id, record_type* (customer · contact · opp) |
Fill Kuzey Plastik's 'segment' field |
start_whatsapp_chat |
Open (or find) the WhatsApp Business conversation with a number / contact and link it to the company. Does not send anything. | company_id, contact_id, phone |
Open a WhatsApp chat with Merve Ak |
send_whatsapp |
Send a WhatsApp Business message from the company number. Free text only within 24 hours of the customer's last message; otherwise an approved template (get_whatsapp_chat lists them) with its {{n}} variables. Marketing templates need the customer's opt-in. | chat_id*, template, text, variables |
Send Merve Ak the quote reminder template |
add_to_call_list |
Add a contact's or company's phone number to the call list (dialer campaign) of the workspace's call-center connection (Solveline / Mantis or another call center with an add-record URL). The call center then calls the number — optionally at a set time and connected to a given rep's extension (appointment). Numbers on the do-not-call list are refused; a number already added to the same campaign within the workspace's repeat window is refused unless force=true. Shown on the company's activity feed. Confirm with the user first. | at, campaign, company_id, contact_id, force, link_id, note, phone, user_id |
Add Lale Metal's buyer to the call list so the call centre rings me tomorrow at 14:30 |
* required parameter.
Permanent delete tools
Delete and merge tools are a separate permission: when Claude connects, the consent screen shows a Permanent delete (optional) box, unticked by default. If you leave it unticked the connection can only read, create and update; these tools aren't listed and calling one returns an explanatory error. To turn it on later, remove the connection, reconnect and tick the box. Personal API keys (sk_…) can't delete.
Every delete tool requires confirm: true — only when the user explicitly asks. archive_company doesn't delete the company, it makes it passive (history is kept); permanent company deletion is only possible in the web app, with an automatic backup. merge_companies takes a backup first. delete_opportunity, archive_company and merge_companies are listed for admins only. Every call is written to the audit log.
| Tool | Description | Parameters | Example prompt |
|---|---|---|---|
delete_task |
Permanently delete a task. Only when the user explicitly asks; confirm=true. | confirm, task_id |
Delete the duplicated task |
delete_note |
Permanently delete a note I wrote (admins: any). Only when the user explicitly asks; confirm=true. | confirm, note_id |
Delete the note I put on the wrong company |
delete_contact |
Permanently delete a contact. Prefer update_contact is_former=true for someone who left. Only when the user explicitly asks; confirm=true. | confirm, contact_id |
Delete the duplicate Merve Ak contact |
delete_opportunity |
Permanently delete an opportunity and its stage history (admins). Closing it as Lost / Cancel keeps the history and is usually right. confirm=true. | confirm, opportunity_id |
Delete the opportunity opened for testing |
archive_company |
Make a company passive (admins): history is kept, it leaves lists and reminders. Permanent deletion is only possible in the web app with an automatic backup. confirm=true. | company_id, confirm |
Archive Kumsal Plastik, which has ceased trading |
merge_companies |
Merge duplicate companies into one (admins): every linked record moves to keep_company_id, empty fields are filled, duplicates are deleted. A backup is taken first. Show the user both records and which one is kept, then call with confirm=true. | confirm, duplicate_company_ids, keep_company_id* |
Merge the two Kuzey Plastik company records |
delete_object_record |
Permanently delete a custom object record. confirm=true. | confirm, object_key, record_id* |
Delete line 2, which was removed |
delete_email_template |
Permanently delete my e-mail template (admins: any); refused while a workflow uses it. confirm=true. | confirm, template_id |
Delete the old campaign template |
delete_calendar_event |
Delete a calendar event that was added in Solk (synced Google / Outlook events are not deleted). confirm=true. | confirm, event_id |
Remove Thursday's meeting from the calendar |
delete_saved_view |
Delete one of my saved list views (admins: shared ones too). confirm=true. | confirm, view_id |
Delete the old 'October deals' view |
* required parameter.
Response format
Tools return results both as text (content[0].text, JSON) and as structured content (structuredContent). On business rule errors (for example, a stage gate or a similar company name), the result has isError: true and text explaining the reason; the assistant passes this on to the user or corrects the request and retries.
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"content": [{ "type": "text", "text": "{\"counts\": {\"overdue\": 8, \"soon\": 0, \"today\": 0}, \"rows\": [ … ]}" }],
"structuredContent": { "counts": { "overdue": 8, "soon": 0, "today": 0 }, "rows": [ "…" ] },
"isError": false
}
}