Skip to content
MCP server

Obriym CRM

Operate leads, deals, orders, stock and marketplace listings of Obriym CRM by chat

Status and history

Answered our latest tool-list check 21 hours ago with 165 tools. It will be marked verified after 3 successful checks in 7 days.

Pricing
Freemium
Platforms
Web, API
Runs
Remotely
Version
1.34.1
Listing updated
3 days ago

About Obriym CRM

Obriym CRM is a freemium MCP server for sales and crm. It runs as a hosted remote server, so there is nothing to install locally.

The assistant connects to one workspace after you choose it, and until you do the connection stays locked and reads nothing. From there it can answer questions such as which deals went quiet or which orders are unpaid, log calls, move deals between stages, assign enquiries, change order status and correct stock counts with a stated reason. Every change is written to the audit log as if a person had made it.

It also reaches into the shop side: checking whether a marketplace connection is alive, preparing an eBay draft with price and item specifics, previewing bulk price changes (including whether anything would sell below cost), adding product photos, translating catalogue text, and drafting or scheduling posts to Telegram, Instagram, Facebook and LinkedIn. Publishing to eBay or social channels and applying bulk price changes each need the workspace owner to enable them first, and it archives products rather than deleting them.

Sign-in uses OAuth with your Obriym account, or a workspace token for server-side automation. Interface languages shown include Ukrainian, English and Italian.

Install

Run in a terminal

claude mcp add --transport http mcp https://obriym-crm.com/api/mcp

Add to Settings → Connectors → Add custom connector

https://obriym-crm.com/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://obriym-crm.com/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://obriym-crm.com/api/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://obriym-crm.com/api/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://obriym-crm.com/api/mcp"
    }
  }
}

Tools this server provides (165)

Read directly from the server.

