Freedom World MCP Server: เครื่องมือ AI Agent บน Blockchain

Freedom World MCP Server คืออะไร?

Freedom World MCP server เป็น TypeScript server ที่ implement สเปค Model Context Protocol (MCP) โดยให้ MCP-compatible AI client ทุกตัว ไม่ว่าจะเป็น Claude Desktop, Claude Code, ChatGPT, Cursor, Windsurf หรือ agent ที่สร้างเอง สามารถเข้าถึง platform API สองตัวผ่านโปรแกรมได้:

1. Freedom World API (api.freedom.social) — การจัดการ reputation ของชุมชน, ระบบคะแนน และการติดตาม tier

2. Suriya API (build.suriya.ai) — การ onboard merchant, catalog สินค้า, การจัดการออเดอร์, การประมวลผลการชำระเงิน Stripe และ revenue analytics

server ทำงานบน Node.js เครื่อง local และสื่อสารผ่าน stdio transport โดย authenticate ด้วย bearer token ไม่ต้องมีโครงสร้างพื้นฐานที่ host เพิ่มเติมฝั่งคุณ

ทำไมถึงสำคัญสำหรับนักพัฒนา: หากคุณกำลังสร้าง AI agent ที่ต้องเข้าใจระดับความน่าเชื่อถือของผู้ใช้, ประมวลผล model context protocol payments, จัดการการดำเนินงานของ merchant หรือถือ wallet ของตัวเอง — Freedom World MCP server ให้การเข้าถึงทั้งหมดนั้นผ่าน protocol ที่ AI client ของคุณรู้จักอยู่แล้ว นับเป็นหนึ่งใน MCP server blockchain integrations แรกๆ ที่รวม reputation กับ commerce เข้าด้วยกัน

Tool ที่ใช้งานได้ในปัจจุบัน

Freedom World MCP server เปิ��เผย 15 tool ใน 4 หมวดหมู่ โดย 11 tool พร้อมใช้งานและเชื่อมต่อกับ production API จริง ส่วนอีก 4 tool เป็น placeholder สำหรับ Phase 2

เริ่มต้นใช้งานภายใน 5 นาที

สิ่งที่ต้องมีก่อน

• Node.js 18+
• Freedom World access token (รับได้ที่ freedom.world)
• (ไม่บังคับ) Suriya API key สำหรับ merchant tools

ติดตั้งและ Build

git clone https://github.com/anthropics/freedom-mcp-server.git
cd freedom-mcp-server
npm install
npm run build

ตั้งค่า Environment Variables

export FREEDOM_ACCESS_TOKEN="your-token-here"
export FREEDOM_API_URL="https://api.freedom.social"    # ค่าเริ่มต้น
export FREEDOM_COMMUNITY_ID="507"                       # ค่าเริ่มต้น
export SURIYA_API_URL="https://build.suriya.ai"         # สำหรับ merchant tools
export SURIYA_API_KEY="your-suriya-key"                 # สำหรับ merchant tools

ตั้งค่า Claude Desktop

เพิ่ม block นี้ในไฟล์ claude_desktop_config.json เพื่อเชื่อมต่อ freedom world mcp server:

{
  "mcpServers": {
    "freedom-world": {
      "command": "node",
      "args": ["/path/to/freedom-mcp-server/dist/index.js"],
      "env": {
        "FREEDOM_API_URL": "https://api.freedom.social",
        "FREEDOM_COMMUNITY_ID": "507",
        "FREEDOM_ACCESS_TOKEN": "your-token",
        "SURIYA_API_URL": "https://build.suriya.ai",
        "SURIYA_API_KEY": "your-suriya-key"
      }
    }
  }
}

แทนที่ /path/to/freedom-mcp-server ด้วย absolute path ที่คุณ clone repository ไว้ และแทนที่ token กับ key ด้วย credentials จริงของคุณ

ทดสอบว่าใช้งานได้

เปิด Claude Desktop แล้วพิมพ์ในบทสนทนาใหม่:

"ดูประเภทคะแนนทั้งหมดใน Freedom World ให้หน่อย"

Claude จะเรียก tool list_point_types และแสดงหมวดหมู่คะแนน 7 ประเภท หากเห็น response แสดงว่าการเชื่อมต่อ MCP server blockchain ทำงานแล้ว

Reputation Tools

ระบบ reputation เป็นรากฐานของ community layer ของ Freedom World ผู้ใช้ทุกคนสะสมคะแนนใน 7 หมวดหมู่ ซึ่งรวมเข้าเป็นคะแนน tier

