API / MCP

สรุปสถานะ server แบบรวดเดียว: server_info + runtime resources (state/cpu/mem/disk) ใน call เดียว — ใช้แทนการเรียก server_info + server_resources แยกกัน

ไม่ต้องส่ง arguments (body ว่างได้)

curl -X POST https://api.mcsv.me/api/v1/tools/server_overview \
  -H "Authorization: Bearer <TOKEN>"

{
  "ok": true,
  "result": {
    "info": {
      "id": "a1b2c3d4-0000-4000-8000-1234567890ab",
      "name": "My Survival",
      "game": "minecraft-bedrock",
      "game_version": "latest",
      "server_type": "bedrock",
      "java_version": null,
      "status": "active",
      "port": 15188,
      "ports": [
        15188,
        20471,
        27805,
        39445,
        47832
      ],
      "pelican_identifier": "ab12cd34",
      "plan_id": "plan-uuid",
      "billing_cycle": "monthly",
      "expires_at": "2026-07-31T13:56:28.098043Z",
      "auto_renew": true,
      "custom_subdomain": "my-server",
      "node_id": "node-uuid",
      "created_at": "2026-04-10T21:45:25.918436Z"
    },
    "runtime": {
      "current_state": "running",
      "is_suspended": false,
      "resources": {
        "memory_bytes": 620482560,
        "cpu_absolute": 1.956,
        "disk_bytes": 1058903046,
        "network_rx_bytes": 1151507,
        "network_tx_bytes": 2140374,
        "uptime": 165518451
      }
    }
  }
}

ข้อมูล server: name, game, version, type, port, plan, status, expires_at, RAM/CPU/Disk specs

ไม่ต้องส่ง arguments (body ว่างได้)

curl -X POST https://api.mcsv.me/api/v1/tools/server_info \
  -H "Authorization: Bearer <TOKEN>"

{
  "ok": true,
  "result": {
    "id": "a1b2c3d4-0000-4000-8000-1234567890ab",
    "name": "My Survival",
    "game": "minecraft-bedrock",
    "game_version": "latest",
    "server_type": "bedrock",
    "java_version": null,
    "status": "active",
    "port": 15188,
    "ports": [
      15188,
      20471,
      27805,
      39445,
      47832
    ],
    "pelican_identifier": "ab12cd34",
    "plan_id": "plan-uuid",
    "billing_cycle": "monthly",
    "expires_at": "2026-07-31T13:56:28.098043Z",
    "auto_renew": true,
    "custom_subdomain": "my-server",
    "node_id": "node-uuid",
    "created_at": "2026-04-10T21:45:25.918436Z"
  }
}

Pelican runtime stats: current_state, CPU/RAM/Disk usage, uptime

ไม่ต้องส่ง arguments (body ว่างได้)

curl -X POST https://api.mcsv.me/api/v1/tools/server_resources \
  -H "Authorization: Bearer <TOKEN>"

{
  "ok": true,
  "result": {
    "current_state": "running",
    "is_suspended": false,
    "resources": {
      "memory_bytes": 620482560,
      "cpu_absolute": 1.956,
      "disk_bytes": 1058903046,
      "network_rx_bytes": 1151507,
      "network_tx_bytes": 2140374,
      "uptime": 165518451
    }
  }
}

ลิสต์ activity log ล่าสุดของ server (power/file/backup events)

curl -X POST https://api.mcsv.me/api/v1/tools/activity_log_recent \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"limit":20}'

{
  "ok": true,
  "result": {
    "logs": [
      {
        "id": "4eaac9fb-b8dd-4fac-bd96-c7cc20d5e532",
        "action": "mcp.server_resources",
        "actor_type": "user",
        "actor_id": "user-uuid",
        "metadata": {
          "via": "mcp",
          "server_id": "a1b2c3d4-0000-4000-8000-1234567890ab",
          "server_name": "My Survival"
        },
        "created_at": "2026-07-12T16:17:46.344592Z"
      },
      {
        "id": "0c5f1280-2d8e-4786-95ff-470f13b22ec6",
        "action": "mcp.server_info",
        "actor_type": "user",
        "actor_id": "user-uuid",
        "metadata": {
          "via": "mcp",
          "server_id": "a1b2c3d4-0000-4000-8000-1234567890ab",
          "server_name": "My Survival"
        },
        "created_at": "2026-07-12T16:17:46.296204Z"
      }
    ],
    "count": 3
  }
}