search_leads
List and search this workspace's leads, filtered by text/status/source/created-date/stale and paginated. Returns summary rows (id, name, contact, company, status, source, assignee, tags, next-action, isStale, timestamps) plus pagination { page, perPage, total }, newest first. Use get_lead to fetch notes, position and score for one lead by id.
get_lead
Fetch one CRM lead in the selected workspace by lead id, including status, source, assignee, tags, custom fields, score, notes and next action. Use search_leads first when you only know a name, email, phone or company.
list_conversations
List customer conversations across every connected channel (Instagram, Messenger, WhatsApp and comments, Telegram, OLX, Prom, eBay, Threads replies, the B2B portal, buyer order pages …). One row per lead and channel, newest first: { leadId, leadName, channel, lastMessageAt, lastMessageText (first 300 characters), lastDirection (inbound = from the customer), awaitingReply (the customer wrote last)
get_lead_conversation
Read one lead's customer messages, oldest to newest: { at, channel, direction (inbound = from the customer, outbound = sent by the business), text (up to 2000 characters; truncated is true when cut), media ({ kind, contentType, name } or null — the file itself is never returned) }. A person who writes on two channels has two separate conversations: pass channel to read one, omit it to get all chan
search_deals
List and search pipeline deals, filtered by stage/owner/company/contact/stale and paginated. Returns summary rows (id, title, stage, amount, probability, owner, company, contact, next-action, isStale) plus pagination { page, perPage, total }. Use get_deal to fetch one deal's full detail by id.
get_deal
Fetch one pipeline deal in the selected workspace by deal id, including stage, value, probability and linked company/contact data when present. Use search_deals first when you only know the title or related customer.
list_orders
List this workspace's orders, filtered by status/customer/created-date and paginated. Returns summary rows (externalId, status, currency, totalAmount, itemCount, timestamps, shipByAt: nullable ISO ship-by deadline) plus pagination { page, perPage, total }, newest first. Use get_order to fetch one order's full detail (line items, payments, shipments, returns) by externalId.
get_order
Fetch full order detail in the selected workspace by externalId, including line items, payments, shipments, returns and shipByAt (recorded ISO ship-by deadline, or null when unknown; not the actual dispatch time). Use list_orders first when you only know the customer or date.
search_products
List and search catalog products (active unless status says otherwise: draft, archived or any), filtered by text (name or SKU), barcode (barcode or EAN/GTIN) or having none (withoutBarcode), category/brand/collection/model (productGroupId — the other colours and sizes of one model)/size/color/stock/tag/type, by price in a given currency (priceCurrency with minPrice/maxPrice, read through the produ
get_product
Fetch one catalog product in the selected workspace by product id or SKU — returned in any status (draft, active, or archived; check the status field) — with every catalog field: prices, cost, stock and trackInventory, availability, variant fields, all attributes (characteristics) and translations, identifiers, weight and dimensions, images, videos, bundle components and related products; plus its
get_dashboard_overview
Return the operational 'what needs attention today' snapshot for this workspace: active/qualified/stale lead counts, pipeline value, weighted forecast and overdue activities. Takes no arguments. Use get_report for period trend analytics instead.
get_report
Return one aggregated analytics report over a period for this workspace, selected by the report parameter: lead_source_conversion, pipeline_velocity, team_performance, revenue_trend, product_sales (units, revenue and gross margin per brand/category/SKU) or stock_valuation (units on hand and their value per warehouse, per cost currency). Each returns aggregated rows (no per-record data); days tunes
search_contacts
List and search this workspace's contacts, filtered by company/owner/tag, sorted and paginated. Returns summary rows (id, firstName, lastName, email, phone, jobTitle, company, owner, tags) plus pagination { page, perPage, total }. Use get_contact to fetch one contact's full detail by id.
get_contact
Fetch one CRM contact in the selected workspace by contact id, including company, owner, tags and communication fields when present. Use search_contacts first when you only know a name, email or phone.
search_companies
List and search this workspace's companies, filtered by industry/status/owner, sorted and paginated. Returns summary rows (id, name, industry, size, status, owner, contactCount) plus pagination { page, perPage, total }. Use get_company to fetch one company's full detail by id.
get_company
Fetch one CRM company in the selected workspace by company id, including status, industry, owner and contact links when present. Use search_companies first when you only know the company name.
list_activities
List this workspace's activities (tasks, calls, meetings, emails, notes), filtered by type/assignee/overdue/completion/linked-entity and paginated. Returns summary rows (id, type, title, priority, dueDate, completed, assignee, linked lead/contact/company/deal, isOverdue) plus pagination { page, perPage, total }. Use get_activity to fetch one activity's full detail by id.
get_activity
Fetch one CRM activity in the selected workspace by activity id, including type, due date, completion state, assignee and linked entity. Use list_activities first when you only know the related lead/deal/contact.
list_customers
List CRM customers: companies that bought — a purchase order (processing, ready to ship, shipped, delivered or refunded, or with a settled payment) or a won deal that never became an order. Filter by health, lifetime-value bucket, owner, name search or minimum won deals; sorted by lifetime value and paginated. Returns summary rows (id, name, health, lifetimeValue = completed-order revenue plus won
get_customer
Fetch one CRM customer summary in the selected workspace by company id: a company that bought (a purchase order — processing, ready to ship, shipped, delivered or refunded, or with a settled payment — or a won deal that never became an order). Returns health, lifetimeValue (completed-order revenue plus won deals without an order), purchases (purchase orders plus won deals without an order), repeat
list_people_customers
List people (CRM contacts) who bought without a company — shop buyers: a purchase order without a company (processing, ready to ship, shipped, delivered or refunded, or with a settled payment) or a won deal of theirs without a company that never became an order. A company's purchases never count for the person who represents it. Filter by health, lifetime-value bucket, repeat (two or more purchase
get_person_customer
Fetch one person who bought without a company, by contact id: health, lifetimeValue (completed-order revenue plus won deals without an order), purchases, repeat, firstPurchaseAt, lastPurchaseAt and contact details. Read-only; a contact who never bought without a company is not found. Use list_people_customers or search_contacts first when you only know the name, email or phone; use get_customer fo
list_categories
List this workspace catalog categories as a flat array, each with id, name, slug, parentId (null for a root category), description, googleProductCategory, imageUrl, translations and marketplaceCategories (the Prom, Rozetka, OLX, Amazon and Google Merchant category ids already linked, each as { id, label } or null). Categories are workspace-global, not per warehouse. Use a category id here as the c
get_category
Fetch one catalog category by id: name, slug, parent, description, image, translations, the linked marketplace category ids (marketplaceCategories: Prom, Rozetka, OLX, Amazon, Google Merchant, each { id, label } or null), its direct subcategories (children), and productCount and subcategoryCount. Read-only. Use list_categories first to find the id, and call this before delete_category to see what
search_marketplace_categories
Find the category id a marketplace uses, to link it to a catalog category. Read-only. Pass the platform (prom, rozetka, olx, amazon, google_merchant or etsy) and a query, or for OLX, Rozetka and Etsy a parentId to browse one level of the tree (no query and no parentId lists the top level). Sources differ: Google Merchant searches the bundled Google product taxonomy and needs no connection; Etsy se
list_brands
List this workspace catalog brands with id, name, description and website. Use a brand id here as the brandId for create_product/update_product, or as the search_products brand filter.
list_warehouses
List this workspace warehouses with id, name, description, phone, address (the street line), country (ISO code), city, postalCode, workingHours (free text) and pickupEnabled (whether the warehouse is offered as a self-pickup point). A product lives in at most one warehouse, and the warehouse decides the inventory-tracking default and which sales channels new products are listed on. Use a warehouse
list_marketplaces
List every marketplace connected to this workspace with its setup state, health, last activity, any current sync error with `problem` (its kind, whether a person must reconnect the account, and what to do), `partialFailure` ({ failed, sent, sample, whatToDo }) when the last run reached the marketplace but part of it was refused (health stays active for that, so check it), orders revenue per curren
get_marketplace
Fetch one connected marketplace in detail: every adapter on it with its setup state, last poll, last poll error, last catalog-sync outcome (`sync`, whose `lastSuccessAt` is the last run without a connection error — it survives failures, so it says how long a channel has been broken; `notAttempted` counts matched listings the run had no time left for and `truncated` true means not every listing was
list_channel_products
List the products that are on one marketplace, with each listing external id, what the marketplace last reported about it (`presence`, valid only when `observedAt` is set — null `observedAt` means the marketplace has never been asked about that listing, not that it is absent; Prom is reconciled every 15 minutes, other channels only when a sync or publish runs), whether the workspace paused syncing
check_channel_readiness
Check locally which products a marketplace will refuse and why — missing price, unusable price, blank name, unmapped category — grouped by what fixes them, without calling the marketplace. The response separates `blocked` (these products do NOT go out) from `warnings` (these DO go out, but probably will not be published as the merchant expects: a price in a currency the platform does not name, no
get_channel_sync_report
Report which products of one marketplace channel were reached by the last syncs and which were not, and why — from stored state, without calling the marketplace. Per product on the channel: state (attention = the marketplace reported a problem with the listing; never_sent = nothing recorded as sent, or no listing is linked; changed_since_sent = the product changed after it was last sent; paused =
get_workspace_info
Show which account and workspace this connection operates: signed-in name/email (OAuth only), workspace name, plan, connection type and granted scopes — what this connection may do right now (capabilities: aiSwitches, the owner's switches for AI marketplace publishing, social publishing, bulk price changes and bulk translation, each with allowedNow = switch on AND scope granted; marketplaces, each
get_obriym_product_facts
Read-only facts about Obriym CRM itself: approved marketing claims, conditions, limitations, review sources, plan prices/limits and integration scenarios/readiness with beta caveats; no customer data or external calls, and implementation review does not establish workspace configuration or customer results (empty assets means no screenshot supplied). Call before writing about Obriym, narrow by top
create_lead
Create a lead. Idempotent by externalId (re-sending the same externalId returns the existing lead). Requires an email or phone. Enforces the workspace plan limit; the result echoes the workspace it landed in. Use update_lead to change it afterward.
update_lead
Update fields on an existing lead by id. Provide a patch with at least one field. Use search_leads first to find the lead id. The result echoes the operating workspace.
create_deal
Create a pipeline deal. Requires a stageId, title, and next-action note. Use list_pipeline_stages for the stageId, and search_companies/search_contacts to link a company or contact. Enforces the workspace plan limit; the result echoes the operating workspace.
create_activity
Create an activity (task, call, meeting, email, or note). Must link to at least one lead, contact, company, or deal — use search_leads/search_contacts/search_companies/search_deals to get the entity id. The result echoes the operating workspace.
update_order_status
Move an order to a new status by externalId. Only valid transitions from the current status are allowed. Use list_orders to find the externalId and get_order to see the current status. The result echoes the operating workspace.
create_contact
Create a contact (person). Use search_companies for the companyId to link an employer. Enforces the workspace plan limit and validates the company/owner links; the result echoes the operating workspace.
update_contact
Update fields on a contact by id. Provide a patch with at least one field. Use search_contacts first to find the contact id. The result echoes the operating workspace.
create_company
Create a company (B2B account). The company name must be unique in the workspace. representationState is explicitly declared (unspecified, works_alone, or has_representatives), never inferred from contacts; an individual always uses unspecified. Enforces the workspace plan limit; the result echoes the operating workspace. Use search_companies first to avoid creating a duplicate.
update_company
Update fields on a company by id. Provide a patch with at least one field. representationState is explicit and never inferred from contacts. primaryContactId can select an existing contact already linked to this same non-individual company; send null to clear it. Use search_companies first to find the company id. The result echoes the operating workspace.
complete_activity
Mark an activity (task, call, or meeting) as completed by its id. Use list_activities first to find the activity id. The result echoes the operating workspace.
convert_lead
Convert a lead into a contact, company, and/or deal (select at least one via the input flags). Sets the lead status to converted. Use search_leads first to find the lead id. The result echoes the operating workspace.
assign_lead
Assign a lead to a workspace member by user id, or pass assignedTo=null to unassign. Use search_leads to find the lead id and get_workspace_info to confirm the operating workspace. The result echoes the operating workspace.
transition_deal
Move a deal to a pipeline stage by its id. Closed-lost stages require a lostReason. Use search_deals for the deal id and list_pipeline_stages for the target stageId. The result echoes the operating workspace.
quote_order_promotion
Validate a known promo code against trusted cart prices, currency and buyer facts. Returns the CRM-calculated discount, net order total and delivery terms without creating an order or reserving a use. The code must be enabled for this connection's source; a personal or capture code also needs the same buyer email (or customer.externalId of a profile with it). reservesUse is false: nothing is claim
create_order
Create an order with line items. Currency is required: use trusted source facts or CRM product prices; never guess or convert. Idempotent by externalId: re-sending the same request returns the existing order. Counts toward the plan's monthly order limit (403 PLAN_LIMIT_EXCEEDED when reached). The result echoes the operating workspace. Use search_products first. For a promo code use quote_order_pro
add_order_item
Add a line item to an existing order by its externalId. Recomputes the order total. Only allowed while the order is pending or confirmed; on any other status (processing and later, cancelled, refunded) it fails with 409 CONFLICT "Order lines can only be changed while the order is pending or confirmed". Use list_orders or create_order for the order externalId, and search_products to quote a real pr
update_order_item
Update a line item on an order (quantity, unit price, discount, name, or SKU). Recomputes the order total. Only allowed while the order is pending or confirmed; otherwise it fails with 409 CONFLICT "Order lines can only be changed while the order is pending or confirmed" (stock is committed from processing on). Use get_order to find the order's externalId and the item's itemId. The CRM recalculate
remove_order_item
Remove a line item from an order. Recomputes the order total. Only allowed while the order is pending or confirmed; otherwise it fails with 409 CONFLICT "Order lines can only be changed while the order is pending or confirmed". Use get_order to find the order's externalId and the item's itemId. The result echoes the operating workspace.
create_product
Create a catalog product. Defaults to draft status — publish it by sending status 'active' once it is complete. Use list_categories, list_brands and list_warehouses for the ids; SKU is generated when omitted and must be unique in the workspace. Set trackInventory with an opening stock to start counting units, which is recorded as the first movement in the product stock history. A bundle (type bund
update_product
Update fields on an existing catalog product by id — including status, to publish a draft or archive a product. Provide a patch with at least one field; use get_product first to see the current values. A changed stock number is applied as a relative movement and recorded in the product stock history; prefer adjust_stock when the intent is a correction with a reason. A bundle's stock is derived fro
create_category
Create a catalog category, optionally nested under an existing one, with optional description and per-language translations. The slug is normalized to Latin whatever is sent. The parent must exist in this workspace, and a name already used under the same parent is rejected, so call list_categories first to avoid duplicates. To link marketplace categories send marketplaceCategories ({ prom, rozetka
update_category
Update fields on an existing catalog category by id: name, parent, slug, description, Google category, marketplaceCategories and translations. Provide a patch with at least one field; use list_categories first to find the id and current values. The slug is normalized to Latin. The parent must exist in this workspace and cannot create a loop. Translations REPLACE the whole set when sent (an empty a
delete_category
Permanently delete ONE catalog category by id. Its products are NOT deleted but lose this category (so they also drop out of marketplace feeds that require a category); its subcategories move to the top level; its translations and linked marketplace category ids are removed. NOT reversible. Not idempotent in effect: a second call for the same id returns NOT_FOUND. Call get_category first to read p
create_brand
Create a catalog brand with optional description, website and per-language description translations. The brand NAME is never translated: marketplaces match the vendor name verbatim, so send it exactly as the vendor is known. The slug is normalized to Latin. A name already used in this workspace is rejected, so call list_brands first to avoid duplicates. Translate only the brand's own description —
update_brand
Update fields on an existing catalog brand by id: name, slug, description, website and description translations. Provide a patch with at least one field; use list_brands first to find the id and current values. Renaming a brand changes the vendor name sent to marketplaces, so rename only on the user's explicit request; the name is never translated. Translations REPLACE the whole set when sent (an
adjust_stock
Move a product stock by a relative delta (negative to write off, positive to add) with a reason, and record it in the stock history. This is the correct tool for a correction, a write-off or damage — it never sets an absolute number, so an order committing at the same moment is not overwritten. The reason decides the direction: write_off, damage and return_to_supplier must carry a negative delta,
list_pipeline_stages
List this workspace's pipeline stages in order, with each stage's id, name, kind, default probability, WIP limit and position. Use configure_pipeline to change a stage, and the stage id here as the stageId for create_deal / transition_deal.
configure_pipeline
Update an existing pipeline stage's name, default probability, or WIP limit. Provide the stage id (from list_pipeline_stages) and ONLY the fields to change — omitted fields keep their current value; wipLimit null removes the limit. A name cannot be blank and must be unique among stages (409 CONFLICT otherwise). Stages cannot be created here, and stage order and terminal behavior are fixed. The res
list_lead_sources
List this workspace's lead sources (built-in plus custom), with each source's key, label and active state. Pass includeInactive to also return archived sources. Use set_lead_sources to add or archive a source; use a source key here as the source filter for search_leads.
set_lead_sources
Create or update a workspace lead source: set its label and active state by key (built-in or custom, lowercase_with_underscores). Idempotent — re-sending the same key updates it. Archiving the fallback 'other' source is not allowed. Use list_lead_sources to see current sources. The result echoes the operating workspace.
list_workspaces
List every workspace the connected user belongs to (id, name, role) and mark which one this connection currently operates. OAuth sign-in connections only. Use select_workspace to switch.
select_workspace
Re-bind this OAuth connection to the workspace selected by the user. Takes effect on the next tool call. Use the organizationId returned by list_workspaces or by WORKSPACE_SELECTION_REQUIRED; never invent or guess it.
inspect_ebay_listings
Check up to 25 products against eBay before any write, with the same live preflight the CRM's eBay channel page and the real draft and publish calls run. Per product it returns the eBay state (off, member, draft, live, ended), nextAction (create_draft, publish_draft or none), whether that step is ready and, when not, the blocking reason with details. ebayDraftSetup lists the armed eBay sites and t
inspect_amazon_listings
Report how the workspace's Amazon offers stand for a buyer and what Amazon says is wrong with them. Per product linked to an Amazon listing: stage (active; search_suppressed = buyable but hidden from search, usually no main image; inactive = Seller Central's 'Non attivo'; no_offer = the listing exists but Amazon shows no offer on it yet (Seller Central's 'Offerta mancante'), usual for a few hours
preview_amazon_listing_content
Preview selected listing data on up to 25 EXISTING Amazon offers using Amazon VALIDATION_PREVIEW; no offer changes. Parts select photos, GPSR contacts, Amazon texts, safety documents, shipping settings, missing attributes, or the opt-in measurements refresh. Rows report status (ready, nothing, blocked, rejected, failed), attributes, issues, skipped, filled, stillMissing and untranslated. Measureme
upsert_product_prices
Add, update or REMOVE the price-list rows of ONE product — the price it sells at in another currency, for example EUR for an eBay site — keeping its other currencies and its own workspace-currency price. Send only an amount the user stated: never a converted or estimated price; to drop a currency send its code in remove. The product's own currency is refused; change that with update_product's pric
upsert_product_attributes
Add or update characteristics (name, value, unit) on ONE product without removing the ones not named. Names match case-insensitively; a new name is appended. For eBay, use the item-specific names exactly as inspect_ebay_listings reported them (details.aspects), in the eBay site's own language — 'Marca' on ebay.it, not 'Brand'. Never invent a value: ask the user. Saves through the same product-card
upsert_product_translation
Write ONE language of ONE product's translation — title, description, keywords, colour, material, pattern and its characteristics (attributes: keyed by the characteristic's name exactly as get_product returns it, each with a translated name and/or value) in that language — keeping the other languages and every field not named. A characteristic name the product does not have is refused with the lis
archive_products
Archive up to 100 products — this is how an AI client removes a product. It leaves sale and every sales channel's feed, and nothing is erased: update_product with status active or draft restores it. Hard deletion is not available over MCP. A product that a non-archived bundle is made of is NOT archived: it is listed in heldByBundle with the bundles that contain it — archive or change those bundles
update_amazon_listing_content
Send selected listing data to up to 25 EXISTING Amazon offers. Real external writes under the owner-armed content direction and AI publishing gate; no new listing is created. The default six parts keep their behavior: photos, GPSR, Amazon texts, safety documents, shipping, and fill-only attributes. Explicit parts ["measurements"] refreshes changed item/package weight and dimensions only: preview_a
set_channel_membership
Mark or unmark up to 100 products for one connected sales channel (prom, rozetka, ebay, olx, …). It changes what the CRM intends to send: on Prom and Rozetka the next feed pull adds or drops the product; on eBay it only makes the product a channel member — a listing exists only after create_ebay_drafts and publish_ebay_drafts. It never arms a sync. Adding picks up active products only. Returns { a
push_google_merchant_catalog
Send this workspace's catalog, or just the products you name, to Google Merchant Center now — the same as the "Update now" button on the Google Merchant channel page. It is a REAL write to Google: products become or stay visible in Google Shopping. It runs only the product push the owner has ALREADY armed on the connection (otherwise it is refused) and only after the owner accepted Google's terms;
create_ebay_drafts
Create eBay DRAFT offers for up to 25 products — real writes to the seller's eBay account, but nothing is buyer-visible until publish_ebay_drafts. Run inspect_ebay_listings first and pass only products whose nextAction is create_draft and ready is true. Each product is attempted on its own: returns created, failed (each with a reason to look up in remediation.ebayPlaybook) and notAttempted (not re
publish_ebay_drafts
Make the eBay DRAFT offers of up to 25 products LIVE and buyer-visible — a real publication on the seller's account. The item and offer are refreshed from the current product first, so a price, title, photo or characteristic fixed after the draft was made is published too. Pass only products whose nextAction from inspect_ebay_listings is publish_draft. Returns done, failed (with reasons) and notAt
recreate_ebay_drafts
Delete each product's eBay draft and create a fresh one from its current data, for up to 25 products. Needed only when a draft must move to another category or eBay site, or the reason is ebayDraftOfferMissing or ebayNoOfferId — ordinary edits are picked up by publish_ebay_drafts. A live listing is refused. If the delete succeeds but the new draft fails, that product is left with no draft and its
delete_ebay_drafts
Delete the eBay DRAFT offer of up to 25 products; a live listing is refused — end it with withdraw_ebay_listings first. The CRM product itself is untouched. Works even while draft creation is disarmed on the connection, but still needs the owner's AI publishing switch. Returns done, failed and notAttempted. The result echoes the workspace.
withdraw_ebay_listings
End the LIVE eBay listing of up to 25 products: they stop being buyer-visible and their offers return to drafts — nothing is deleted, and publish_ebay_drafts can put them back. Needs the owner's AI publishing switch. Returns done, failed and notAttempted. The result echoes the workspace.
check_amazon_readiness
Ask Amazon whether up to 25 products could be listed now — the same check as the Amazon channel page: the offline requirements (product type on the category, brand, a photo, the condition, a title of at most 75 characters), the price in the marketplace's currency, then Amazon's own dry run (VALIDATION_PREVIEW), which creates nothing. A product whose barcode Amazon already knows is checked as an OF
search_amazon_catalog
Find whether a product already exists in Amazon's catalog on the workspace's listing marketplace — by barcode (EAN/UPC/GTIN), by ASIN, or by keywords. Returns up to 10 matches with asin, title, brand, the product type and the first photo. A barcode match means publish_amazon_listings makes an OFFER on that item rather than a new product. Reads Amazon, never writes. Use search_products for the CRM'
publish_amazon_listings
Create Amazon listings for up to 25 products — a REAL publication on the seller's Amazon account. Each product runs the full check again (Amazon's dry run included) and is refused with Amazon's own sentences if anything changed; a product whose barcode Amazon already knows becomes an offer on that existing item. Run check_amazon_readiness first and pass only ready products. Refused until the owner
sync_amazon_offers
Push the CRM's current price and stock to the workspace's existing Amazon offers now; an hourly job does it anyway, so use it only when a change must reach Amazon before the next run. A price change — the product's own, its price list, or set_product_channel_price — reaches Amazon ONLY through this push (an instant update after an edit sends stock alone). Pass productIds after changing a set of pr
withdraw_amazon_listings
Take up to 25 products off sale on Amazon: the offer's quantity becomes 0 on every marketplace it exists on (nobody can buy it) — the offer is NOT deleted and keeps its history and reviews in Seller Central — and the product leaves the CRM's Amazon channel so the hourly push does not restore the quantity; adding it to the channel again (set_channel_membership) brings it back. Not gated on the owne
set_amazon_listing_texts
Set ONE product's title and selling points for Amazon, in the language of the workspace's Amazon marketplace (amazon.it → Italian). The title keeps to 75 characters (the workspace's rule — a product whose own name is longer cannot be listed without it); up to 5 points of at most 500 characters. Write only what the user stated or approved, in the marketplace's language. title null with bulletPoints
set_product_safety_documents
Replace ONE product's safety documents (EU GPSR) — the whole list: a document left out is removed. Each is a public https link to a PDF that marketplaces fetch themselves (Amazon's compliance_media), its kind (safety_information, user_manual, declaration_of_conformity, certificate) and the language it is written in. At most 10. Use only links the user gave — never invent a document. A new Amazon l
check_amazon_variation_family
The model's active articles become ONE listing with variations on one Amazon store — Amazon's "variation family"; call it a model with variations when talking to the user: a parent whose SKU is the model's code (no price, no quantity) and a child listing per article, varying by colour and/or size — the theme is chosen from what the Amazon product type declares. An article not yet on the store beco
publish_amazon_variation_family
The model's active articles become ONE listing with variations on one Amazon store — Amazon's "variation family"; call it a model with variations when talking to the user: a parent whose SKU is the model's code (no price, no quantity) and a child listing per article, varying by colour and/or size — the theme is chosen from what the Amazon product type declares. An article not yet on the store beco
check_amazon_variation_parent
For a model ALREADY on Amazon as a model with variations (published with publish_amazon_variation_family): what its parent listing shows now (currentTitle) and what the CRM would send — the model's Amazon title set with set_channel_texts (modelId), else the model's name translated into the marketplace's language (titleSource model or name) — with warnings when that name would go untranslated, and
update_amazon_variation_parent
Send the parent of a model ALREADY on Amazon its title and selling points again — a REAL change on a live listing: the model's Amazon title and points (set_channel_texts with modelId), else its name in the marketplace's language. Replaces only item_name and bullet_point; nothing else a person set in Seller Central changes. Run check_amazon_variation_parent first. Refused until the owner switches o
set_channel_texts
Set the listing words of ONE product or ONE model for a channel — amazon (title up to 75 characters and up to 5 selling points) or ebay (title up to 80 characters, no points) — in the marketplace's language, which the CRM picks from the channel's marketplace (pass locale only when it says the channel sells in several languages). Which title a listing gets: the product's own words, else its model's
get_amazon_fields
The fields of the Amazon product type of ONE product, model or category (name exactly one id), read from Amazon's own schema for the workspace's Amazon marketplace: each field's attribute key, its title in the marketplace's language, its kind (choice with Amazon's list of values and labels, number, measure with the units it accepts, text), whether the type requires it, the value set on this level
set_amazon_field_values
Set or remove values of Amazon product type fields on ONE product, model or category (name exactly one id) — the attributes Amazon requires that are not product facts the shop shows on its site or other channels (Reparto, Tipo di chiusura, Capacità). A category's value is the default of every product in it, a model's is shared by every colour and size, a product's overrides both. Keys and values c
list_economic_operators
List the workspace's GPSR companies — the manufacturers and EU responsible persons marketplaces ask for (Amazon takes them as the EMAIL of a record the seller created in Seller Central). Each has id, name, email, phone, website and address. Assign them to a brand or supplier with assign_economic_operators; a product takes each role from its brand, else its supplier. Read-only.
save_economic_operator
Create a GPSR company (manufacturer or EU responsible person), or update one when id is given. The email is the key Amazon matches against the record in Seller Central, so it must be exactly that record's email — ask the user, never guess one. Name is unique in the workspace. Then assign it with assign_economic_operators. The result echoes the workspace.
assign_economic_operators
Point a brand or a supplier at its GPSR companies: the manufacturer and the EU responsible person (ids from list_economic_operators, or null to clear). Every product of that brand takes them first, then the supplier's. Replaces both roles at once. The result echoes the workspace.
list_amazon_shipping_templates
List the seller's Amazon shipping templates on ONE store — each template's id (the value Amazon takes) and name (as typed in Seller Central), read from Amazon's seller-specific product type schema through any category mapped to a product type. Templates exist per store (amazon.de has its own). When Amazon names none for this seller, templates is empty and note says so: templates are created in Sel
set_amazon_shipping
Assign an Amazon shipping template and/or a handling time (the most days from order to dispatch, lead_time_to_ship_max_days) to ONE product, model or category (name exactly one id). Inherited like Amazon field values: a category's value is the default of every product in it, a model's is shared by every colour and size, a product's overrides both. The template is given by id or name from list_amaz
bulk_set_product_brand
Set — or clear — the BRAND of many products in one call, the way the CRM's product list bar does it. scope names the products: a list of ids (at most 100, from search_products), a model (every colour and size of it) or a category (add includeSubcategories to take the ones under it); an open filter is not accepted. A brand belongs to the model, so for a product in a model the model changes and ever
set_amazon_field_values_for_products
Set the SAME Amazon product type field values (item_form, number_of_items, unit_count, package dimensions …) on an explicit list of up to 25 products — set_amazon_field_values for each product, with the same checks against the Amazon schema of THAT product's type, so a product whose type does not take a key is refused for that key only. When every product shares the value, set it once on their mod
check_amazon_brand_access
Ask Amazon whether this seller account may list a brand: allowed, approval_required (with the link to apply), not_eligible, or unknown. Amazon answers such questions per ASIN only (Listings Restrictions API) — there is no account-level brand query — so the answer is read for a SAMPLE ASIN of the brand: the one you pass, else the first catalog match whose brand equals the name. The result names the
list_ebay_fulfillment_policies
List the eBay shipping (fulfillment) business policies the seller has on each eBay site the connection sells on: fulfillmentPolicyId, name, freeShipping, shippingCost of the first domestic service (null for CALCULATED shipping), costType, handlingTime, domestic and international services, ship-to regions, and isDefault — the connection default. productCount is how many products chose the policy th
sync_ebay_fulfillment_policies
Re-read the eBay shipping (fulfillment) policies from eBay for every site the connection sells on, or one marketplaceId, and refresh the copy the CRM keeps — after the seller created, renamed or deleted a policy in Seller Hub. Returns the same shape as list_ebay_fulfillment_policies; check staleAssignments: products whose chosen policy eBay no longer has will be refused at their next draft or go-l
get_product_ebay_fulfillment_policy
Show ONE product's eBay shipping policy. Per eBay site: assignedPolicyId (the product's own choice, null when it has none), defaultPolicyId (the connection default) and effectivePolicyId with effectiveSource — product, connection_default or first_available — the policy a new draft or a go-live would carry, plus that site's policies. For a product with a draft or live listing it also reads the eBay
get_ebay_offer_policies
Read the eBay offers of up to 25 products live and return, per offer, the fulfillment, payment and return policy ids it carries now, the shipping policy name, its eBay site and status (PUBLISHED = live, UNPUBLISHED = draft), and matchesAssignment — whether it carries the product's own choice in the CRM (null when the product has none). Products with no draft or live listing are listed in withoutOf
set_product_ebay_fulfillment_policy
Choose the eBay shipping (fulfillment) policy of ONE product, or with fulfillmentPolicyId null return it to the connection default. A product with no eBay listing stores the choice for its next draft. A draft or LIVE listing has its eBay offer updated in place — no relisting — when listing writes are armed on the eBay connection, and the offer is then read back to confirm; with listing writes off
bulk_set_ebay_fulfillment_policy
Choose one eBay shipping (fulfillment) policy — or null for the connection default — for up to 25 products on one eBay site, with the same per-product rules as set_product_ebay_fulfillment_policy: no listing stores the choice; a draft or live listing has its offer updated in place and read back. The policy is checked against eBay once before any product is touched, and a product whose listing live
set_ebay_default_fulfillment_policy
Set the eBay connection's default shipping (fulfillment) policy for one eBay site, or null to remove it. Products without their own choice carry it in every new draft and when a draft goes live; LIVE listings keep the policy they have — change those with bulk_set_ebay_fulfillment_policy. The policy is checked against eBay's live list first; with no default, listings use the first policy eBay retur
get_ebay_variation_listing
Show a product MODEL as one eBay multi-variation listing: state (none, draft, live), marketplaceId, listingId and listingUrl, the stable groupKey, and every article of the model with its sku, colour, size, channelState on eBay and inclusion — included, not_active, not_on_channel (put it on the channel with set_channel_membership) or single_listing (it has its own eBay draft or listing, which must
inspect_ebay_variation_listing
Run every check saving a model's eBay multi-variation listing would run, writing nothing: each article's required fields and price in the marketplace currency, the variation axes (colour and/or size, named as the eBay site names them), duplicate or missing variation values, the category (suggested from the title, or the saved listing's), whether it allows variations, item condition, required item
save_ebay_variation_listing
Save a product model on eBay as ONE listing with variations — every active article of the model on the eBay channel is a variation (its own SKU, price and stock; buyers choose colour and size). Writes the inventory items, the inventory item group and each variation's offer; a draft stays unpublished. When the listing is already LIVE this updates it in place: new variations, prices and texts reach
publish_ebay_variation_listing
Publish a product model on eBay as ONE live listing with variations: saves it first exactly like save_ebay_variation_listing (so eBay gets the articles as they are now), then publishes the whole group — a real listing buyers can purchase. Returns status: blocked (with issues — reason, message, skus — and nothing written), saved (a draft on eBay) or published, plus marketplaceId, listingId, listing
withdraw_ebay_variation_listing
End a model's LIVE eBay multi-variation listing: every variation leaves sale at once. The group and its offers stay on eBay as a draft, so publish_ebay_variation_listing restores the same listing. Works while listing creation is disarmed (a way off eBay is never locked), but is refused until the workspace owner switches on AI publishing. Returns withdrawn. The result echoes the workspace.
delete_ebay_variation_draft
Delete a model's UNPUBLISHED eBay multi-variation draft: every variation's offer and the inventory item group are removed from eBay; the articles stay on the channel, ready for a new listing (together or one by one). A live listing is refused — end it with withdraw_ebay_variation_listing first. Refused until the workspace owner switches on AI publishing. Returns deleted. The result echoes the work
list_content_channels
List the social channels this workspace can publish posts to — Telegram channel, Instagram, Facebook page, LinkedIn, Threads, Viber channel — with, per channel, whether it is ready, where it posts (destination), its public address (profile: profileUrl, publicFeedUrl — a public Telegram channel reads without signing in at t.me/s/<name>, older posts via ?before=<post id> — and readableBy: anyone, lo
list_content_posts
List the workspace's social posts, newest first, 20 per page: id, working title, status (draft, scheduled, publishing, published, partial, failed), channels, scheduled and published times. Filter by status or by part of the title. Read-only. Use get_content_post for one post's texts and per-channel results; use it to check what is already scheduled before planning more posts.
list_published_posts
List what this workspace has already published to its social channels, newest first: per post the exact text each channel got (hashtags included), the channel, permalink, publishedAt, title, contentPostId and productId, plus per channel the publishing rhythm (lastPostedAt, postsLast7Days, postsLast30Days, medianGapHours, nextScheduledAt, scheduledCount) and, in sources, the channel's public addres
get_content_post
Read one social post: its main text, hashtags, images, linked product, status and schedule, and per channel the text that channel gets (ownText or the main text), its length against the channel limit, whether the channel is ready, and what publishing returned there — status, link to the live post (permalink) or the network's error. Read-only. Use list_content_posts to find the id; call it after pu
create_content_post
Create a social post as a DRAFT — nothing is published. Give it a working title, the main text, optional hashtags, the channels (each may carry its own text), and images: public https image links (Obriym stores its own copy), files the person attached in ChatGPT (the `files` field, filled by ChatGPT), links returned by create_image_upload for local files, and/or a catalog product whose photos are
update_content_post
Change a draft or scheduled post: working title, main text, hashtags, format, or its channels and their own texts (sending channels replaces the whole set). Fields you omit stay as they are; images cannot be changed here. Refused for a published post — a post already live on a network cannot be changed from Obriym; create a new one instead. Refused while the post is being published. Repeating the
delete_content_post
Delete a post that has not been published — a draft, a scheduled post (its schedule goes with it) or one whose every channel failed. Its own stored images are deleted too; a linked product's photos are never touched. Refused for a post that went out on any channel: that record stays. This cannot be undone. Echoes the workspace.
schedule_content_post
Schedule a post to be published at a time, or cancel its schedule. Obriym itself publishes it to every ready channel of the post within about 15 minutes after that time — the AI client does not need to be running then. This is how regular publishing is set up: create several drafts, then schedule each. Needs the owner's "AI may publish to social channels" switch to schedule (see publishingEnabled
publish_content_post
Publish a post NOW to every ready channel of it — a real, public post in the business's name that followers see at once and that cannot be taken back from Obriym. A channel already published is never sent twice, so calling it again only retries the channels that failed or were not ready. Returns, per channel, the outcome (published, failed, already_published, skipped_not_configured with the setup
list_suppliers
List the workspace's suppliers: id, name, status (active or archived), the currency they invoice in and how many products each covers (productCount). Read-only. Use it as the id source for a {kind:'supplier'} scope of preview_bulk_price_change and apply_bulk_price_change — 'raise every Sipec product by 5%'. Categories, brands and warehouses come from list_categories, list_brands and list_warehouse
get_product_pricing
Everything about ONE product's prices in one call: its own price, old price and currency; the price-list rows (other currencies); per-channel price overrides (platform, currency, price); the channel price rules that apply where there is no override (channelPriceRules); wholesale quantity breaks per currency; the purchase cost with its currency (a bundle's cost is derived from its components and ca
preview_bulk_price_change
Dry run of a bulk price change — step 1 of 2; nothing is written. Give a rule (percent, fixed, fromCost, discount, endDiscount, compareAtMarkup, compareAtClear), a scope (a named category, brand, supplier, warehouse or model, or up to 100 explicit product ids) and optionally a target (the product's price, a price-list currency, or the purchase cost). Returns totalItems (how many products would cha
apply_bulk_price_change
Apply a bulk price change — step 2 of 2, after preview_bulk_price_change. Send the SAME rule, scope and target and the digest the preview returned, copied verbatim and never invented. The plan is recomputed from live prices and refused with CONFLICT if it no longer matches the digest (prices moved, or the rule would compound on a retry) — preview again and show the person the new numbers. Changes
list_channel_price_rules
List how each connected sales channel prices products, one row per channel and currency: rule null means the base price, otherwise percent, fixed and rounding are added to it. The currency null means the channel has not told the CRM its currency yet. Read-only. Use preview_channel_price_rule to see what a change would do, and get_product_pricing for one product.
preview_channel_price_rule
Dry run of a price rule for one sales channel in one currency, step 1 of 2; nothing is written. A rule prices every product on the channel from its base price (price + percent, then + fixed, then rounding) and moves with the base price; a product with its own price on the channel keeps that price. Pass rule null to go back to the base price. Returns how many products would change, how many have th
set_channel_price_rule
Save a price rule for one sales channel in one currency, step 2 of 2, after preview_channel_price_rule. Send the SAME platform, currency and rule with that preview's digest; a digest from an older preview is refused. Applies to every product on the channel on its next update, wherever the owner has turned price updates on, and to new listings; it never turns price updates on. Requires the workspac
set_product_channel_price
Set — or clear — the price ONE sales channel gets for ONE product, instead of the product's ordinary price in that currency. Send price as a decimal string to set it (with an optional compareAtPrice, the old price, higher than price) or price null to remove the override so the channel gets the ordinary price again. Per platform and currency: Prom, Rozetka, eBay, Amazon, Shopify, WooCommerce, OLX o
set_product_price_tiers
Replace ONE product's wholesale quantity breaks in ONE currency — 'from 12 units, 12.40 each'. The list you send becomes the whole set for that currency (at most 10; each quantity at least 2 and once; a bigger quantity must cost less per unit); an empty list removes all its breaks. The product must already be priced in that currency. Breaks apply to buyers outside the team (the customer portal and
get_channel_stock_limit
Read the global or product-specific maximum published quantity on one numeric-inventory channel. Optional productId returns mode (inherit/limit/unlimited), own and effective ceiling, delivery state and reasons; readiness reports disabled inventory writes across all nine numeric-stock channels. Delivery items include target scope, attempted quantity, reasons and optional import reference; submitted
preview_channel_stock_limit
Dry run of a channel's maximum published quantity per SKU; nothing is written or sent. Optional productId targets ONE SKU: inherit true with maxQuantity null restores the channel rule; otherwise positive maxQuantity overrides it and null explicitly means unlimited. Without productId, positive maxQuantity sets the global ceiling and null removes it. Returns product counts (total, changed, untracked
set_channel_stock_limit
Save or remove a channel's maximum published quantity per SKU after preview_channel_stock_limit. Send the SAME platform, optional productId, inherit and maxQuantity (product inherit true restores the channel rule; product null without inherit explicitly bypasses it), with that preview's token copied verbatim. A stale, expired or mismatched preview is refused: preview again and show the new result.
retry_channel_stock_delivery
Retry the current saved stock policy for a channel or optional productId, without changing the rule or arming any direction. Read get_channel_stock_limit first, copy its current retryToken verbatim, and show its delivery/readiness reasons; disabled inventory writes stay disabled. Requires settings:write and the owner's AI marketplace-writes switch. Queues up to 500 eligible products; remaining pro
create_image_upload
Get one-time links for uploading image FILES from the agent's own machine — for clients that can read local files and send HTTP requests (Claude Code, Cursor, scripts). A chat client passes image links instead, and ChatGPT passes attached files itself through the files field. For each link, send the raw file bytes with HTTP PUT within 15 minutes — for example: curl -X PUT --data-binary @photo.jpg
add_product_images
Add photos to ONE product, after the photos it already has: public https image links (images, each with an optional caption), files the person attached in ChatGPT (files — ChatGPT fills it), or links returned by create_image_upload for files on the agent's own machine. Obriym downloads every image and stores its OWN COPY in the workspace's storage — the link may be temporary and nothing hotlinks t
update_product_images
Reorder, caption or REMOVE the photos a product already has. Send the photos as they should be afterwards: the order given is the display order (the first is the main photo), each alt replaces the stored caption (empty clears it), and a current photo you leave out is removed from the product (the stored file is kept, exactly as when a person removes a photo in the product form). Returns the new li
set_category_image
Set or remove the picture of ONE category. Pass a public https image link in url (JPEG, PNG or WebP, at most 2 MB; a bigger file is refused, there is no resize) — Obriym stores its own copy and the previous picture is deleted only after the new one is in place. Pass url: null to remove the current picture. Idempotent in effect: repeating it leaves the same picture. Use list_categories to find the
set_brand_image
Set or remove the picture (logo) of ONE brand. Pass a public https image link in url (JPEG, PNG or WebP, at most 2 MB; a bigger file is refused, there is no resize) — Obriym stores its own copy and the previous picture is deleted only after the new one is in place. Pass url: null to remove the current picture. Idempotent in effect: repeating it leaves the same picture. Use list_brands to find the
add_content_locales
Add languages to the workspace's export languages, which gives products, categories and brands a translation tab in each of them and makes them targets for a bulk translation. Languages already offered are ignored, and none is ever removed. Use list_content_locales first to see what is offered. Idempotent. The result names what was added and echoes the workspace.
estimate_catalog_translation
Work out what a bulk AI translation of products would do, step 1 of 2; nothing is written and no credits are spent. Give the products (ids, or a whole category, brand, supplier, warehouse or model) and the target languages, which must be offered by the workspace (list_content_locales). Returns how many of the selected products still need it, the most it can cost in AI credits and the credits left.
start_catalog_translation
Start a bulk AI translation of products, step 2 of 2, after estimate_catalog_translation. The CRM translates from the workspace's base language into the given languages and fills only empty fields; a model is translated once for all its colours and sizes. It runs in the background, usually for up to a few hours, spends the workspace's AI credits and stops at the limit keeping what is done. Require
get_catalog_translation_status
Read how the workspace's bulk AI translation is going: state (none, running, waiting for AI answers, halted when credits ran out, done), products written, credits used and the target languages. Read-only. Use start_catalog_translation to begin one and stop_catalog_translation to end it.
stop_catalog_translation
Stop the workspace's bulk AI translation. Products already translated keep their text, and no further credits are spent. Idempotent: with nothing running it changes nothing. The result echoes the workspace.
list_content_locales
List the languages this workspace writes product content in: the base language (the text stored on products, categories and brands themselves), the extra languages the owner added, and the offered set — every language the CRM shows as a translation tab. Each entry is an ISO 639-1 code with its English name. Read-only. Call it BEFORE writing any translation (upsert_product_translation, upsert_categ
upsert_category_translation
Set a category's name and/or description in ONE language, leaving every other language as it is. Translate the text yourself — Obriym does not translate for MCP clients. Call list_content_locales first; the workspace's base language is refused (use update_category for it). A language needs a translated name before it can hold a description; description null clears it. Idempotent: repeating the sam
upsert_brand_translation
Set a brand's DESCRIPTION in ONE language, leaving every other language as it is; null or an empty description removes that language. Translate the text yourself — Obriym does not translate for MCP clients. Never translate a brand NAME: marketplaces match it verbatim. Call list_content_locales first; the workspace's base language is refused (use update_brand for it). update_brand's translations fi
preview_google_merchant_products
Show, for 1 to 25 products, the exact body the Google Merchant push would send for each one — title, description, link, image links, price, availability, identifiers and custom labels — or the reason it would be held back (blocker: no_url, no_title, no_price, no_image, no_translation, not_shoppable, no_feed_label). It walks the same collect step and the same builder as the real push, so it cannot
get_google_merchant_product_performance
Clicks and impressions per product in Google Shopping for a date range, best first, read from Google's Merchant API Reports on demand — nothing is stored, so it is a question, not a sync. Each row has offerId, title, clicks, impressions and clickThroughRate. At most 92 days per call and 100 products; truncated is true when more products matched than limit, so narrow the dates or raise limit. Conve
set_google_merchant_labels
Set or clear Google's custom labels customLabel1 to customLabel4 on up to 100 products, models or categories, so ad campaigns can be split by your own groups ("season sale", "clearance"). This writes to the CRM only: the labels reach Google with the next hourly product push, and only if the owner armed that push — it never sends anything itself, never arms anything, and never touches the preview s
list_ad_accounts
List the connected ad channels with their accounts: per channel the provider key, label, health (active, setup_required, error), the last sync time, any current sync error, campaign counts, and each account's id, name, currency, status and last sync. Also returns reportingCurrency, the workspace currency every revenue and ROAS figure is stated in. Read-only, from stored state: no ad platform is ca
list_ad_campaigns
List one ad channel's campaigns for the last N days, biggest spend first: status, objective, daily or lifetime budget, currency, spend and clicks (from the ad platform), and what the CRM recorded for the campaign — leads, deals, won deals, orders, sales, revenue, costPerLead. roas is revenue divided by spend, and is null — never guessed — when the ad account's currency differs from reportingCurren
list_ad_recommendations
List the CRM's open advertising recommendations across every channel: kind (spend_no_result, unanswered_leads, low_roas, scale_winner, cost_per_lead_spike), severity (urgent, warning, opportunity), the campaign and the frozen evidence the rule saw. They are deterministic rules over data only the CRM has — whether a click became a customer, what it paid, whether anyone replied — not a model's opini
preview_google_shopping_campaign
Dry run of a Google Shopping campaign, step 1 of 2: the very request create_google_shopping_campaign would send, validated by Google with validateOnly — nothing is created in the ad account. Returns { currency, payload } or Google's own refusal (a duplicate name above all). It does record that a dry run happened, which is the evidence the owner needs before arming campaign creation on the Ads page
create_google_shopping_campaign
Create a Google Shopping campaign in the connected Google Ads account — step 2 of 2, after preview_google_shopping_campaign. A REAL write to the live ad account, but the campaign is always created PAUSED: this tool never activates or starts one, and spends nothing until a person starts it in Google Ads. It obeys the owner's own settings on the Ads page: refused unless campaign creation is armed th
get_listing_automation
Read the listing automation of a one-item-per-listing marketplace (Vinted), where a sale ends the listing: whether it lists the next unit after a sale and again when stock arrives, when (relistTiming: instant, next_run within 10 minutes, after_1h, after_6h, after_24h), its publishing windows in the workspace time zone, the daily limit, the refresh of listings that do not sell, the settings version
list_listing_jobs
List the listing automation's queue on a one-item-per-listing marketplace (Vinted): listings waiting to go up (after a sale, after a restock, on schedule, or a refresh), with the product, when each is due and its state (pending, waiting_stock, waiting_delete, running) — or, with scope history, what was done, skipped, cancelled or failed and why. Paginated with a real total. Read-only. Use cancel_l
preview_listing_automation
Dry run of the listing automation on a one-item-per-listing marketplace (Vinted), from the CRM's own data — nothing is sent to the marketplace. Counts live listings whose product has another unit (they would be listed again after a sale), listings of the last unit (they would wait for stock), listings of products whose stock the CRM does not count (never listed again), and sold or removed products
update_listing_automation
Change the listing automation of a one-item-per-listing marketplace (Vinted). Send only the fields to change; the rest stay as saved. Changing when it lists (relistTiming, windows, maxPerDay) and turning a behaviour off work with the settings scope alone; turning relistAfterSale, relistOnRestock or the refresh ON also needs a dry run first (preview_listing_automation) and the workspace owner's swi
schedule_listing_publishes
Queue products to be listed on a one-item-per-listing marketplace (Vinted) within the listing automation's publishing windows and daily limit, a few at a time, instead of all at once — the same as the channel page's "Publish on schedule". Each queued product later goes up as a new listing through the same publisher as the Publish button, so a product missing something is reported in list_listing_j
cancel_listing_jobs
Cancel listings waiting in the listing automation's queue on a one-item-per-listing marketplace (Vinted), by job id from list_listing_jobs. Nothing is sent to the marketplace and no live listing changes; the products simply are not listed for that reason. A job a run is sending right now, or one already closed, is not cancelled and comes back in notCancelled. Idempotent. Returns { cancelled, notCa

What it does

Role-scoped access
The assistant can only do what your own role allows and is cut off any time in Settings.
Audit log
Every change is recorded the same as a manual one.
Previewed bulk pricing
Bulk price changes are calculated and shown first, and need owner approval.
eBay drafts
Checks a product, fills required fields and creates a draft; publishing needs owner permission.
Scheduled social posts
Drafts posts and schedules them to connected channels.
Catalogue translations
Translates categories, brand descriptions and product characteristics.

Good for

  • Find deals that have had no activity for days
  • Correct a stock count and record why
  • Raise prices 5 percent for a supplier after previewing the effect
  • Schedule a week of social posts from one request
  • Check why a product is not getting through to a marketplace

Pricing

Freemium

Free plan exists but MCP needs Team (about EUR 16/mo billed annually) or Scale (about EUR 56/mo billed annually); 14-day trial, no card

Prices change. Check obriym-crm.com before you buy.

Obriym CRM FAQ

Which plans include the MCP server?

Team and Scale; the 14-day trial needs no card.

Which assistants work?

Claude, ChatGPT, Gemini, Cursor and any assistant supporting the standard; Cursor and VS Code have a one-click button.

Can it delete products?

No. It archives them, and an archived product can be restored.

What if I run several businesses in Obriym?

It touches exactly one, chosen by you; until then the connection is locked.

My assistant does not see new capabilities. What now?

In ChatGPT refresh the app at chatgpt.com/plugins and start a new chat; in Claude a new chat is enough.

Is Obriym CRM free?

Obriym CRM has a free plan, with paid plans for more usage or features.

How do I add Obriym CRM to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://obriym-crm.com/api/mcp

What are the best alternatives to Obriym CRM?

The closest alternatives to Obriym CRM are Calven, O'So MCP Server for PrestaShop, CompanyData, MisarReach MCP Server and NeuralVerge.

Alternatives to Obriym CRM

  1. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  2. Let Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions

    Not checked yet
    • Remote
    • Open source
    • 2 GitHub stars
    • E-commerce
  3. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data
  4. Find, enrich and score B2B leads and run outreach sequences from an AI assistant

    • 31 tools
    • Remote
    • Freemium
    • 1 GitHub star
    • Sales and CRM
  5. NeuralVerge

    MCP server

    Structured, source-tagged business and people data from 300+ sources for agents

    • 200 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Web search and scraping
  6. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security