ระบบ Tier ทำงานอย่างไร

7 ประเภทคะแนน

แต่ละประเภทคะแนนสอดคล้องกับกิจกรรมเฉพาะ:

• custom_points — มอบให้ด้วยตนเองสำหรับกิจกรรมพิเศษ
• poster_points — ได้รับจากการสร้างโพสต์
• commenter_points — ได้รับจากการคอมเมนต์บนโพสต์
• chat_points — ได้รับจากการมีส่วนร่วมใน chat
• shop_points — ได้รับจากกิจกรรมในตลาด
• topup_points — ได้รับจากกิจกรรมการเติมเงิน/ชำระเงิน
• mission_points — ได้รับจากการทำ mission และงานที่กำหนด

get_user_reputation

คืนค่า breakdown คะแนนเต็มรูปแบบและคะแนนรวมของผู้ใช้ในชุมชน

MCP tool call:

{
  "name": "get_user_reputation",
  "arguments": {
    "user_id": "12345",
    "community_id": "507"
  }
}

ตัวอย่าง response:

{
  "payload": {
    "user_id": "12345",
    "community_id": "507",
    "custom_points": 150,
    "poster_points": 80,
    "commenter_points": 45,
    "chat_points": 30,
    "shop_points": 200,
    "topup_points": 50,
    "mission_points": 75,
    "total_score": 630
  }
}

ผู้ใช้รายนี้มีคะแนนรวม 630 อยู่ใน tier Gold

award_points

มอบคะแนนให้ผู้ใช้หนึ่งคนหรือหลายคนในการเรียกครั้งเดียว ต้องระบุ reason string สำหรับ audit log

{
  "name": "award_points",
  "arguments": {
    "updates": [
      { "user_id": "12345", "points": 50, "point_type": "mission_points" },
      { "user_id": "67890", "points": 25, "point_type": "custom_points" }
    ],
    "reason": "ทำงาน onboarding ไตรมาส 1 ครบ"
  }
}

use case จริงสำหรับ award_points:

• ชุมชนที่ AI ดูแล — co-working space ในกรุงเทพใช้ Freedom World community โดย AI agent คอยดู channel chat, ระบุคำตอบที่เป็นประโยชน์จากสมาชิก และมอบ commenter_points โดยอัตโนมัติ
• ยืนยัน mission อัตโนมัติ — merchant ค้าปลีกใช้ freedom world mcp server ตรวจสอบว่าลูกค้าทำ onboarding checklist ครบหรือยัง จากนั้นมอบ mission_points โดยไม่ต้องมีคนดูแล
• Referral program — มอบ custom_points เมื่อ agent ตรวจพบ referral สำเร็จจาก app ของ merchant

check_user_standing

คืนค่าคะแนน, tier และ tier threshold map เต็มรูปแบบของผู้ใช้

{
  "name": "check_user_standing",
  "arguments": {
    "user_id": "12345"
  }
}

ตัวอย่าง response:

{
  "user_id": "12345",
  "score": 630,
  "tier": "Gold",
  "thresholds": {
    "Bronze": "0-99",
    "Silver": "100-499",
    "Gold": "500-1999",
    "Platinum": "2000+"
  }
}

Use case: กำหนด feature หรือ content ตาม reputation tier agent จะตรวจสอบ standing ก่อนอนุญาตให้เข้าถึง channel พิเศษ, สินค้า exclusive หรือสิทธิ์ระดับสูง

Commerce Tools

Commerce tools เชื่อมต่อกับ Suriya merchant platform ซึ่งให้ AI agent จัดการ lifecycle ของ merchant ได้ครบวงจร ตั้งแต่การตั้งค่าจนถึง analytics เป็นหนึ่งใน AI agent developer tools บน blockchain ที่ครบสมบูรณ์ที่สุดสำหรับตลาด e-commerce ในเอเชียตะวันออกเฉียงใต้

create_payment_link

สร้าง Stripe PaymentIntent รองรับบัตรเครดิตและ PromptPay (สำหรับธุรกรรม THB) โดยระบุจำนวนเงินเป็นหน่วยเล็กที่สุดของสกุลเงิน — สตางค์สำหรับ THB ดังนั้น 12000 สตางค์ = 120 บาท

{
  "name": "create_payment_link",
  "arguments": {
    "merchant_id": "roast-bangkok",
    "amount": 12000,
    "description": "ออเดอร์ #abc123",
    "currency": "thb"
  }
}

Response:

{
  "ok": true,
  "merchant_id": "roast-bangkok",
  "amount": 12000,
  "currency": "thb",
  "client_secret": "pi_3abc...secret_xyz",
  "payment_intent_id": "pi_3abc...",
  "payment_methods": ["card", "promptpay"]
}

ใช้ client_secret กับ Stripe.js หรือ Stripe Elements เพื่อ render UI checkout ฝั่งลูกค้า นี่คือ model context protocol payments integration จริง ไม่ใช่ sandbox

get_orders

ดึงออเดอร์ของ merchant เรียงจากใหม่ไปเก่า กรองตามสถานะ: pending, confirmed, completed หรือ cancelled

{
  "name": "get_orders",
  "arguments": {
    "merchant_id": "roast-bangkok",
    "limit": 10,
    "status": "pending"
  }
}

Use case: AI agent คอยตรวจสอบออเดอร์ pending และแจ้ง merchant ผ่าน LINE หรือ chat เมื่อมีออเดอร์ใหม่เข้ามา พร้อม flag ออเดอร์ที่ค้างอยู่นานกว่า 15 นาทีเพื่อให้พนักงานจัดการก่อน

get_merchant_analytics

คืนค่า revenue metrics ในช่วงเวลาที่กำหนดได้ (7, 30 หรือ 90 วัน) รวมถึง GMV, จำนวนออเดอร์, average order value, สินค้ายอดนิยม, กราฟ revenue รายวัน และก���รเปรียบเทียบกับช่วงก่อนหน้า

{
  "name": "get_merchant_analytics",
  "arguments": {
    "merchant_id": "roast-bangkok",
    "period": "30"
  }
}

โครงสร้าง response:

{
  "merchant_id": "roast-bangkok",
  "period_days": 30,
  "gmv": 185000,
  "order_count": 142,
  "aov": 1302,
  "top_products": ["Flat White", "Cold Brew", "Croissant"],
  "daily_chart": [{"date": "2026-03-12", "revenue": 6200}],
  "vs_last_period": { "gmvChange": 12.5 }
}

Use case: AI agent สร้างรายงานธุรกิจรายสัปดาห์ที่ไฮไลต์แนวโน้ม revenue, สินค้าขายดี และการเติบโต 12.5% เทียบกับช่วงก่อนหน้า — ทั้งหมดจาก tool call เดียว

add_product

เพิ่มสินค้าหรือรายการในเมนูเข้า catalog ของ merchant

{
  "name": "add_product",
  "arguments": {
    "merchant_id": "roast-bangkok",
    "name": "Flat White",
    "price": 120,
    "category": "drinks",
    "description": "ดับเบิ้ลช็อตกับนมสด"
  }
}

ราคาเป็น THB สินค้าจะ sync ไปยัง storefront ของ merchant บน Freedom Mall

การ Onboard Merchant

get_onboarding_status

tool นี้คืนค่า checklist 6 ข้อที่ติดตามความคืบหน้าการตั���งค่าของ merchant เป็นสิ่งสำคัญสำหรับการสร้าง onboarding flow ที่ AI นำทางด้วย freedom world mcp server

{
  "name": "get_onboarding_status",
  "arguments": {
    "merchant_id": "roast-bangkok"
  }
}

Response:

{
  "merchant_id": "roast-bangkok",
  "checklist": {
    "identity_verified": true,
    "business_registered": true,
    "products_added": true,
    "payment_configured": false,
    "line_oa_connected": false,
    "google_business_listed": false
  },
  "progress": "3/6",
  "percent_complete": 50
}

6 ข้อใน checklist:

1. identity_verified — KYC/การยืนยันตัวตนเสร็จสมบูรณ์หรืออยู่ระหว่างรีวิว

2. business_registered — โครงสร้างพื้นฐาน merchant app พร้อมแล้ว (GitHub repo + Railway service)

3. products_added — มีสินค้าอย่างน้อยหนึ่งรายการใน catalog

4. payment_configured — ระบบชำระเงิน Stripe/Freedom Pay ทำงานแล้ว

5. line_oa_connected — เชื่อมต่อ LINE Official Account แล้ว

6. google_business_listed — เชื่อมต่อ Google Business Profile แล้ว

การสร้าง onboarding agent: AI assistant เรียก get_onboarding_status, ระบุขั้นตอนที่ยังไม่เสร็จ แล้วพา merchant ผ่านแต่ละขั้นตอนแบบสนทนา ตัวอย่างเช่น: "ฉันเห็นว่ายังไม่ได้ตั้งค่าระบบชำระเงิน ให้ฉันช่วยตั้งค่า Stripe account ของคุณ"