ดูข้อมูล domain ของ server (custom_subdomain, primary port, node hostname, dedicated IP)

ไม่ต้องส่ง arguments (body ว่างได้)

curl -X POST https://api.mcsv.me/api/v1/tools/domain_info \
  -H "Authorization: Bearer <TOKEN>"

{
  "ok": true,
  "result": {
    "custom_subdomain": "my-server",
    "full_domain": "my-server.mcsv.me",
    "node_hostname": "sv6.mcsv.me",
    "primary_port": 15188,
    "all_ports": [
      15188,
      20471,
      27805,
      39445,
      47832
    ],
    "dedicated_ip": null,
    "connect_address": "my-server.mcsv.me"
  }
}

List files+folders ใน directory (root = `/`). คืน name, size, is_file, mime, modified_at

curl -X POST https://api.mcsv.me/api/v1/tools/files_list \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"directory":"/"}'

{
  "ok": true,
  "result": {
    "directory": "/",
    "files": [
      {
        "name": "behavior_packs",
        "size": 4096,
        "is_file": false,
        "is_symlink": false,
        "mime": "inode/directory",
        "mode": "775",
        "modified_at": "2026-07-10T21:57:12+07:00"
      },
      {
        "name": "config",
        "size": 4096,
        "is_file": false,
        "is_symlink": false,
        "mime": "inode/directory",
        "mode": "775",
        "modified_at": "2026-06-25T02:30:24+07:00"
      },
      {
        "name": "data",
        "size": 4096,
        "is_file": false,
        "is_symlink": false,
        "mime": "inode/directory",
        "mode": "775",
        "modified_at": "2026-07-10T21:57:12+07:00"
      },
      {
        "name": "definitions",
        "size": 4096,
        "is_file": false,
        "is_symlink": false,
        "mime": "inode/directory",
        "mode": "775",
        "modified_at": "2026-06-25T02:30:23+07:00"
      }
    ],
    "total": 25,
    "shown": 25,
    "truncated": false
  }
}

อ่านไฟล์ text จาก Wings (max 200k chars). ใช้สำหรับ config/log/source ทั่วไป

curl -X POST https://api.mcsv.me/api/v1/tools/files_read \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"path":"/server.properties"}'

{
  "ok": true,
  "result": {
    "path": "server.properties",
    "content": "server-name=Dedicated Server\ngamemode=survival\nforce-gamemode=false\ndifficulty=easy\nallow-cheats=false\nmax-players=10\nonline-mode=true\nallow-list=false\nserver-port=15188\nserver-portv6=19133\ntransport=raknet\nenable-lan-vi…",
    "bytes": 1181,
    "truncated": false
  }
}

อ่านหลายไฟล์ในครั้งเดียว (สูงสุด 25 ไฟล์, รวม ~400k chars) — ใช้แทนการเรียก files_read ทีละไฟล์ เพื่อลด round-trip/rate-limit. คืน array ของ {path, content, bytes, truncated} หรือ {path, error}

curl -X POST https://api.mcsv.me/api/v1/tools/files_read_many \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"paths":["/server.properties","/spigot.yml"]}'

{
  "ok": true,
  "result": {
    "files": [
      {
        "path": "server.properties",
        "content": "server-name=Dedicated Server\ngamemode=survival\nforce-gamemode=false\ndifficulty=easy\nallow-cheats=false\nmax-players=10\non…",
        "bytes": 1181,
        "truncated": false
      },
      {
        "path": "permissions.json",
        "content": "[]\n",
        "bytes": 3,
        "truncated": false
      }
    ],
    "count": 2,
    "ok": 2
  }
}

ดาวน์โหลดไฟล์ (binary) จาก server เป็น base64 · ใช้กับไฟล์ที่ไม่ใช่ text (เช่น .jar, .png, world files) · cap 16MB raw — ใหญ่กว่านี้ใช้ files_download_url แทน

