Kargom
Compare Turkish cargo carriers, prepare domestic shipments and get labels from your Kargom account.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"kargom": {
"url": "https://kargom.com/mcp"
}
}
}원격 엔드포인트
https://kargom.com/mcpstreamable-http할 수 있는 일
도구 목록
도구 (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).
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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).
입력 스키마
{
"type": "object",
"properties": {
"shipment_id": {
"type": "string",
"description": "shipment_id, reference or approval_id",
"maxLength": 40
}
},
"required": [
"shipment_id"
],
"additionalProperties": false
}커뮤니티
증거