server ดึงข้อมูลจาก Suriya API endpoint 5 ตัวพร้อมกันเพื่อสร้าง checklist นี้ response จึงเร็วแม้จะรวมข้อมูลจากหลายระบบ

setup_merchant

เริ่มต้น merchant ใหม่และ provision โครงสร้างพื้นฐาน:

{
  "name": "setup_merchant",
  "arguments": {
    "business_name": "Roast Bangkok",
    "business_type": "cafe",
    "location": "สีลม กรุงเทพ",
    "owner_name": "Suriya Kittipong"
  }
}

ขั้นตอนนี้ provision โครงสร้างพื้นฐานของ merchant app (GitHub repo + Railway service) และคืน merchant_id slug โดย auth registration เต็มรูปแบบต้องทำผ่าน suriya.ai/start

Phase 2: Wallet และ Agent Identity

Freedom World MCP server มี wallet tool 4 ตัวที่กำหนดไว้แล้วในปัจจุบัน ซึ่งจะคืนค่า placeholder ระหว่างที่ wallet API อยู่ระหว่างพัฒนา

สิ่งที่กำลังจะมา

create_agent_wallet ��� AI agent จะมี wallet ของตัวเองบน Freedom World platform สามารถรับ, ถือ และใช้จ่าย FDW token ได้อย่างอิสระ

{
  "name": "create_agent_wallet",
  "arguments": {
    "agent_name": "support-bot-v2"
  }
}

get_wallet_balance — Query ยอดเงินและ token ที่ถือไว้ใน wallet ของ agent หรือผู้ใช้ใดก็ตาม

send_payment — การชำระเงินระหว่าง agent กับ agent หรือ agent กับ user AI agent สามารถจ่ายเงินให้ agent อื่นสำหรับบริการ หรือแจก reward ให้ผู้ใช้โดยตรง

{
  "name": "send_payment",
  "arguments": {
    "from_wallet_id": "agent-support-bot",
    "to_wallet_id": "user-12345",
    "amount": 50,
    "currency": "FDW",
    "memo": "Reward สำหรับทำ survey ครบ"
  }
}

register_agent_identity — ลงทะเบียน on-chain identity ที่ verified สำหรับ AI agent รวมถึงความสามารถที่ประกาศไว้ ทำให้เกิดการให้คะแนนความน่าเชื่อถือและ permissioned interactions merchant สามารถตรวจสอบได้ว่า agent ที่ขอข้อมูลออเดอร์เป็นใครจริงๆ

ทำไม Agent Identity ถึงสำคัญ

ในปัจจุบัน AI agent ส่วนใหญ่เป็น process ที่ไม่ระบุตัวตน พวกมัน authenticate ด้วย API key แต่ไม่มีวิธีมาตรฐานในการยืนยัน identity ของ agent หรือติดตาม reputation ของมัน

Freedom World Phase 2 นำโมเดล reputation เดียวกันที่ใช้กับผู้ใช้มาใช้กับ agent ด้วย:

• Agent สะสม reputation ผ่านการโต้ตอบที่สำเร็จ
• Agent และผู้ใช้อื่นสามารถตรวจสอบ standing ของ agent ก่อนที่จะไว้ใจ
• ชุมชนสามารถกำหนด tier requirement ขั้นต่ำสำหรับการกระทำของ agent

ทำให้ Freedom World MCP server เป็นหนึ่งใน AI agent developer tools บน blockchain แรกๆ ที่มี verifiable agent identity ในระดับ protocol

ทำไมถึงควรเลือก Freedom World เป็น Agent Economy Layer

ระบบนิเวศ MCP กำลังเติบโตอย่างรวดเร็ว Stripe, GoCardless และ Worldpay ต่างมี MCP server สำหรับการชำระเงิน BitGo, Coinbase และ CoinGecko มี server สำหรับข้อมูล crypto แต่เหล่านี้ล้วนเป็น single-purpose tools

Freedom World MCP server รวม 3 layer ที่ agent application ส่วนใหญ่ต้องการ:

1. Reputation เป็น Primitive

MCP server ส่วนใหญ่ assume trust โดยปริยาย Freedom World ทำให้ trust เป็นสิ่งที่ query ได้ agent ของคุณสามารถตรวจสอบ standing ของผู้ใช้ก่อนประมวลผลธุรกรรมมูลค่าสูง หรือมอบคะแนนหลังการโต้ตอบที่สำเร็จ Reputation กลายเป็นข้อมูลที่ agent อ่านและเขียนได้ ไม่ใช่แค่ badge บน UI

