Kargom
Compare Turkish cargo carriers, prepare domestic shipments and get labels from your Kargom account.
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": {
"kargom": {
"url": "https://kargom.com/mcp"
}
}
}Remote endpoints
https://kargom.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (10)
🟢get_shipping_prices(weight_kg, desi, length_cm, width_cm, height_cm, ...)
Prices of all Turkish cargo carriers for a parcel inside Türkiye, cheapest first. Only desi or weight is needed: the price is the same for every city and district, so one call covers all of Türkiye. No account needed. Signed-in prices can be lower (customer discounts). To ship, the user needs a Kargom account (kargom.com).
Input Schema
{
"type": "object",
"properties": {
"weight_kg": {
"type": "number",
"description": "Weight in kg",
"minimum": 0.01,
"maximum": 1000
},
"desi": {
"type": "number",
"description": "Desi (Turkish volumetric weight = length×width×height cm / 3000). Sellers often give only desi; then weight and size are not needed",
"minimum": 0.1,
"maximum": 1000
},
"length_cm": {
"type": "number",
"description": "Length in cm",
"minimum": 1,
"maximum": 300
},
"width_cm": {
"type": "number",
"description": "Width in cm",
"minimum": 1,
"maximum": 300
},
"height_cm": {
"type": "number",
"description": "Height in cm",
"minimum": 1,
"maximum": 300
},
"to_city": {
"type": "string",
"description": "Optional. Destination il; price does not change by city",
"maxLength": 40
},
"to_district": {
"type": "string",
"description": "Optional. Destination ilçe",
"maxLength": 60
},
"from_city": {
"type": "string",
"description": "Optional. Origin il",
"maxLength": 40
},
"from_district": {
"type": "string",
"description": "Optional. Origin ilçe",
"maxLength": 60
}
},
"additionalProperties": false
}🟢estimate_parcel(item, size)
Typical dimensions, weight and desi of an everyday item when the user names the item but not its size (e.g. "my suitcase"). Known items: suitcase, box, shoes, document, phone, laptop, clothes, book, cosmetics. Returns sizes (e.g. cabin / medium / large suitcase) and the billed desi to use for prices. If the user gives real measurements, use those instead.
Input Schema
{
"type": "object",
"properties": {
"item": {
"type": "string",
"description": "The item in the user’s words, e.g. \"orta boy valiz\", \"ayakkabı kutusu\"",
"maxLength": 80
},
"size": {
"type": "string",
"enum": [
"small",
"medium",
"large"
],
"description": "Optional size if the user said it"
}
},
"required": [
"item"
],
"additionalProperties": false
}🟢get_tracking_link(carrier, tracking_number)
The carrier’s own tracking page for a tracking number. No account needed.
Input Schema
{
"type": "object",
"properties": {
"carrier": {
"type": "string",
"enum": [
"yurtici",
"aras",
"mng",
"surat",
"ptt",
"hepsijet",
"ups",
"dhl",
"fedex"
],
"description": "Carrier"
},
"tracking_number": {
"type": "string",
"description": "Tracking number",
"maxLength": 40
}
},
"required": [
"carrier",
"tracking_number"
],
"additionalProperties": false
}🟢get_account
The connected Kargom account: name, balance (TRY), whether it can ship (sender profile complete), saved sender addresses (ids for quote_shipment) and this connection’s limits and usage today.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}🟢start_shipment(item, size, desi, weight_kg, recipient, ...)
Shows the Kargom card with cargo prices for a parcel inside Türkiye: typical sizes for items like a suitcase, the prices of all carriers and the user’s saved recipients. Read-only: opening the card charges nothing and creates nothing; a shipment is only created if the user themselves presses the confirm button inside the card. Use it for price questions and when the user wants to send something. If the user already named an address-book recipient and a carrier and asked to send, use create_shipment directly instead. Pass whatever the user already said (item, desi or kg, recipient name, carrier or "cheapest"). When the user named both the recipient and the carrier (or the cheapest), the card asks only the size and then ships by itself. For a recipient who is not in the address book, use quote_shipment with the full address.
Input Schema
{
"type": "object",
"properties": {
"item": {
"type": "string",
"description": "What is being sent, in the user’s words (e.g. \"valiz\", \"evrak\")",
"maxLength": 80
},
"size": {
"type": "string",
"enum": [
"small",
"medium",
"large"
],
"description": "Item size if the user said it (e.g. cabin suitcase = small)"
},
"desi": {
"type": "number",
"description": "Desi if the user gave it",
"minimum": 0.1,
"maximum": 1000
},
"weight_kg": {
"type": "number",
"description": "Weight in kg if the user gave it",
"minimum": 0.01,
"maximum": 1000
},
"recipient": {
"type": "string",
"description": "Recipient name, phone or city if the user said it",
"maxLength": 80
},
"carrier": {
"type": "string",
"description": "Carrier the user asked for (e.g. hepsijet), or \"cheapest\" when they said the cheapest / en uygun",
"maxLength": 30
}
},
"additionalProperties": false
}🟢find_recipient(query, limit)
Searches the user’s Kargom address book (saved recipients and people they shipped to before) by name, phone or city. Returns recipient_id values to use in quote_shipment instead of typing the address again. Without a query returns the most used recipients.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Name, phone or city (optional)",
"maxLength": 80
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"description": "How many (default 8)"
}
},
"additionalProperties": false
}🟢quote_shipment(recipient_id, recipient, sender_address_id, contents, weight_kg, ...)
Real prices for a domestic shipment from the user’s saved sender address to a recipient. Returns options with a quote_id each; a quote_id is valid for about 15 minutes, then call quote_shipment again. Nothing is charged.
Input Schema
{
"type": "object",
"properties": {
"recipient_id": {
"type": "string",
"description": "recipient_id from find_recipient (address book). Give this OR recipient",
"maxLength": 300
},
"recipient": {
"type": "object",
"additionalProperties": false,
"required": [
"name",
"phone",
"address",
"city",
"district"
],
"properties": {
"name": {
"type": "string",
"description": "Recipient full name",
"maxLength": 120
},
"phone": {
"type": "string",
"description": "Mobile phone, e.g. 05321234567",
"maxLength": 20
},
"address": {
"type": "string",
"description": "Street, building, door",
"maxLength": 250
},
"city": {
"type": "string",
"description": "İl",
"maxLength": 40
},
"district": {
"type": "string",
"description": "İlçe",
"maxLength": 60
},
"postcode": {
"type": "string",
"description": "Postcode (optional)",
"maxLength": 10
}
}
},
"sender_address_id": {
"type": "string",
"description": "Saved sender address id from get_account. Default: the first one",
"maxLength": 40
},
"contents": {
"type": "string",
"description": "What is inside (optional)",
"maxLength": 120
},
"weight_kg": {
"type": "number",
"description": "Weight in kg",
"minimum": 0.01,
"maximum": 1000
},
"desi": {
"type": "number",
"description": "Desi (Turkish volumetric weight = length×width×height cm / 3000). Sellers often give only desi; then weight and size are not needed",
"minimum": 0.1,
"maximum": 1000
},
"length_cm": {
"type": "number",
"description": "Length in cm",
"minimum": 1,
"maximum": 300
},
"width_cm": {
"type": "number",
"description": "Width in cm",
"minimum": 1,
"maximum": 300
},
"height_cm": {
"type": "number",
"description": "Height in cm",
"minimum": 1,
"maximum": 300
}
},
"additionalProperties": false
}🟢prepare_shipment(quote_id)
Saves the chosen quote as a shipment waiting for the user’s approval and returns an approval link on kargom.com. Nothing is charged and no label is created until the user opens the link, checks the details and pays there (Kargom balance or card). The user needs this link to approve. Same quote_id twice returns the same link. Use get_shipment with the returned approval_id to see if it was approved.
Input Schema
{
"type": "object",
"properties": {
"quote_id": {
"type": "string",
"description": "quote_id from quote_shipment",
"maxLength": 40
}
},
"required": [
"quote_id"
],
"additionalProperties": false
}🟢list_shipments(limit)
The user’s most recent shipments with status, carrier, tracking number and recipient city.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"description": "How many (default 10)"
}
},
"additionalProperties": false
}🟢get_shipment(shipment_id)
Status, tracking link and label link of one shipment (by shipment_id, Kargom reference, or the approval_id from prepare_shipment).
Input Schema
{
"type": "object",
"properties": {
"shipment_id": {
"type": "string",
"description": "shipment_id, reference or approval_id",
"maxLength": 40
}
},
"required": [
"shipment_id"
],
"additionalProperties": false
}Community
Evidence