SAMOS e-commerce

Working · 1.4 s

com.samos-e/samosv1.0.4 Domain verified

Track SAMOS parcels, estimate UK shipping, return and duty costs, and search SAMOS help.

Commerce

Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://samos-e.com/api/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

estimate_duties Read-only

Estimate the import duties and taxes the recipient pays on one item shipped from the UK with SAMOS. Provide a product description or HS code. Heavily rate limited: only call when the user asks for a duties/tax estimate.

valuenumber, required

Value of one item.

country_of_originstring, required

ISO 3166-1 alpha-2 code of the country where the item was made, e.g. GB, CN.

destination_countrystring, required

ISO 3166-1 alpha-2 destination code. Use list_destinations for supported countries.

destination_postcodestring, required

Destination postcode / ZIP.

hs_codestring

HS / tariff code, e.g. "6109100010". Required unless description is given.

quantityinteger

Number of items (default 1).

weight_kgnumber

Weight of one item in kg (optional).

descriptionstring

Product description, e.g. "cotton t-shirt". Required unless hs_code is given.

currency_codestring

ISO 4217 currency of the value, e.g. GBP (default), EUR, USD.

Tools (5)

estimate_duties

read-only

Argument	Type	Description
value*	number	Value of one item.
hs_code	string	HS / tariff code, e.g. "6109100010". Required unless description is given.
quantity	integer	Number of items (default 1).
weight_kg	number	Weight of one item in kg (optional).
description	string	Product description, e.g. "cotton t-shirt". Required unless hs_code is given.
currency_code	string	ISO 4217 currency of the value, e.g. GBP (default), EUR, USD.
country_of_origin*	string	ISO 3166-1 alpha-2 code of the country where the item was made, e.g. GB, CN.
destination_country*	string	ISO 3166-1 alpha-2 destination code. Use list_destinations for supported countries.
destination_postcode*	string	Destination postcode / ZIP.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "value",
    "country_of_origin",
    "destination_country",
    "destination_postcode"
  ],
  "properties": {
    "value": {
      "type": "number",
      "description": "Value of one item."
    },
    "hs_code": {
      "type": "string",
      "description": "HS / tariff code, e.g. \"6109100010\". Required unless description is given."
    },
    "quantity": {
      "type": "integer",
      "description": "Number of items (default 1)."
    },
    "weight_kg": {
      "type": "number",
      "description": "Weight of one item in kg (optional)."
    },
    "description": {
      "type": "string",
      "description": "Product description, e.g. \"cotton t-shirt\". Required unless hs_code is given."
    },
    "currency_code": {
      "type": "string",
      "description": "ISO 4217 currency of the value, e.g. GBP (default), EUR, USD."
    },
    "country_of_origin": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 code of the country where the item was made, e.g. GB, CN."
    },
    "destination_country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 destination code. Use list_destinations for supported countries."
    },
    "destination_postcode": {
      "type": "string",
      "description": "Destination postcode / ZIP."
    }
  }
}

estimate_shipping_price

Estimate the SAMOS price (GBP) to ship a parcel from the UK to a country, or to return a parcel from that country to the UK. Max weight 20 kg, max dimensions 100 cm x 43 cm x 43 cm.

read-only

Argument	Type	Description
type	string	"shipping" (UK to country, default) or "return" (country back to UK).
country*	string	Destination country (or origin country for returns), as a name like "France" or ISO 3166-1 alpha-2 code like "FR".
weight_kg*	number	Parcel weight in kg, between 0.1 and 20.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "country",
    "weight_kg"
  ],
  "properties": {
    "type": {
      "enum": [
        "shipping",
        "return"
      ],
      "type": "string",
      "description": "\"shipping\" (UK to country, default) or \"return\" (country back to UK)."
    },
    "country": {
      "type": "string",
      "description": "Destination country (or origin country for returns), as a name like \"France\" or ISO 3166-1 alpha-2 code like \"FR\"."
    },
    "weight_kg": {
      "type": "number",
      "description": "Parcel weight in kg, between 0.1 and 20."
    }
  }
}

list_destinations

List the countries SAMOS ships to from the UK, with their ISO codes and whether returns from that country are supported.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

search_help

Search the SAMOS help centre (FAQs) for answers about shipping, customs, IOSS, labels, returns and accounts. Returns the best matching questions and answers.

read-only

Argument	Type	Description
query*	string	The question or keywords, e.g. "do I need an IOSS number?"

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "The question or keywords, e.g. \"do I need an IOSS number?\""
    }
  }
}

track_parcel

Track a SAMOS parcel by tracking number. Returns tracking events, newest first, and local_carrier_tracking_url: a link to track the parcel with the local delivery company (e.g. UPS) once it has reached them. Share that link when the user wants more delivery detail.

read-only

Argument	Type	Description
tracking_number*	string	The SAMOS tracking number, e.g. SAM12345678.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "tracking_number"
  ],
  "properties": {
    "tracking_number": {
      "type": "string",
      "description": "The SAMOS tracking number, e.g. SAM12345678."
    }
  }
}