# Simla.com — how to use (mcp.ai)

Connect your Simla.com account and use 141 tools for CRM straight from your AI agent. Connect with your own API key. Simla.com is an omnichannel CRM platform with AI for automating communications, measuring team performance, managing customer data, and integrating delivery services and order management.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_simla_com?ms=1787295720000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `simla_com_add_customer_interaction_favorite`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/simla_com`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/simla_com/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/simla_com/add/customer/interaction/favorite` — Tool to add a product offer to a customer's list of favorites. Use when you need to save a specific product to a customer's favorites on a particular site.
  - body: { site: string, favorite: object, customerId: string }
- `POST https://api.mcp.ai/api/simla_com/combine/customers` — Tool to combine multiple customers into one. The specified customers will be merged into the result customer and then deleted. Use when you need to consolidate multiple customer records. Note: This op
  - body: { customers: object[], resultCustomer: object }
- `POST https://api.mcp.ai/api/simla_com/combine/customers/corporate` — Tool to combine multiple corporate customers into one. The specified customers will be merged into the result customer and then deleted. Use when you need to consolidate multiple corporate customer re
  - body: { customers: object[], resultCustomer: object }
- `POST https://api.mcp.ai/api/simla_com/combine/orders` — Tool to combine two orders into one. The source order will be merged into the result order using the specified technique. Use when you need to consolidate order data from one order into another.
  - body: { order: object, technique: string, resultOrder: object }
- `POST https://api.mcp.ai/api/simla_com/create/cost` — Create a new cost record in Simla CRM. Use this to track business expenses with period dates, amounts, and cost categories. Required fields: dateFrom (start date), dateTo (end date), summ (amount), an
  - body: { cost: object }
- `POST https://api.mcp.ai/api/simla_com/create/custom/field` — Tool to create a custom field for a specified entity in Simla. Use when you need to extend orders, customers, corporate customers, or companies with custom metadata fields.
  - body: { code?: string, name: string, type: string, entity: string, inList?: boolean, inFilter?: boolean, ordering?: integer, required?: boolean, viewMode?: string, dictionary?: string, displayArea?: string, inGroupActions?: boolean, viewModeMobile?: string }
- `POST https://api.mcp.ai/api/simla_com/create/custom/fields/dictionaries` — Tool to create a custom fields dictionary with elements. Use when you need to create a new directory for dictionary-type or multiselect_dictionary-type custom fields.
  - body: { code?: string, name: string, elements: object[] }
- `POST https://api.mcp.ai/api/simla_com/create/customer` — Creates a new customer in Simla.com. All customer fields are optional - provide at least one field (e.g., firstName, email, or phone) to create a customer. Returns the customer ID upon successful crea
  - body: { customer: object }
- `POST https://api.mcp.ai/api/simla_com/create/customer/corporate` — Creates a new corporate customer in Simla.com. Use when you need to add a new business or organization as a customer. At least one field (typically nickName or externalId) should be provided. Returns 
  - body: { customerCorporate: object }
- `POST https://api.mcp.ai/api/simla_com/create/customer/interaction/cart/set` — Tool to create or overwrite shopping cart data for a customer. Use when you need to set cart contents for customer interaction tracking. This overwrites any existing cart data for the specified custom
  - body: { cart: object, site: string }
- `POST https://api.mcp.ai/api/simla_com/create/customers/corporate/addresses` — Creates a new address for a corporate customer in Simla.com. Use when adding a delivery or billing address to an existing corporate customer account. The address can be specified as simple text or wit
  - body: { site?: string, address: object, externalId: string }
- `POST https://api.mcp.ai/api/simla_com/create/customers/corporate/companies` — Tool to create a company for a corporate customer in Simla.com. Use when you need to add a new company to an existing corporate customer record. Returns the newly created company ID on success.
  - body: { company: object, externalId: string }
- `POST https://api.mcp.ai/api/simla_com/create/customers/corporate/contacts` — Tool to create a link between a corporate customer and a contact person. Use when you need to associate an existing customer as a contact for a corporate customer entity.
  - body: { by?: string, id?: integer, site?: string, contact: object, externalId?: string }
- `POST https://api.mcp.ai/api/simla_com/create/customers/corporate/notes` — Tool to create a note for a corporate customer. Use when you need to add notes or comments to corporate customer records. Requires either customer ID or external ID to identify the corporate customer.
  - body: { note: object, site?: string }