curl -X POST https://api.mcsv.me/api/v1/tools/files_read_base64 \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"path":"/server-icon.png"}'

{
  "ok": true,
  "result": {
    "success": true,
    "path": "permissions.json",
    "bytes": 3,
    "content_base64": "W10K"
  }
}

คืน signed URL ดาวน์โหลดไฟล์จาก Wings (TTL สั้น)

curl -X POST https://api.mcsv.me/api/v1/tools/files_download_url \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"file":"/world/level.dat"}'

{
  "ok": true,
  "result": {
    "url": "https://sv6.mcsv.me:8443/download/file?token=eyJ…"
  }
}

เขียนทับไฟล์ (สร้างใหม่ถ้าไม่มี). content เป็น UTF-8 text

curl -X POST https://api.mcsv.me/api/v1/tools/files_write \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"path":"/config/motd.txt","content":"Welcome to my server!"}'

{
  "ok": true,
  "result": {
    "success": true,
    "path": "/config/motd.txt",
    "bytes": 42
  }
}

ลบไฟล์/โฟลเดอร์ใน root (relative). ระวัง — ไม่มี recycle bin

curl -X POST https://api.mcsv.me/api/v1/tools/files_delete \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"root":"/","files":["old-world.zip"]}'

{
  "ok": true,
  "result": {
    "success": true,
    "deleted": 1,
    "root": "/"
  }
}

สร้างโฟลเดอร์ใหม่ใน root

curl -X POST https://api.mcsv.me/api/v1/tools/files_mkdir \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"root":"/","name":"backups"}'

{
  "ok": true,
  "result": {
    "success": true,
    "root": "/",
    "name": "backups"
  }
}

เปลี่ยนชื่อ/ย้ายหลายไฟล์ใน root (relative paths)

curl -X POST https://api.mcsv.me/api/v1/tools/files_rename \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"root":"/","renames":[{"from":"world-old","to":"world"}]}'

{
  "ok": true,
  "result": {
    "success": true,
    "count": 1,
    "root": "/"
  }
}

Copy ไฟล์/โฟลเดอร์ (จะได้ชื่อ ` copy`). location = absolute path

curl -X POST https://api.mcsv.me/api/v1/tools/files_copy \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"location":"/server.properties"}'

{
  "ok": true,
  "result": {
    "success": true,
    "location": "/server.properties"
  }
}

บีบอัดไฟล์/โฟลเดอร์ใน root เป็น .tar.gz (Pelican-managed)

curl -X POST https://api.mcsv.me/api/v1/tools/files_compress \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"root":"/","files":["world"]}'

{
  "ok": true,
  "result": {
    "success": true,
    "archive": {
      "name": "archive-2026-07-12.tar.gz",
      "size": 10485760
    }
  }
}

แตก archive ใน root (tar/tar.gz/zip)

curl -X POST https://api.mcsv.me/api/v1/tools/files_decompress \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"root":"/","file":"world-backup.zip"}'

{
  "ok": true,
  "result": {
    "success": true,
    "root": "/",
    "file": "world-backup.zip"
  }
}

อัพโหลดไฟล์ (binary) ไปยัง server · content เป็น base64 (เหมาะกับ .jar, .zip, รูป, world, schema) · text ธรรมดาควรใช้ files_write

curl -X POST https://api.mcsv.me/api/v1/tools/files_upload_base64 \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"path":"/plugins/MyPlugin.jar","content_base64":"UEsDBBQAAAAI…"}'

{
  "ok": true,
  "result": {
    "success": true,
    "path": "/plugins/MyPlugin.jar",
    "bytes": 245760
  }
}

ดาวน์โหลดไฟล์จาก URL ภายนอก (plugin/mod/world จาก GitHub release, Modrinth, Spigot, jsDelivr ฯลฯ) เข้า server · MCSV API ดึงไฟล์ผ่าน server-side แล้วเขียนลง Wings · เฉพาะ http/https · บล็อก private IP · cap 64MB

curl -X POST https://api.mcsv.me/api/v1/tools/files_fetch_url \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://cdn.modrinth.com/data/…/EssentialsX-2.20.1.jar","directory":"/plugins/"}'

