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.read scope, read tools don't appear in the list; without crm.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
  }
}