- `POST https://api.mcp.ai/api/simla_com/create/customers/notes` — Tool to create a note for a customer. Use when you need to add notes or comments to customer records. Requires either customer ID or external ID to identify the customer.
  - body: { note: object, site?: string }
- `POST https://api.mcp.ai/api/simla_com/create/loyalty/calculate` — Tool to calculate maximum loyalty discount and bonuses for an order. Use when you need to preview loyalty benefits before order creation or show customers potential savings based on their loyalty stat
  - body: { site?: string, order: object, bonuses?: number }
- `POST https://api.mcp.ai/api/simla_com/create/order` — Create a new order in Simla with customer details and line items. This action registers an order with customer information, items (with offer IDs), delivery address, and optional metadata. The API aut
  - body: { site?: string, order: object }
- `POST https://api.mcp.ai/api/simla_com/create/orders/link` — Tool to create a link between multiple orders in Simla. Use when you need to associate two or more orders together with an optional comment.
  - body: { link: object, site?: string }
- `POST https://api.mcp.ai/api/simla_com/create/orders/packs` — Tool to create a new order pack in Simla. Use when you need to register pack shipment details for an order item, including store location, quantity, shipment date, and invoice/delivery note numbers.
  - body: { pack: object }
- `POST https://api.mcp.ai/api/simla_com/create/orders/payments/create` — Create a new payment record for an order in Simla CRM. Use when recording payments received for orders. Required fields: type (payment type code), amount (must be positive), and order reference (id or
  - body: { site?: string, payment: object }
- `POST https://api.mcp.ai/api/simla_com/create/reference/courier` — Tool to create a new courier in Simla.com. Use when you need to add a new courier to the system for delivery management. Returns the courier ID upon successful creation.
  - body: { courier: object }
- `POST https://api.mcp.ai/api/simla_com/create/reference/currencies` — Tool to create a new currency in Simla.com. Use when you need to add a new currency to the system for financial operations and multi-currency support.
  - body: { currency: object }
- `POST https://api.mcp.ai/api/simla_com/create/store/inventories/upload` — Tool to batch update inventory quantities and purchase prices across warehouses/stores. Use when you need to sync stock levels and cost pricing for offers. Updates leftover stocks (available quantity)
  - body: { site?: string, offers: object[] }
- `POST https://api.mcp.ai/api/simla_com/create/store/product/groups` — Tool to create a new product group in Simla.com store. Use when you need to add a new product group for organizing products. Returns the product group ID upon successful creation.
  - body: { productGroup: object }
- `POST https://api.mcp.ai/api/simla_com/create/store/products/batch/create` — Tool to batch create products and services in the store catalog. Use when you need to create multiple products at once. Each product requires a name, article (SKU), and catalogId that matches the cata
  - body: { catalog: integer, products: object[] }
- `POST https://api.mcp.ai/api/simla_com/create/task` — Tool to create a new task. Use after gathering task details and assignees.
  - body: { text: string, entity?: object, userId: integer, comment?: string, customer?: object, deadline?: string, taskType: string }
- `POST https://api.mcp.ai/api/simla_com/create/web/analytics/visits/upload` — Tool to batch upload web analytics visit records to Simla CRM. Use when tracking customer visits with traffic source attribution. Each visit must include site code, customer identifier, timestamp, and
  - body: { visits: object[] }
- `POST https://api.mcp.ai/api/simla_com/delete/cost` — Tool to delete a cost by ID. Use when you need to remove a cost record from the system.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/simla_com/delete/customers/corporate/note` — Tool to delete a corporate customer note by ID. Use when you need to remove a note record from a corporate customer.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/simla_com/delete/customers/note` — Tool to delete a customer note by ID. Use when you need to remove a note record from a customer.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/simla_com/delete/order/payment` — Tool to delete an order payment by ID. Use when you need to remove a payment record from an order.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/simla_com/edit/cost` — Tool to edit an existing cost record by ID. Use when you need to update cost details such as amount, dates, cost item, or attribution information for expense tracking and analysis.
  - body: { id: integer, cost: object, site?: string }
- `POST https://api.mcp.ai/api/simla_com/edit/custom/field` — Edit an existing custom field's properties by entity type and field code. Use this to modify custom field settings such as display name, description, type, visibility flags, sort order, default values
  - body: { code: string, name?: string, sort?: integer, type?: string, entity: string, isActive?: boolean, settings?: object[], isVisible?: boolean, isEditable?: boolean, isRequired?: boolean, description?: string, defaultValue?: string }
- `POST https://api.mcp.ai/api/simla_com/edit/custom/fields/dictionary` — Tool to edit an existing custom fields directory by code. Use when you need to update the directory name or modify its elements (add, remove, or reorder entries).
  - body: { code: string, name: string, elements: object[] }
- `POST https://api.mcp.ai/api/simla_com/edit/customer` — Tool to edit an existing customer. Use when you need to update customer details by external ID.
  - body: { sex?: string, email?: string, phone?: string, address?: object, birthday?: string, lastName?: string, firstName?: string, externalId: string, customFields?: object }
- `POST https://api.mcp.ai/api/simla_com/edit/customer/corporate` — Tool to edit an existing corporate customer. Use when you need to update corporate customer details such as nickname, discount, VIP status, or custom fields by external ID.
  - body: { by?: string, site?: string, externalId: string, customerCorporate: object }
- `POST https://api.mcp.ai/api/simla_com/edit/customers/corporate/address` — Tool to edit an address for a corporate customer. Use when you need to update address details (name, city, street, building, etc.) for a specific corporate customer address by its external ID.
  - body: { site?: string, address: object, externalId: string, entityExternalId: string }
- `POST https://api.mcp.ai/api/simla_com/edit/customers/corporate/company` — Tool to edit a company associated with a corporate customer. Use when you need to update company details such as name or main status for a corporate customer's company entity.
  - body: { by?: string, site?: string, company: object, entityBy?: string, externalId: string, entityExternalId: string }
- `POST https://api.mcp.ai/api/simla_com/edit/customers/corporate/contacts` — Tool to edit the link between a corporate customer and a contact person. Use when you need to update contact properties such as marking a contact as the main contact person for a corporate customer.
  - body: { by?: string, site?: string, contact: object, entityBy?: string, externalId: string, entityExternalId: string }
- `POST https://api.mcp.ai/api/simla_com/edit/delivery/generic/setting` — Tool to register or edit a delivery service integration configuration. Use when you need to create a new delivery service integration or update existing delivery settings including API endpoints, stat
  - body: { subcode: string, configuration: object }
- `POST https://api.mcp.ai/api/simla_com/edit/file` — Tool to edit an existing file by ID. Use when you need to update file properties such as filename.
  - body: { id: integer, file: object }
- `POST https://api.mcp.ai/api/simla_com/edit/integration/module` — Tool to create or edit an integration module configuration. Use when you need to register or update an integration module with its base URL, client ID, and display settings.
  - body: { code: string, integrationModule: object }
- `POST https://api.mcp.ai/api/simla_com/edit/order` — Tool to edit an existing order by external ID. Use when you need to update order details by external ID.
  - body: { site?: string, order: object, externalId: string }
- `POST https://api.mcp.ai/api/simla_com/edit/orders/payment` — Tool to edit an existing order payment. Use when you need to update payment details such as amount, status, or type.
  - body: { id: integer, payment: object }
- `POST https://api.mcp.ai/api/simla_com/edit/reference/cost/group` — Tool to edit an existing cost group by code. Use when you need to update cost group properties such as name, color, active status, or display ordering.
  - body: { code: string, costGroup: object }
- `POST https://api.mcp.ai/api/simla_com/edit/reference/cost/item` — Tool to edit an existing cost item reference by code. Use when you need to update cost item properties such as name, group, type, or activation status in the system's cost item directory.
  - body: { code: string, costItem: object }
- `POST https://api.mcp.ai/api/simla_com/edit/reference/courier` — Tool to edit an existing courier by ID. Use when you need to update courier details such as name, email, phone, or active status.
  - body: { id: integer, courier: object }
- `POST https://api.mcp.ai/api/simla_com/edit/reference/currency` — Tool to edit an existing currency configuration by ID. Use when you need to update currency properties such as base currency status, auto-conversion settings, or conversion rates.
  - body: { id: integer, currency: object }
- `POST https://api.mcp.ai/api/simla_com/edit/reference/delivery/service` — Tool to edit an existing delivery service by code. Use when you need to update delivery service properties such as name, code, or active status.
  - body: { code: string, deliveryService: object }
- `POST https://api.mcp.ai/api/simla_com/edit/reference/delivery/types` — Tool to create or edit a delivery type in Simla.com. Use when you need to add a new delivery type or modify an existing one. This endpoint handles both creation (if the code doesn't exist) and updates
  - body: { code: string, deliveryType: object }
- `POST https://api.mcp.ai/api/simla_com/edit/reference/order/method` — Tool to edit an existing order method reference by code. Use when you need to update order method properties such as name, active status, or default settings in the system's order method directory.
  - body: { code: string, orderMethod: object }
- `POST https://api.mcp.ai/api/simla_com/edit/reference/order/type` — Tool to create or edit an order type by code. Use when you need to create a new order type or update properties of an existing one such as name, active status, or default settings.
  - body: { code: string, orderType: object }
- `POST https://api.mcp.ai/api/simla_com/edit/reference/payment/status` — Tool to edit an existing payment status reference by code. Use when you need to update payment status properties such as name, active status, or default settings in the system's payment status directo
  - body: { code: string, paymentStatus: object }
- `POST https://api.mcp.ai/api/simla_com/edit/reference/payment/type` — Tool to edit an existing payment type or create a new one by code. Use when you need to update payment type properties such as name, code, active status, description, ordering, or default settings.
  - body: { code: string, paymentType: object }
- `POST https://api.mcp.ai/api/simla_com/edit/reference/price/type` — Tool to edit an existing price type in the reference data. Use when you need to update price type properties such as name, active status, default flag, or associated customer groups.
  - body: { code: string, name?: string, active?: boolean, groups?: string[], default?: boolean, currency?: string, ordering?: integer, description?: string, filterExpression?: string }
- `POST https://api.mcp.ai/api/simla_com/edit/reference/product/status` — Tool to create or edit product status in the reference directory. Use when you need to add a new product status or update an existing one. Set code to 'new' when creating a new status, or use the exis
  - body: { code: string, productStatus: object }
- `POST https://api.mcp.ai/api/simla_com/edit/reference/statuses` — Tool to edit an existing order status reference by code. Use when you need to update order status properties such as name, active status, display ordering, or group classification in the system's stat
  - body: { code: string, status: object }
- `POST https://api.mcp.ai/api/simla_com/edit/reference/stores` — Tool to create or edit a warehouse/store by code. Use when you need to update store information such as name, contact details, address, or active status.
  - body: { code: string, store: object }
- `POST https://api.mcp.ai/api/simla_com/edit/reference/subscription` — Tool to create or edit a subscription category in Simla. Use when you need to configure subscription categories for different communication channels (email, sms, waba). Creates a new subscription cate
  - body: { code: string, channel: string, subscription: object }
- `POST https://api.mcp.ai/api/simla_com/edit/reference/unit` — Tool to create or edit a unit of measurement reference by code. Use when you need to add new units or update existing unit properties such as name or symbol in the system's unit directory.
  - body: { code: string, unit: object }
- `POST https://api.mcp.ai/api/simla_com/edit/store/product/group` — Tool to edit an existing product group by external ID. Use when you need to update product group details such as name, site, or active status.
  - body: { externalId: string, productGroup: object }
- `POST https://api.mcp.ai/api/simla_com/edit/store/products/batch` — Tool to batch edit multiple products and services at once. Use when you need to update multiple products in a single operation. This action allows updating multiple product fields (name, price, quanti
  - body: { products: object[] }
- `POST https://api.mcp.ai/api/simla_com/edit/store/setting` — Tool to register or update warehouse system configuration in Simla. Use when you need to configure a warehouse integration with name, code, and account URL.
  - body: { code: string, configuration: object }
- `POST https://api.mcp.ai/api/simla_com/edit/task` — Tool to edit an existing task. Use after confirming task ID and fields to update. Updates only provided fields on the task.
  - body: { id: integer, task: object }
- `POST https://api.mcp.ai/api/simla_com/edit/telephony/setting` — Tool to create or edit a telephony integration setting in Simla. Use when you need to register or update a telephony integration with its configuration including client ID, name, active status, and op
  - body: { code: string, configuration: object }
- `POST https://api.mcp.ai/api/simla_com/fix/customers/corporate/external/ids` — Tool to perform mass recording of corporate customer external IDs in Simla. Use when you need to map internal corporate customer IDs to external system identifiers in bulk. Accepts an array of corpora
  - body: { customersCorporate: object[] }
- `POST https://api.mcp.ai/api/simla_com/fix/customers/external/ids` — Tool to perform mass recording of customer external IDs in Simla. Use when you need to map internal customer IDs to external system identifiers in bulk. Accepts an array of customer ID mappings and as
  - body: { customers: object[] }
- `POST https://api.mcp.ai/api/simla_com/fix/orders/external/ids` — Tool to perform mass recording of order external IDs in Simla. Use when you need to map internal order IDs to external system identifiers in bulk. Accepts an array of order ID mappings and assigns ext
  - body: { orders: object[] }
- `POST https://api.mcp.ai/api/simla_com/get/api/credentials` — Tool to retrieve available API methods and stores for the current API key. Use when you need to verify API permissions or discover which endpoints and sites are accessible.
- `POST https://api.mcp.ai/api/simla_com/get/api/versions` — Tool to retrieve a list of available API versions. Use when you need to discover which API versions are supported by the system.
- `POST https://api.mcp.ai/api/simla_com/get/cost` — Retrieves detailed information about a specific cost record by its ID. Use this when you need to fetch cost data including amount, dates, cost item, and attribution details before analyzing or updatin
  - body: { id: integer }
- `POST https://api.mcp.ai/api/simla_com/get/custom/field` — Tool to retrieve detailed information about a specific custom field by entity and code. Use when you need to get properties and settings of a particular custom field.
  - body: { code: string, entity: string }
- `POST https://api.mcp.ai/api/simla_com/get/custom/fields` — Tool to list custom fields. Use when retrieving custom field definitions with optional filtering by entity or code.
  - body: { page?: integer, limit?: integer, entity?: string, filter_code?: string, filter_type?: string }
- `POST https://api.mcp.ai/api/simla_com/get/custom/fields/dictionaries` — Tool to retrieve the list of custom dictionaries. Use when you need to get available custom directory definitions with their elements and codes.
  - body: { page?: integer, limit?: integer, filter_code?: string, filter_name?: string }
- `POST https://api.mcp.ai/api/simla_com/get/custom/fields/dictionary` — Tool to retrieve a custom fields dictionary by its code identifier. Use when you need to get detailed information about a specific dictionary including its name, code, and all elements.
  - body: { code: string }
- `POST https://api.mcp.ai/api/simla_com/get/customer` — Retrieves detailed information about a specific customer by ID or external ID. Returns comprehensive customer data including contact info, address, subscriptions, order statistics, and custom fields. 
  - body: { by?: string, site?: string, externalId: string }
- `POST https://api.mcp.ai/api/simla_com/get/customer/corporate` — Retrieves detailed information about a corporate customer by external ID. Returns comprehensive corporate customer data including tags, custom fields, order statistics, and discount information. Use t
  - body: { externalId: string }
- `POST https://api.mcp.ai/api/simla_com/get/customer/interaction/favorites` — Tool to retrieve a list of favorite product offers for a specific customer. Use when you need to fetch customer's saved favorites from a particular site.
  - body: { by?: string, site: string, customerId: string }
- `POST https://api.mcp.ai/api/simla_com/get/customers` — Tool to retrieve a list of customers. Use after setting optional filters (IDs, email, custom fields) to fetch paginated customer data.
  - body: { ids?: integer[], page?: integer, email?: string, limit?: integer, customFieldKey?: string }
- `POST https://api.mcp.ai/api/simla_com/get/customers/corporate` — Tool to retrieve a list of corporate customers matching the specified filters. Use after setting optional filters (managers, manager groups, discount card, IDs) to fetch paginated corporate customer d
  - body: { ids?: integer[], page?: integer, limit?: integer, managers?: integer[], externalIds?: string[], managerGroups?: string[], discountCardNumber?: string }
- `POST https://api.mcp.ai/api/simla_com/get/customers/corporate/companies` — Tool to retrieve the list of companies associated with a corporate customer contact person. Use when you need to see which companies are linked to a specific corporate customer.
  - body: { page?: integer, limit?: integer, externalId: string }
- `POST https://api.mcp.ai/api/simla_com/get/customers/corporate/history` — Tool to retrieve corporate customer change history for synchronization or audit purposes. Use when tracking corporate customer modifications over time or implementing incremental data sync with sinceI
  - body: { page?: integer, limit?: integer, endDate?: string, sinceId?: integer, startDate?: string, customerCorporateId?: integer, customerCorporateExternalId?: string }
- `POST https://api.mcp.ai/api/simla_com/get/customers/corporate/notes` — Tool to retrieve a list of corporate customer notes. Use when you need to fetch notes with optional filters (note IDs, corporate customer IDs, manager IDs, text search, date range) and pagination.
  - body: { ids?: integer[], page?: integer, text?: string, limit?: integer, managerIds?: integer[], createdAtTo?: string, customerIds?: integer[], createdAtFrom?: string, customerExternalIds?: string[] }
- `POST https://api.mcp.ai/api/simla_com/get/customers/history` — Tool to retrieve customer change history for synchronization or audit purposes. Use when tracking customer modifications over time or implementing incremental data sync with sinceId.
  - body: { page?: integer, limit?: integer, endDate?: string, sinceId?: integer, startDate?: string, customerId?: integer, customerExternalId?: string }
- `POST https://api.mcp.ai/api/simla_com/get/customers/notes` — Tool to retrieve a list of customer notes. Use when you need to fetch notes with optional filters (note IDs, customer IDs, manager IDs, text search, date range) and pagination.
  - body: { ids?: integer[], page?: integer, text?: string, limit?: integer, managerIds?: integer[], createdAtTo?: string, customerIds?: integer[], createdAtFrom?: string, customerExternalIds?: string[] }
- `POST https://api.mcp.ai/api/simla_com/get/delivery/generic/setting` — Tool to retrieve integration configuration for a delivery module instance. Use when you need to fetch delivery service settings including metadata, supported actions, and status mappings.
  - body: { subcode: string }
- `POST https://api.mcp.ai/api/simla_com/get/delivery/shipments` — Tool to retrieve a list of delivery shipments. Use when you need to fetch shipments with optional date filters and pagination.
  - body: { page?: integer, limit?: integer, filter_dateTo?: string, filter_dateFrom?: string }
- `POST https://api.mcp.ai/api/simla_com/get/files` — Tool to retrieve a list of files. Use when you need to fetch files with optional filters like IDs and pagination.
  - body: { ids?: integer[], page?: integer, limit?: string }
- `POST https://api.mcp.ai/api/simla_com/get/loyalty/accounts` — Tool to retrieve a list of customer loyalty program accounts. Use when you need to fetch loyalty accounts with optional filters (loyalty program IDs, phone number) and pagination.
  - body: { page?: integer, limit?: integer, loyalties?: integer[], phoneNumber?: string }
- `POST https://api.mcp.ai/api/simla_com/get/loyalty/bonus/operations` — Tool to retrieve the history of bonus account operations for all participations. Use when you need to fetch loyalty bonus transaction history with optional date range and type filters.
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/simla_com/get/loyalty/loyalties` — Tool to retrieve a list of loyalty programs. Use when you need to fetch available loyalty programs with optional pagination.
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/simla_com/get/order` — Tool to retrieve detailed information about a specific order. Use when you need to fetch full order data by external ID before further processing.
  - body: { external_id: string }
- `POST https://api.mcp.ai/api/simla_com/get/orders` — Tool to retrieve a list of orders. Use when you need to fetch orders with optional filters (order numbers, custom fields) and pagination.
  - body: { page?: integer, limit?: integer, numbers?: string[], customFields?: object }
- `POST https://api.mcp.ai/api/simla_com/get/orders/history` — Tool to retrieve order change history. Use when you need to track changes to orders over time with optional date filters and pagination via sinceId.
  - body: { page?: integer, limit?: integer, filter_sinceId?: integer, filter_startDate?: string }
- `POST https://api.mcp.ai/api/simla_com/get/orders/packs/history` — Tool to retrieve the history of order packing changes. Use when you need to track pack status updates, modifications, or apply warehouse system synchronization. Call without parameters initially, then
  - body: { page?: integer, sinceId?: integer }
- `POST https://api.mcp.ai/api/simla_com/get/products` — Tool to retrieve a list of products. Use when you need to list products with optional filters.
  - body: { ids?: integer[], name?: string, page?: integer, limit?: integer, active?: boolean, quantity?: integer, max_price?: number, min_price?: number, external_id?: string, created_at_to?: string, updated_at_to?: string, created_at_from?: string, updated_at_from?: string }
- `POST https://api.mcp.ai/api/simla_com/get/reference/cost/groups` — Tool to retrieve a list of all cost groups configured in the system. Use when you need to discover available cost groups for organizing expenses or costs.
- `POST https://api.mcp.ai/api/simla_com/get/reference/cost/items` — Tool to retrieve a list of all cost items configured in the system. Use when you need to discover available cost item codes for order or operation cost tracking.
- `POST https://api.mcp.ai/api/simla_com/get/reference/countries` — Tool to retrieve a list of all available country ISO codes in the system. Use when you need to discover available countries for order or customer creation.
- `POST https://api.mcp.ai/api/simla_com/get/reference/couriers` — Tool to retrieve the list of available couriers. Use when you need to fetch courier information or get courier codes for deliveries.
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/simla_com/get/reference/currencies` — Tool to retrieve the list of all configured currencies in the system. Use when you need to discover available currencies for order creation or financial operations.
- `POST https://api.mcp.ai/api/simla_com/get/reference/delivery/services` — Tool to retrieve a list of all configured delivery services in the system. Use when you need to discover available delivery services for order creation or to get delivery service codes.
- `POST https://api.mcp.ai/api/simla_com/get/reference/delivery/types` — Tool to retrieve the list of delivery types from the system. Use when you need to discover available delivery types for order management or to get delivery type codes.
- `POST https://api.mcp.ai/api/simla_com/get/reference/legal/entities` — Tool to retrieve a list of all configured legal entities in the system. Use when you need to get available legal entity codes or legal entity details for business operations.
- `POST https://api.mcp.ai/api/simla_com/get/reference/mg/channels` — Tool to retrieve a list of all MessageGateway channels in the system. Use when you need to discover available messaging channels for communication.
- `POST https://api.mcp.ai/api/simla_com/get/reference/order/methods` — Tool to retrieve a list of all available order methods in the system. Use when you need to discover available order methods for order creation or to get order method codes.
- `POST https://api.mcp.ai/api/simla_com/get/reference/order/types` — Tool to retrieve the list of order types from the system. Use when you need to discover available order types for order management or to get order type codes.
- `POST https://api.mcp.ai/api/simla_com/get/reference/payment/statuses` — Tool to retrieve the list of payment statuses configured in the system. Use when you need to discover available payment statuses or get payment status codes.
- `POST https://api.mcp.ai/api/simla_com/get/reference/payment/types` — Tool to retrieve a list of all configured payment types in the system. Use when you need to discover available payment methods for orders or to get payment type codes.
- `POST https://api.mcp.ai/api/simla_com/get/reference/price/types` — Tool to retrieve the list of price types from the reference data. Use when you need to discover available price types for order or product pricing.
- `POST https://api.mcp.ai/api/simla_com/get/reference/product/statuses` — Tool to retrieve the list of all product statuses configured in the system. Use when you need to discover available product statuses for order items or to get status codes.
- `POST https://api.mcp.ai/api/simla_com/get/reference/status/groups` — Tool to retrieve the list of all order status groups in the system. Use when you need to discover available status groups for order processing or categorization.
- `POST https://api.mcp.ai/api/simla_com/get/reference/statuses` — Tool to retrieve the list of order statuses from the system. Use when you need to discover available statuses for order management or to get status codes.
- `POST https://api.mcp.ai/api/simla_com/get/reference/subscriptions` — Tool to retrieve the list of all subscription categories in the system. Use when you need to discover available subscription channels (email, sms, waba) and their configuration.
- `POST https://api.mcp.ai/api/simla_com/get/reference/units` — Tool to retrieve the list of units of measurement from the system. Use when you need to discover available units for product management or to get unit codes.
- `POST https://api.mcp.ai/api/simla_com/get/segments` — Tool to retrieve a list of customer segments. Use when you need to list segments with optional filters after authentication.
  - body: { page?: integer, site?: string, limit?: integer, filter_name?: string, filter_active?: boolean }
- `POST https://api.mcp.ai/api/simla_com/get/settings` — Tool to retrieve system settings including default currency, language, timezone, and message gateway configuration. Use when you need to discover system-wide configuration or settings for the account.
- `POST https://api.mcp.ai/api/simla_com/get/sites` — Tool to retrieve a list of all configured sites/stores in the system. Use when you need to discover available sites for order creation or to get site codes.
- `POST https://api.mcp.ai/api/simla_com/get/statistic/update` — Tool to trigger an update of CRM basic statistics. Use when you need to refresh statistical data in the system.
- `POST https://api.mcp.ai/api/simla_com/get/store/inventories` — Tool to retrieve store inventories with leftover stocks and purchasing prices. Use when you need to check inventory levels across warehouses or get cost pricing information for offers.
  - body: { page?: integer, limit?: integer, filter_ids?: integer[], filter_details?: integer, filter_product_active?: integer }
- `POST https://api.mcp.ai/api/simla_com/get/store/offers` — Tool to retrieve a list of store offers with pagination support. Use when you need to fetch available offers from the store catalog.
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/simla_com/get/store/products/properties` — Tool to retrieve a list of product properties from the store. Use when you need to fetch product property definitions with pagination support.
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/simla_com/get/store/products/properties/values` — Tool to retrieve product property values from the store. Use when you need to list property values with optional filters.
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/simla_com/get/stores` — Tool to retrieve a list of all warehouses/stores in the system. Use when you need to discover available stores for inventory management or order fulfillment.
- `POST https://api.mcp.ai/api/simla_com/get/task` — Retrieves detailed information about a specific task by its ID. Use this to view task details including description, deadline, completion status, assigned performer, and related entities (orders, cust
  - body: { id: integer }
- `POST https://api.mcp.ai/api/simla_com/get/tasks` — Tool to retrieve a list of tasks with optional filters. Use when you need to fetch tasks after specifying filter criteria like IDs, status, or date range.
  - body: { ids?: integer[], limit?: integer, expand?: string[], filter?: object[], offset?: integer, status?: string, orderIds?: integer[], createdAtTo?: string, createdAtFrom?: string, responsibleUserIds?: integer[] }
- `POST https://api.mcp.ai/api/simla_com/get/tasks/comments` — Tool to retrieve comments on a specific task by task ID. Use when you need to view all comments associated with a task for context, collaboration, or audit purposes.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/simla_com/get/tasks/history` — Tool to retrieve task change history. Use when you need to track changes to tasks over time. Use sinceId for incremental synchronization.
  - body: { sinceId?: integer }
- `POST https://api.mcp.ai/api/simla_com/get/telephony/setting` — Tool to retrieve telephony integration settings by code. Use when you need to fetch configuration details for a specific telephony integration.
  - body: { code: string }
- `POST https://api.mcp.ai/api/simla_com/get/user` — Tool to retrieve detailed information about a specific user by ID. Use when you need complete user data for a known user identifier.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/simla_com/get/user/groups` — Tool to retrieve a list of user groups with their permissions and configuration. Use when you need to fetch available user groups with optional pagination.
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/simla_com/get/users` — Tool to retrieve a list of users. Use when you need to fetch users with optional pagination, filtering, and sorting.
  - body: { page?: integer, limit?: integer, sortBy?: string, sortOrder?: string, externalId?: string, createdAtTo?: string, customField?: string, createdAtFrom?: string }
- `POST https://api.mcp.ai/api/simla_com/update/customer/subscriptions` — Tool to subscribe or unsubscribe a customer to mailing channels. Use when you need to manage customer communication preferences across different channels (email, SMS, WhatsApp, etc.).
  - body: { externalId: string, subscriptions: object[] }
- `POST https://api.mcp.ai/api/simla_com/update/user/status` — Tool to change a user's status. Use when you need to update a user's current work status.
  - body: { id: integer, status: string }
- `POST https://api.mcp.ai/api/simla_com/upload/costs` — Tool to batch upload cost records to Simla CRM. Use when you need to create multiple cost entries at once for tracking expenses like advertising, salaries, or other operational costs. Maximum 50 costs
  - body: { costs: object[] }
- `POST https://api.mcp.ai/api/simla_com/upload/customers` — Tool to batch upload customer records to Simla CRM. Use when you need to create multiple customers at once. Maximum 50 customers per request.
  - body: { site?: string, customers: object[] }
- `POST https://api.mcp.ai/api/simla_com/upload/customers/corporate` — Tool to batch upload corporate customers to Simla.com CRM. Use when you need to create multiple corporate customer records at once with their companies, contacts, and addresses. Maximum 50 customers p
  - body: { customersCorporate: object[] }
- `POST https://api.mcp.ai/api/simla_com/upload/orders` — Upload multiple orders to Simla in a single batch operation. Use when you need to create multiple orders efficiently (up to 50 per request). Each order requires an externalId and at least one item wit
  - body: { site?: string, orders: object[] }
- `POST https://api.mcp.ai/api/simla_com/upload/store/prices` — Tool to batch update SKU prices in Simla store catalog. Use when you need to set or update prices for product offers. Can also remove specific price types using the remove flag.
  - body: { prices: object[] }
- `POST https://api.mcp.ai/api/simla_com/upload/web/analytics/client/ids` — Tool to batch upload web analytics client IDs to Simla CRM for tracking purposes. Use when you need to associate Google Analytics (or other web analytics) client IDs with orders and customers in the s
  - body: { clientIds: object[] }
- `POST https://api.mcp.ai/api/simla_com/upload/web/analytics/sources` — Tool to batch upload web analytics sources to Simla CRM. Use when tracking traffic sources for orders or customers from marketing campaigns. Each source must include at least one identifier (order, cu
  - body: { sources: object[] }

## Example prompts
- "What can I do in Simla.com?"
- "Show me a summary of my Simla.com account"

## More
- Page: https://mcp.ai/simla_com
- Agent spec (llms.txt): https://mcp.ai/simla_com/llms.txt
- Postman collection: https://mcp.ai/simla_com/postman.json