{
  "ok": true,
  "result": {
    "success": true,
    "url": "https://cdn.modrinth.com/…/EssentialsX-2.20.1.jar",
    "path": "/plugins/EssentialsX-2.20.1.jar",
    "size": 1048576
  }
}

อ่าน N บรรทัดล่าสุดของ /logs/latest.log

curl -X POST https://api.mcsv.me/api/v1/tools/console_tail \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"lines":100}'

{
  "ok": true,
  "result": {
    "lines": [
      "[12:00:01] Server started.",
      "[12:00:05] Player Steve joined the game"
    ],
    "count": 2
  }
}

ส่งคำสั่งเข้า server console (เช่น `say hello`, `tps`, `op user`). ไม่มี filter — owner เท่านั้น

curl -X POST https://api.mcsv.me/api/v1/tools/console_send \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"command":"say Server restarting in 5 minutes!"}'

{
  "ok": true,
  "result": {
    "success": true,
    "command": "say Server restarting in 5 minutes!"
  }
}

Start/stop/restart/kill server

curl -X POST https://api.mcsv.me/api/v1/tools/power_action \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"action":"restart"}'

{
  "ok": true,
  "result": {
    "success": true,
    "action": "restart"
  }
}

ลิสต์ backup ของ server (ซ่อน admin hidden backups)

ไม่ต้องส่ง arguments (body ว่างได้)

curl -X POST https://api.mcsv.me/api/v1/tools/backups_list \
  -H "Authorization: Bearer <TOKEN>"

{
  "ok": true,
  "result": {
    "backups": [
      {
        "uuid": "b497a1c0-1bee-4340-bec6-35361174cdfa",
        "name": "post-transfer-20260612-073309",
        "bytes": 233886104,
        "created_at": "2026-06-12T07:33:09+00:00",
        "completed_at": "2026-06-12T07:33:09+00:00",
        "is_successful": true,
        "is_locked": false
      }
    ],
    "count": 10
  }
}

สร้าง backup ใหม่ (full server tar.gz). name เป็น optional label

curl -X POST https://api.mcsv.me/api/v1/tools/backups_create \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"name":"before-update"}'

{
  "ok": true,
  "result": {
    "success": true,
    "uuid": "0b9f7a3c-5e21-4d6a-9c7f-2f8e4a1b6d90",
    "name": "before-update"
  }
}

Restore backup. truncate=true จะลบไฟล์ปัจจุบันก่อน restore (เสี่ยง)

curl -X POST https://api.mcsv.me/api/v1/tools/backups_restore \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"uuid":"0b9f7a3c-5e21-4d6a-9c7f-2f8e4a1b6d90","truncate":false}'

{
  "ok": true,
  "result": {
    "success": true,
    "uuid": "0b9f7a3c-5e21-4d6a-9c7f-2f8e4a1b6d90"
  }
}

ลบ backup ตาม uuid

curl -X POST https://api.mcsv.me/api/v1/tools/backups_delete \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"uuid":"0b9f7a3c-5e21-4d6a-9c7f-2f8e4a1b6d90"}'

{
  "ok": true,
  "result": {
    "success": true,
    "uuid": "0b9f7a3c-5e21-4d6a-9c7f-2f8e4a1b6d90"
  }
}

เปลี่ยนชื่อ server ใน DB (ไม่ใช่ MOTD)

curl -X POST https://api.mcsv.me/api/v1/tools/server_rename \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"name":"My Survival"}'

{
  "ok": true,
  "result": {
    "success": true,
    "name": "My Survival"
  }
}

เขียน eula.txt = true (จำเป็นก่อน start Java MC ครั้งแรก)

ไม่ต้องส่ง arguments (body ว่างได้)

curl -X POST https://api.mcsv.me/api/v1/tools/eula_accept \
  -H "Authorization: Bearer <TOKEN>"

{
  "ok": true,
  "result": {
    "success": true
  }
}

Patch key=value ใน server.properties (preserve order, ไม่ทำลาย comment)

