Gemalli B2B Trade

Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.

Global B2B trade: verified manufacturers, product search, sanctions screening, HS codes.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Gemalli B2B Trade": {
      "url": "https://gemalli.com/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (25)

• list_manufacturers read-only

  List verified manufacturers published on Gemalli. Returns each producer's name, country, certifications and profile identifier in the requested language, newest first. USE THIS whenever the question is about COMPANIES rather than goods: "who makes X", "which factories/producers/suppliers are on the platform", "show me manufacturers from <country>". A question about companies stays this tool even when it names a product — search_products returns goods, not the companies behind them. To find a specific product or filter goods by country, use search_products.

  Parameters:

  • limit — integer — Max results (1–50). Defaults to 12.
  • locale — string — Preferred locale for returned text. Defaults to "en".

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_manufacturer read-only

  Fetch one manufacturer's full profile: company description, country, certifications, and the identifiers of the same profile in other languages. Use it after list_manufacturers or search_products, when the person wants to know who the supplier is.

  Parameters:

  • slug (required) — string — Manufacturer slug (per-locale or base).
  • locale — string — Locale for the returned translation.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• search_products read-only

  Search wholesale products published on Gemalli. Narrow by free text, category, manufacturer, country of origin, maximum minimum-order quantity, maximum price or delivery basis (Incoterms 2020 codes the seller confirmed). Returns product cards in the requested language with price range, minimum order and the supplier. Use it when the person is looking for GOODS to buy or source. When the question is about the COMPANIES themselves — who makes something, which factories or producers are on the platform — use list_manufacturers instead: this tool returns goods, and a list of goods is not an answer about companies.

  Parameters:

  • q — string — Free-text search across name + description (FTS via migration 0016 with ILIKE fallback).
  • limit — integer — Max results (1–50). Defaults to 12.
  • locale — string — Preferred locale for returned text.
  • moqMax — integer — Max minimum-order-quantity threshold (inclusive).
  • offset — integer — Pagination offset.
  • country — string — ISO 3166-1 alpha-2 country code (e.g. "UA").
  • category — string — Category slug filter (categories.slug).
  • priceMax — number — Max `price_from` threshold (inclusive).
  • incoterms — array — Delivery basis filter, Incoterms 2020 codes (e.g. ["FCA","DAP"]). A product matches when the seller confirmed ANY of the listed codes. Products without confirmed terms ("Incoterms on request") never match.
  • manufacturer — string — Manufacturer slug filter (manufacturers.slug).

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_product read-only

  Fetch one product's trade terms: minimum order quantity, lead time, Incoterms, HS code, packaging, price range, photos and the supplier it belongs to. `delivery_terms` lists the delivery bases the seller confirmed as {incoterm, place_kind, place_city}: place_kind is seller_site | port | border | buyer_site (null when not stated), place_city is the city name in the requested language (English fallback) or null; an empty list means Incoterms on request. Use it once the person has picked a product from search_products and wants the terms.

  Parameters:

  • slug (required) — string — Product slug (per-locale or base).
  • locale — string — Locale for the returned translation.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_categories read-only

  List the product categories on Gemalli with their names in the requested language. Use it to offer the person a choice of category before searching, or to turn a category name into the identifier search_products expects.

  Parameters:

  • locale — string — Locale for the returned names.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• check_sanctions read-only

  Screen a company or a person against consolidated sanctions, politically-exposed-person and law-enforcement lists (EU, US, UK, UN, Ukraine), sourced from OpenSanctions. Returns possible matches with a similarity score. Use it before the person commits to a counterparty. Treat a match as a reason to verify further, not as proof.

  Parameters:

  • query (required) — string — Name, alias, or company string to screen.
  • limit — integer — Defaults to 10.
  • topic — string
  • country — string — ISO 3166-1 alpha-2.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• lookup_hs_code read-only

  Find the Harmonised System (HS) customs code for a product, by description or by code prefix. Returns matching codes with their official names in the requested language, the chapter they belong to, and a similarity score. Use it when the person needs a customs classification for an import, an export or a quote, then pass the code to check_dual_use.

  Parameters:

  • query (required) — string — Product description or HS code prefix.
  • limit — integer — Defaults to 10.
  • locale — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• check_dual_use read-only

  Check whether an HS customs code falls under EU dual-use export controls (Regulation 2021/821 and equivalents), optionally for a specific destination country. A match means the goods may need an export licence. Use it after lookup_hs_code, before the person commits to a shipment.

  Parameters:

  • hs_code (required) — string — HS code from lookup_hs_code.
  • locale — string
  • destination — string — Destination country (ISO-2).

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• partnership_inquiry read-only

  Return Gemalli's partnership and investment terms and the founder's direct contact. Use it when the person represents a company that would work with a trade platform rather than buy on it — for example logistics, customs, trade finance, insurance, inspection, an ERP vendor or an investor. It returns information only and sends nothing.

  Parameters:

  • from — string — Company or platform the person represents, if known.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• request_quote

  Send a request for prices, samples or terms to a manufacturer on the person's behalf. Requires the person's own name and email — ask them and pass exactly what they give you, never invent an address. The manufacturer receives the request; the person receives an email with a sign-in link where the reply and the supplier's contacts appear. No account is needed beforehand. Use it once they have chosen a supplier.

  Parameters:

  • manufacturer_slug (required) — string — Target manufacturer slug, from search_products or list_manufacturers.
  • buyer_name (required) — string — The person's name, as they gave it.
  • buyer_email (required) — string — The person's real email — the reply and the sign-in link go there.
  • message (required) — string — What they need: specs, volumes, target price, delivery terms.
  • locale — string
  • quantity — integer — Desired quantity.
  • agent_name — string — Name of the agent or platform sending this, e.g. "Claude" — recorded as the source.
  • product_id — string — Product the request is about, if one was chosen.
  • variant_key — string — Version of that product the person chose, when get_product lists `variants` (e.g. "400v"). Requires product_id. The manufacturer sees the version and its model code in the request.
  • operation_id — string — Optional idempotency key for this attempt. Retrying with the SAME operation_id returns the original result instead of creating a second RFQ — send one if your transport can retry. No token needed: an anonymous person is scoped by the buyer_email you pass.
  • buyer_company — string — Their company name, if known.
  • buyer_country — string — ISO 3166-1 alpha-2 country of the buyer.

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• get_viewer read-only

  Report who the person is currently acting for on Gemalli: role, interface language and, when signed in, the company they represent and their plan. An anonymous person is a valid answer and comes back as a guest, not an error. If the person signed in after talking to you anonymously, previous_guest carries the identifier of that earlier conversation so you can carry the history over, and linked_at separates a link you have not seen before from one you have already handled. credits tells whether platform credits are on (enabled), the balance and total granted when signed in, buy_url (null means no payment page yet: send the person to Office Live) and action_costs, the only map from a tool to its action and price: call something free only when its credits is 0, never offer an action whose credits is null. wallets carries one entry per credit kind with its balance and low: low true means that kind is running out and the panel should show the remaining-credits note. Every paid answer carries the same wallets, freshly counted after the charge — prefer those over this first reading. Never returns another party's data and never returns secrets.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_subscription_plans read-only

  Explain how to get Gemalli pricing. Gemalli does NOT publish plan prices through this API: quotes are given by the sales desk, because what a manufacturer pays depends on their catalogue, languages and markets. Call this when the person asks what Gemalli costs, then give them the contacts you get back and offer to introduce them. Do NOT state, estimate, guess or recall any price, plan tier, discount or limit for Gemalli itself — you do not have that information, and inventing it misleads the person. Prices of goods listed BY manufacturers are a different thing and stay available through the catalogue tools.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_buyer_search_offer read-only

  Read the buyer-search package offer — what the person buys in the «find buyers» order window: plans with prices in USD, company quotas, country limits, top-up rules, roles, the order stages and — for an HS code — the clarifying question and the buyer segments that fit each answer. These are prices of the BUYER-SEARCH PACKAGE, shown openly in the order window; they are not Gemalli subscription plans, so the get_subscription_plans rule about never stating prices does not apply here. Use it in the sales chat to answer questions and to suggest a plan and segments. You only suggest: the person chooses and pays in the order window, never through you. Right now it is a demo — payment is a test with no charge, company search and emails are switched off — say so plainly and never promise buyers: a company becomes a buyer only by answering. Texts come in the call locale (uk, ru, en; others fall back to en).

  Parameters:

  • locale — string — Language of the texts: uk, ru or en (others fall back to en).
  • hs_code — string — HS code of the product from the page context (2 to 10 digits) — picks the clarifying question and the segments.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• submit_join_request

  Send the platform team a request to join Gemalli — for a manufacturer, trader, sales agent, logistics or customs operator, broker or finance provider who wants to work with the platform rather than buy on it. Requires their name, email and phone: the team follows up by phone, so a number is needed. Ask them and pass exactly what they give you, never invent contact details. Use it only when the person has asked to be contacted, never to record someone you are merely discussing.

  Parameters:

  • name (required) — string — The person's name, as they gave it.
  • email (required) — string — Their real email. Required.
  • phone (required) — string — Their phone in international format. Required.
  • locale — string — Two-letter language the person speaks, for the follow-up.
  • source — string — Where this lead came from, e.g. your agent name — recorded for the sales team.
  • company — string — Their company, if known.
  • country — string — ISO 3166-1 alpha-2 country of the person.
  • message — string — What they are looking for, in their own words where possible.
  • operation_id — string — Optional idempotency key. Retrying with the SAME operation_id returns the original lead instead of creating a duplicate.
  • applicant_role — string — What they do: producer, trader, sales_agent, logistics, broker or finance.
  • trade_direction — string — What they buy or sell, short free text.

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• create_feedback_ticket

  Record a feedback ticket for the Gemalli team: a question, a problem or a suggestion. Call it ONCE, only after the person confirmed the wording you read back to them. Identity is taken from the visitor pass — never pass a user id. For a visitor who is not signed in, contact_email is required: without it there is no way to tell them it was fixed.

  Parameters:

  • kind (required) — string — question = asks something · bug = something is broken · idea = suggestion
  • subject (required) — string — Short summary as you understood it
  • message (required) — string — The request in the person’s own words
  • locale (required) — string — Language to answer in, e.g. ru / uk / en
  • page_url — string — Platform page the person was on
  • transcript — array — Last turns of the conversation (max 20 turns / 8000 chars; longer is trimmed, not rejected)
  • contact_email — string — Required when the visitor is not signed in

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• add_feedback_message

  Add a message to an existing feedback ticket of the current visitor — when they remember a detail ("only in Chrome") after the ticket was created. Do NOT create a second ticket for the same problem. Identity comes from the visitor pass; a ticket that is not theirs is simply not found.

  Parameters:

  • ticket_id (required) — string — ticket_id returned by create_feedback_ticket
  • message (required) — string — What the person wants to add

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• close_feedback_ticket

  Close a feedback ticket of the current visitor when they say it is no longer relevant or they worked it out. A ticket the team already finished (fixed or declined) is NOT closed — say so instead. Identity comes from the visitor pass.

  Parameters:

  • ticket_id (required) — string — ticket_id returned by create_feedback_ticket
  • reason — string — Optional: why they close it

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• get_feedback_thread read-only

  Read one feedback ticket of the current visitor with its whole conversation: the original request, what they added later and what the team answered. Use it to SHOW the ticket, not to decide anything — the team answers, the agent does not answer on their behalf. Identity comes from the visitor pass.

  Parameters:

  • ticket_id (required) — string — ticket_id returned by create_feedback_ticket

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_my_feedback read-only

  List the feedback tickets of the current visitor for the Workspace tab. Identity comes from the visitor pass; a guest is matched by the conversation label, so the same person on another device sees nothing — that is expected, not a fault.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_feedback_reasons read-only

  Reasons a person can pick after rating the agent. Call it once when the widget opens and cache it; re-read when the platform says the dictionary changed, or lazily by the `rev` value. Two lists: `reasons` are the live ones to draw in the window, `retired` are switched off and are only there so old feedback stays readable. 🔴 `label` is the best text WE have for the asked language and may fall back (`lang` says to what). `source_label` is what the admin actually WROTE and `source_lang` is the language they wrote it in — translate from THAT, never from `label`: translating our fallback would make a translation of a translation, losing a little at every step. When a card is shown untranslated, send `reason_shown_lang` with the rating so a reason picked blindly can be told from one picked on purpose. If this door is silent, show the free-text field anyway and still count the thumb — never drop a rating.

  Parameters:

  • locale — string — Language of the person, e.g. ru / uk / de-AT. Falls back exact → base → English, never Russian.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• rate_agent_result

  Record what a person thought of something the agent produced — a reply, an export, a report, an email. Send it as soon as they press the thumb: the reason and their words are optional and may follow in a second call, which replaces the first. Pick `reason_code` from get_feedback_reasons; an unknown code is dropped and the rating is still saved (`reason_dropped: true`). For `target_kind: "report"` the `target_ref` is the view_key, NOT the report_key — one report is read by many country pages and only the view_key tells them apart. `target_ref` is verified against your own message log: the answer carries `ref_check` saying whether it matched (`verified`), did not (`mismatch`), could not be checked (`unchecked`) or was never sent (`absent`). A rating is never dropped because the check failed.

  Parameters:

  • surface (required) — string — Where it happened, e.g. widget.
  • target_kind (required) — string — What was rated: answer | export | report | email | any future kind.
  • verdict (required) — string — The thumb the person pressed. Send "retracted" (or an empty string) when they pressed the same thumb again and took the rating back — it then stops counting and leaves the triage queue. Retracting needs the same target_ref as the rating it undoes.
  • model — string — Which model produced the rated answer.
  • probe — boolean — True when the call comes from a test run rather than a person. 🔴 Derive it from the process you run in — do not set it by hand: a flag someone has to remember is a flag someone forgets. The rating is still STORED; it is hidden behind a switch on the triage screen, because dropping it on arrival would lose what later needs explaining. Omit the field when you cannot tell — absent means "not stated", never "a person".
  • topic — string — What the exchange was about, one short phrase.
  • signal — string — thumb (default) for a pressed thumb; undone when they cancelled the result; rephrased or left for the quiet signals. The weight is set by the platform, not by you.
  • comment — string — Their own words. Optional. Trimmed at 2000 characters.
  • target_ref — string — Your identifier of the rated work: the message id for an answer, the view_key for a report. Omit it only when the kind has none.
  • reason_code — string — A code from get_feedback_reasons.
  • knowledge_ids — array — Ids of the platform rules that were in the prompt for this answer, up to 50. This is how a harmful rule gets noticed from a single complaint.
  • reason_shown_lang — string — Language the person actually SAW the reason card in — send it together with `reason_code`, never alone. It exists so that "they picked this reason" can be told apart from "they tapped something they could not read": when the card had not been translated yet, the language differs from the visitor locale. Omit the field entirely rather than sending an empty string — absent means "not stated", which is a different answer from "in their own language".

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• get_agent_knowledge read-only

  Platform rules for the agent, as short lines to put into your prompt. Call it once and cache it by `rev`; re-read when the platform pokes you or when your fallback poll comes due. Without `ids` you get ALL active rules for the audience, short form only — YOU pick which ones belong in a given answer (no more than three fit a prompt). With `ids` you get the full text of those rules instead, including RETIRED ones, flagged `retired: true` — so your log of «which rules were in this answer» stays readable after a rule is switched off weeks later. Ask for up to 50 ids at once: three is what fits a PROMPT, a review screen needs more. off. A retired rule must never go back into a prompt. If this door is silent, answer without rules: that is the normal state and must change nothing in your behaviour.

  Parameters:

  • ids — array — Ids of rules whose FULL text you need — up to 50 per call (that is a review screen, not the whole knowledge base; call without `ids` for all active rules). Retired rules are returned too, flagged. An id that is a valid uuid but no longer exists is simply ABSENT from the answer — compare lengths, one dead id never costs you the other texts. A string that is NOT a uuid is different: it fails the whole call with `validation_failed` naming its position (`ids.1`), so filter your ids by uuid shape before calling if they come from a log.
  • audience — string — Which agent asks. Defaults to widget. Rules marked for both arrive in either case.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_person_memory read-only

  What the platform remembers about THIS person between conversations: up to six stable traits (role, industry, where they ship to, language, attitude to price, document requirements) and the one-line outcome of their last 5 conversations. Call it before you answer, so you do not ask again what they already told you. The person is taken from the visitor token — never pass an id. A guest gets an empty answer (`reason: "guest"`): we keep no memory without a cabinet where the person could see it. Nothing is carried over when a guest signs in — there was nothing to carry — but the account may already hold memory from earlier visits, so call this door again right after sign-in. Each trait carries `origin`: `human` means they said it outright, `model` means an agent inferred it — treat an inferred trait as a guess worth confirming, not as a fact. If this door is silent, answer as before.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• remember_about_person destructive

  Remember something stable about THIS person, so the next conversation does not start from zero. Allowed keys, and only these: role, industry, delivery_place, language, price_attitude, doc_requirements. An unknown key is reported back by name and the other facts in the same call are still stored. `source` must say where it came from: `human` if the person stated it, `model` if you inferred it. 🔴 It is not a label: it decides whether the write lands. What the person stated outright overwrites anything; an inference overwrites only another inference. A `model` write onto a trait the person stated themselves comes back with `why: "person_said_it"` and `current` holding what they said — ask them about the discrepancy instead of deciding for them. Within one source the newer value always wins, so a person who changed where they ship stops being remembered with the old place. the person stated it, `model` if you inferred it. `recall` is the one-line outcome of this conversation ("looked for 500 m of cable to Berlin, left no enquiry"). Do NOT send name, email or phone — they are not kept here: a copy that never updates would have the agent writing to a stale address. Do NOT send the product, volume, deadline or spec either — those belong to the enquiry and change every time. The person is taken from the visitor token; a guest gets `sign_in_required`. The answer says per key whether it was stored.

  Parameters:

  • facts — array — Stable traits of the person. Up to six distinct keys.
  • recall — string — One line on how this conversation ended. Cut at 300 characters.

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• list_site_sections read-only

  List the pages of gemalli.com you can direct this person to, with the label in their language and the address. Use it before offering a link, so you point at a page that exists rather than guessing. Which pages appear depends on whether the person is signed in.

  Parameters:

  • locale — string — Language for the labels. Defaults to English.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.