SAMOS e-commerce
Track SAMOS parcels, estimate UK shipping, return and duty costs, and search SAMOS help.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"samos": {
"url": "https://samos-e.com/api/mcp"
}
}
}Remote endpoints
https://samos-e.com/api/mcpstreamable-httpWhat it can do
Tool inventory
Tools (5)
🟢track_parcel(tracking_number)
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.
Input Schema
{
"type": "object",
"properties": {
"tracking_number": {
"description": "The SAMOS tracking number, e.g. SAM12345678.",
"type": "string"
}
},
"required": [
"tracking_number"
]
}🟢estimate_shipping_price(country, weight_kg, type)
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.
Input Schema
{
"type": "object",
"properties": {
"country": {
"description": "Destination country (or origin country for returns), as a name like \"France\" or ISO 3166-1 alpha-2 code like \"FR\".",
"type": "string"
},
"weight_kg": {
"description": "Parcel weight in kg, between 0.1 and 20.",
"type": "number"
},
"type": {
"description": "\"shipping\" (UK to country, default) or \"return\" (country back to UK).",
"enum": [
"shipping",
"return"
],
"type": "string"
}
},
"required": [
"country",
"weight_kg"
]
}🟢list_destinations
List the countries SAMOS ships to from the UK, with their ISO codes and whether returns from that country are supported.
Input Schema
{
"type": "object",
"properties": {}
}🟢search_help(query)
Search the SAMOS help centre (FAQs) for answers about shipping, customs, IOSS, labels, returns and accounts. Returns the best matching questions and answers.
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "The question or keywords, e.g. \"do I need an IOSS number?\"",
"type": "string"
}
},
"required": [
"query"
]
}🟢estimate_duties(description, hs_code, value, currency_code, quantity, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"description": {
"description": "Product description, e.g. \"cotton t-shirt\". Required unless hs_code is given.",
"type": "string"
},
"hs_code": {
"description": "HS / tariff code, e.g. \"6109100010\". Required unless description is given.",
"type": "string"
},
"value": {
"description": "Value of one item.",
"type": "number"
},
"currency_code": {
"description": "ISO 4217 currency of the value, e.g. GBP (default), EUR, USD.",
"type": "string"
},
"quantity": {
"description": "Number of items (default 1).",
"type": "integer"
},
"weight_kg": {
"description": "Weight of one item in kg (optional).",
"type": "number"
},
"country_of_origin": {
"description": "ISO 3166-1 alpha-2 code of the country where the item was made, e.g. GB, CN.",
"type": "string"
},
"destination_country": {
"description": "ISO 3166-1 alpha-2 destination code. Use list_destinations for supported countries.",
"type": "string"
},
"destination_postcode": {
"description": "Destination postcode / ZIP.",
"type": "string"
}
},
"required": [
"value",
"country_of_origin",
"destination_country",
"destination_postcode"
]
}Community
Evidence