curl -X POST https://api.mcsv.me/api/v1/tools/server_properties_patch \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"updates":{"motd":"Welcome to MCSV","max-players":"50"}}'

{
  "ok": true,
  "result": {
    "success": true,
    "updated": 2,
    "keys": [
      "motd",
      "max-players"
    ],
    "hint": "restart server เพื่อให้ค่าใหม่มีผล"
  }
}

ลิสต์ .jar ใน /plugins (Paper/Spigot/Bukkit) หรือ /mods (Forge/Fabric)

ไม่ต้องส่ง arguments (body ว่างได้)

curl -X POST https://api.mcsv.me/api/v1/tools/plugins_list \
  -H "Authorization: Bearer <TOKEN>"

{
  "ok": true,
  "result": {
    "directory": "/plugins",
    "plugins": [
      {
        "file": "EssentialsX-2.20.1.jar",
        "size": 1048576,
        "enabled": true
      }
    ],
    "count": 1
  }
}

สแกน .jar ใน /plugins + /mods หามัลแวร์ที่รู้จัก: jar infector ตระกูล ServerLibs/LibAPI (ฝังตัวลามข้าม jar → ปลั๊กอิน/Geyser พังสุ่ม ต้องรีเซิร์ฟบ่อย) + xmrig cryptominer · คืนรายชื่อ jar ที่ติด + family/markers · ⚠️ ตรวจแบบ signature = จับเฉพาะมัลแวร์ที่รู้จักแล้ว ไม่ใช่การรับประกันว่าสะอาด 100% (partial detection)

ไม่ต้องส่ง arguments (body ว่างได้)

curl -X POST https://api.mcsv.me/api/v1/tools/security_scan \
  -H "Authorization: Bearer <TOKEN>"

{
  "ok": true,
  "result": {
    "scanned": 0,
    "infected_count": 0,
    "clean_count": 0,
    "infected": [],
    "verdict": "CLEAN",
    "disclaimer": "signature-based scan — detects KNOWN malware only (ServerLibs/LibAPI jar infector + xmrig miner). NOT a guarantee the server is clean."
  }
}

ค้น plugin/mod จาก Modrinth + Hangar (PaperMC) · คืนชื่อ/slug/คำอธิบาย/ยอดโหลด/หน้าโปรเจกต์ · เอา URL ดาวน์โหลดไปใช้กับ files_fetch_url เพื่อติดตั้งได้ · กรองด้วย loader (paper/fabric/forge/...) + game_version ได้

curl -X POST https://api.mcsv.me/api/v1/tools/search_mods \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"query":"essentials","loader":"paper","game_version":"1.21.1"}'

{
  "ok": true,
  "result": {
    "query": "sodium",
    "modrinth": [],
    "hangar": [
      {
        "source": "hangar",
        "title": "GoogleGeminiAIGod",
        "slug": "GoogleGeminiAIGod",
        "description": "Toil at the whim of your ai master! Take photos, build monuments, burn to death, and other fun stuff",
        "downloads": 22,
        "url": "https://hangar.papermc.io/ConnorBP/GoogleGeminiAIGod"
      }
    ],
    "hint": "ดาวน์โหลด .jar ไปติดตั้งด้วย files_fetch_url (เปิดหน้า project หา URL ดาวน์โหลดของเวอร์ชันที่ตรง loader/เวอร์ชันเกม)"
  }
}

ลิสต์ MySQL/MariaDB databases ของ server (โชว์ user/password/host/port/connection string)

ไม่ต้องส่ง arguments (body ว่างได้)

curl -X POST https://api.mcsv.me/api/v1/tools/databases_list \
  -H "Authorization: Bearer <TOKEN>"

{
  "ok": true,
  "result": {
    "databases": [
      {
        "id": 148,
        "name": "s2053_test",
        "username": "u2053_Ab12Cd34",
        "host": "db6.mcsv.me",
        "port": 3306,
        "password": "p4ssw0rd_Example123",
        "connection_string": "mysql://u2053_Ab12Cd34:p4ssw0rd_Example123@db6.mcsv.me:3306/s2053_test"
      }
    ],
    "count": 1
  }
}

