Gitsim Chat

Get Gitsim product knowledge, pricing model, IP routing guidance, and eSIM fundamentals. Call this FIRST before helping a customer so you understand the product.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search for eSIM data packages by country. Returns up to 10 packages per page sorted by price. Use the page parameter to paginate. No auth required. Call get_business_context first to understand IP routing and package types. Package types: - "regular": Fixed data pool (e.g. 3GB for 30 days). Best for most travelers. - "daily": Data resets each day (e.g. 2GB/day for 5 days). Good for short trips with predictable daily usage. Top-up days are available. IP routing (important for Asia): - "breakout": Local IP in destination country. Best for streaming, banking, social media. ALWAYS recommend by default. - "hk": Hong Kong IP. Cheapest but TikTok app and Facebook app are BLOCKED. - "nonhk": Third-country IP (UK, Singapore). No HK restrictions but IP won't match destination.

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "description": "ISO 3166-1 alpha-2 country code, e.g. JP, TH, US"
    },
    "min_data_gb": {
      "description": "Minimum data in GB. For daily packages this is the per-day amount.",
      "type": "number"
    },
    "max_data_gb": {
      "description": "Maximum data in GB. For daily packages this is the per-day amount.",
      "type": "number"
    },
    "min_duration_days": {
      "description": "Minimum duration in days",
      "type": "number"
    },
    "max_duration_days": {
      "description": "Maximum duration in days",
      "type": "number"
    },
    "ip_route": {
      "description": "Filter by IP routing type. \"breakout\" = local IP (recommended default), \"hk\" = Hong Kong IP (restricted, cheapest), \"nonhk\" = other breakout (no HK restrictions)",
      "type": "string",
      "enum": [
        "breakout",
        "hk",
        "nonhk"
      ]
    },
    "is_regional": {
      "description": "true = only multi-country/regional packages (e.g. Europe, Asia). false = only single-country packages. Omit for both.",
      "type": "boolean"
    },
    "type": {
      "description": "\"daily\" = data resets each day (e.g. 2GB/day for 5 days, can top-up days). \"regular\" = fixed data pool for the full duration. Omit for both.",
      "type": "string",
      "enum": [
        "daily",
        "regular"
      ]
    },
    "name": {
      "description": "Case-insensitive substring match on package name",
      "type": "string"
    },
    "page": {
      "description": "Page number (1-based, default 1). Each page returns up to 10 results.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "country"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get details for a specific eSIM package by its ID. No authentication required.

{
  "type": "object",
  "properties": {
    "package_id": {
      "type": "string",
      "description": "The package ID to look up"
    }
  },
  "required": [
    "package_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Create an order for an eSIM package. Returns a Stripe checkout URL where the user can pay. Requires a session key (from a previous tool call's structuredContent) or creates one automatically.

{
  "type": "object",
  "properties": {
    "package_id": {
      "type": "string",
      "description": "The package ID to order"
    },
    "session_key": {
      "description": "Session key from a previous tool call. If not provided, a new session is created automatically.",
      "type": "string"
    },
    "referral_code": {
      "description": "Optional referral code for a discount",
      "type": "string"
    }
  },
  "required": [
    "package_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Check the status of the most recent order. Requires a session key from a previous tool call.

{
  "type": "object",
  "properties": {
    "session_key": {
      "type": "string",
      "description": "Session key from a previous tool call"
    }
  },
  "required": [
    "session_key"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List the customer's delivered eSIMs. Requires a session key from a previous tool call.

{
  "type": "object",
  "properties": {
    "session_key": {
      "type": "string",
      "description": "Session key from a previous tool call"
    }
  },
  "required": [
    "session_key"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Check remaining data balance on an eSIM. Requires a session key and the eSIM's ICCID.

{
  "type": "object",
  "properties": {
    "session_key": {
      "type": "string",
      "description": "Session key from a previous tool call"
    },
    "iccid": {
      "type": "string",
      "description": "The ICCID of the eSIM to check"
    }
  },
  "required": [
    "session_key",
    "iccid"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find compatible top-up packages for an existing eSIM. Requires a session key and the eSIM's ICCID.

{
  "type": "object",
  "properties": {
    "session_key": {
      "type": "string",
      "description": "Session key from a previous tool call"
    },
    "iccid": {
      "type": "string",
      "description": "The ICCID of the eSIM to find top-ups for"
    }
  },
  "required": [
    "session_key",
    "iccid"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Purchase a top-up data package for an existing eSIM. Returns a Stripe checkout URL.

{
  "type": "object",
  "properties": {
    "session_key": {
      "type": "string",
      "description": "Session key from a previous tool call"
    },
    "iccid": {
      "type": "string",
      "description": "The ICCID of the eSIM to top up"
    },
    "package_code": {
      "type": "string",
      "description": "The package code from search_topup_packages results"
    }
  },
  "required": [
    "session_key",
    "iccid",
    "package_code"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}