2. Commerce โดยไม่ต้องประกอบชิ้นส่วน

แทนที่จะต้องเชื่อมต่อ MCP server แยกต่างหากสำหรับการชำระเงิน (Stripe), การจัดการ���ินค้า (custom), การติดตามออเดอร์ (custom) และ analytics (custom) — Freedom World MCP server จัดการ merchant lifecycle ทั้งหมด server เดียว config block เดียว นี่คือ model context protocol payments ที่ถูกต้องอย่างแท้จริง

3. Agent-Native Identity (Phase 2)

ไม่มี MCP server blockchain integration ตัวไหนที่กำลังพัฒนาไปสู่ agent wallet และ on-chain agent identity เมื่อ Phase 2 เปิดตัว agent ของคุณจะไม่แค่เรียก tool เท่านั้น แต่จะมี wallet ของตัวเอง, reputation ของตัวเอง และ identity ที่ verify ได้

สรุป: หากคุณกำลังสร้าง AI agent ที่โต้ตอบกับผู้ใช้จริงและเงินจริง โดยเฉพาะในตลาดเอเชียตะวันออกเฉียงใต้ — freedom world mcp server มอบ economic infrastructure ในการ integrate เดียว อ่านคู่มือ how blockchain points programs work เพื่อทำความเข้าใจเศรษฐศาสตร์เบื้องหลัง

คำถามที่พบบ่อย

Freedom World MCP server คืออะไร?

เป็น MCP server (Model Context Protocol) โอเพนซอร์สที่เปิดเผย tool สำหรับการจัดการ reputation, commerce และ wallet เพื่อให้ AI assistant ที่รองรับ MCP ทุกตัว ไม่ว่าจะเป็น Claude, ChatGPT, Cursor และอื่นๆ สามารถโต้ตอบกับชุมชน Freedom World และโครงสร้างพื้นฐานของ Suriya merchant ในนามของผู้ใช้ได้

AI client ตัวใดบ้างที่ใช้งานร่วมกับ Freedom World MCP server ได้?

ใช้งานได้กับ MCP-compatible client ทุกตัว ทั้ง Claude Desktop, Claude Code, ChatGPT (ผ่าน MCP plugin), Cursor, Windsurf, Cline และ agent ที่สร้างเองด้วย MCP SDK

Freedom World MCP server ใช้งานฟรีหรือไม่?

ใช้งานฟรี server ใช้สัญญาอนุญาต MIT และติดตั้งได้โดยไม่มีค่าใช้จ่าย คุณต้องมี Freedom World access token และ Suriya API key (ถ้าต้องการ) เพื่อ authenticate กับ platform API

MCP server เขียนด้วยภาษาโปรแกรมมิงอะไร?

TypeScript ทำงานบน Node.js server ใช้ official MCP SDK และสื่อสารผ่าน stdio transport

AI agent สามารถชำระเงินจริงผ่าน MCP server ได้หรือไม่?

ได้ tool create_payment_link สร้าง Stripe PaymentIntent จริง รองรับบัตรเครดิตและ PromptPay (THB) โดยระบุจำนวนเงินเป็นหน่วยเล็กที่สุดของสกุลเงิน (สตางค์สำหรับ THB)

Phase 2 wallet tools คืออะไร?

Phase 2 จะเพิ่ม create_agent_wallet, get_wallet_balance, send_payment และ register_agent_identity ทำให้ AI agent สามารถถือ FDW token, ทำธุรกรรมระหว่าง wallet และมี on-chain identity ที่ verified ได้

ระบบ reputation ทำงานอย่างไร?

Freedom World ใช้โมเดล reputation แบบ tier โดยมีประเภทคะแนน 7 ชนิด (custom, poster, commenter, chat, shop, topup, mission) คะแนนสะสมเป็น tier ได้แก่ Bronze (0–99), Silver (100–499), Gold (500–1999) และ Platinum (2000+) AI agent สามารถ query และมอบคะแนนผ่านโปรแกรมได้ผ่าน freedom world mcp server

Freedom World แตกต่างจาก MCP server ของ Stripe อย่างไร?

MCP server ของ Stripe รองรับแค่การชำระเงิน ส่วน MCP server ของ Freedom World รวมการให้คะแนน reputation, commerce สำหรับ merchant (ออเดอร์, สินค้า, analytics, การชำระเงิน), การ onboard merchant และ agent wallet พร้อม on-chain identity ที่กำลังจะมาถึง — เป็น economic layer เต็มรูปแบบ ไม่ใช่แค่ระบบชำระเงิน