สร้าง MySQL/MariaDB database ใหม่ · name a-z/0-9/_ · 1-48 chars · จะคืน connection string + password

curl -X POST https://api.mcsv.me/api/v1/tools/databases_create \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"name":"shop"}'

{
  "ok": true,
  "result": {
    "success": true,
    "id": 152,
    "name": "s2053_shop",
    "username": "u2053_Ab12Cd34",
    "host": "db6.mcsv.me",
    "port": 3306,
    "password": "p4ssw0rd_Example123",
    "connection_string": "mysql://u2053_Ab12Cd34:p4ssw0rd_Example123@db6.mcsv.me:3306/s2053_shop"
  }
}

ลบ database ตาม id (จาก databases_list)

curl -X POST https://api.mcsv.me/api/v1/tools/databases_delete \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"database_id":"152"}'

{
  "ok": true,
  "result": {
    "success": true,
    "database_id": "152"
  }
}

ลิสต์ cron schedules ของ server (auto restart, periodic commands, etc.)

ไม่ต้องส่ง arguments (body ว่างได้)

curl -X POST https://api.mcsv.me/api/v1/tools/schedules_list \
  -H "Authorization: Bearer <TOKEN>"

{
  "ok": true,
  "result": {
    "schedules": [
      {
        "id": "b34e970b-8c9e-40ac-a18a-4d1aaa392d74",
        "name": "Auto restart ทุกวัน ตอนตี 4",
        "action_type": "power",
        "action_data": {
          "signal": "restart"
        },
        "cron_expression": "*/1 * * * *",
        "timezone": "Asia/Bangkok",
        "is_active": false,
        "last_run_at": "2026-05-10T04:16:00.001516Z",
        "next_run_at": null
      }
    ],
    "count": 1
  }
}

สร้าง schedule ใหม่ · action_type=`command` (action_data.command=string) | `power` (action_data.signal=start/stop/restart/kill) · cron_expression=5-field cron · timezone default `Asia/Bangkok`

curl -X POST https://api.mcsv.me/api/v1/tools/schedules_create \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"name":"restart ทุกเช้า","action_type":"power","action_data":{"signal":"restart"},"cron_expression":"0 6 * * *","timezone":"Asia/Bangkok"}'

{
  "ok": true,
  "result": {
    "success": true,
    "schedule_id": "f3d2c1b0-1111-4222-8333-444455556666",
    "name": "restart ทุกเช้า",
    "cron_expression": "0 6 * * *",
    "next_run_at": "2026-07-13T06:00:00+07:00"
  }
}

ลบ schedule ตาม id

curl -X POST https://api.mcsv.me/api/v1/tools/schedules_delete \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"schedule_id":"f3d2c1b0-1111-4222-8333-444455556666"}'

{
  "ok": true,
  "result": {
    "success": true,
    "schedule_id": "f3d2c1b0-1111-4222-8333-444455556666"
  }
}

เปิด/ปิด schedule · `is_active`=true เปิด · false ปิด (ไม่รัน cron แต่ยังเก็บ config)

curl -X POST https://api.mcsv.me/api/v1/tools/schedules_toggle \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"schedule_id":"f3d2c1b0-1111-4222-8333-444455556666","is_active":false}'

{
  "ok": true,
  "result": {
    "success": true,
    "schedule_id": "f3d2c1b0-1111-4222-8333-444455556666",
    "is_active": false,
    "next_run_at": null
  }
}

ลิสต์ Discord/JSON webhooks ของ server (events ที่ subscribe ไว้)

ไม่ต้องส่ง arguments (body ว่างได้)

curl -X POST https://api.mcsv.me/api/v1/tools/webhooks_list \
  -H "Authorization: Bearer <TOKEN>"

{
  "ok": true,
  "result": {
    "webhooks": [
      {
        "id": "c029c4a1-2e5c-4121-812c-be6a036ed47a",
        "name": "TEST",
        "url_masked": "https://discord.com/api/webhooks/14•••••",
        "format": "discord",
        "events": {
          "server.kill": true,
          "file.deleted": true,
          "member.added": true,
          "…": true
        },
        "is_active": false,
        "created_at": "2026-05-25T09:11:48.738080Z"
      }
    ],
    "count": 1
  }
}

สร้าง webhook · format=`discord` (Discord webhook URL) | `json` (generic POST) · events=object map { "server.started": true, ... } · valid events: server.started/stopped/restart/kill/crashed, backup.created/restored, plugin.installed/uninstalled, file.uploaded/deleted/modified, member.added/removed, database.created/deleted, server.renewed/expiring

curl -X POST https://api.mcsv.me/api/v1/tools/webhooks_create \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"name":"Discord แจ้งเตือน","url":"https://discord.com/api/webhooks/…","format":"discord","events":{"server.started":true,"server.stopped":true,"backup.created":true}}'

{
  "ok": true,
  "result": {
    "success": true,
    "webhook_id": "c029c4a1-2e5c-4121-812c-be6a036ed47a",
    "name": "Discord แจ้งเตือน"
  }
}

ลบ webhook ตาม id

curl -X POST https://api.mcsv.me/api/v1/tools/webhooks_delete \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"webhook_id":"c029c4a1-2e5c-4121-812c-be6a036ed47a"}'

{
  "ok": true,
  "result": {
    "success": true,
    "webhook_id": "c029c4a1-2e5c-4121-812c-be6a036ed47a"
  }
}

ส่ง test event ไปยัง webhook (ดูว่า URL+format ใช้งานได้)

curl -X POST https://api.mcsv.me/api/v1/tools/webhooks_test \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"webhook_id":"c029c4a1-2e5c-4121-812c-be6a036ed47a"}'

{
  "ok": true,
  "result": {
    "success": true,
    "webhook_id": "c029c4a1-2e5c-4121-812c-be6a036ed47a",
    "message": "test sent"
  }
}

ลิสต์ team members ของ server (user_id, email, permissions)

ไม่ต้องส่ง arguments (body ว่างได้)

curl -X POST https://api.mcsv.me/api/v1/tools/members_list \
  -H "Authorization: Bearer <TOKEN>"

{
  "ok": true,
  "result": {
    "members": [
      {
        "id": "c3d4e5f6-0000-4000-8000-fedcbafedcba",
        "user_id": "b2c3d4e5-0000-4000-8000-abcdefabcdef",
        "email": "friend@example.com",
        "display_name": "Friend",
        "permissions": {
          "power": true,
          "use_ai": true,
          "files_read": true,
          "files_write": true,
          "console_read": true,
          "console_write": true,
          "settings_edit": true,
          "settings_view": true,
          "databases_read": true,
          "manage_members": false,
          "players_manage": true,
          "plugins_manage": true,
          "databases_admin": true,
          "databases_write": true
        },
        "created_at": "2026-04-17T23:46:48.550468Z"
      }
    ],
    "count": 1
  }
}

ลบสมาชิกออกจาก server (revoke access)

curl -X POST https://api.mcsv.me/api/v1/tools/members_remove \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"member_id":"c3d4e5f6-0000-4000-8000-fedcbafedcba"}'

{
  "ok": true,
  "result": {
    "success": true,
    "member_id": "c3d4e5f6-0000-4000-8000-fedcbafedcba"
  }
}

ดึงเนื้อหาหน้าเว็บ (เช่น doc/wiki/GitHub README) แล้วคืนเป็น plain text · http/https เท่านั้น · บล็อก private IP · ตัดที่ ~15000 ตัวอักษร

curl -X POST https://api.mcsv.me/api/v1/tools/web_fetch \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://docs.papermc.io/paper/getting-started"}'

{
  "ok": true,
  "result": {
    "url": "https://mcsv.me/llms.txt",
    "content": "# MCSV — เช่าเปิดเซิร์ฟเวอร์ Minecraft (โฮสติ้งไทย)\n\n> MCSV (mcsv.me) คือบริการเช่าเปิดเซิร์ฟเวอร์ Minecraft สัญชาติไทย ดาต้าเซ็นเตอร์กรุงเทพฯ\n> ปิงต่ำสำหรับผู้เล่นในไทย/เอเชียตะวันออกเฉียงใต้ สร้างเซ…",
    "truncated": false
  }
}