ใช้ทำอะไรได้
ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ
- ต่อแบบ ติดตั้งในเครื่อง
- บัญชีหรือคีย์ ต้องมี DARAJA_CONSUMER_KEY, DARAJA_CONSUMER_SECRET, DARAJA_PASSKEY, DARAJA_SECURITY_CREDENTIAL, DARAJA_CALLBACK_TOKEN, DARAJA_INITIATOR_PASSWORD, DARAJA_MCP_TOKEN, DARAJA_FORWARD_SECRET
- หมวด เครื่องมือนักพัฒนา
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
Safaricom M-Pesa Daraja tools: STK Push, C2B, B2C, B2B, QR, Ratiba. Sandbox-first, idempotent.ใช้คู่กับ
Skill ที่สอน AI ทำงานแบบนี้ ใช้ร่วมกับตัวนี้ได้
andrej-karpathy-skills
andrej-karpathy-skills เป็นไฟล์ CLAUDE.md ไฟล์เดียวที่ใช้ปรับพฤติกรรมของ Claude Code ให้ดีขึ้น โดยอ้างอิงจากข้อสังเกตของ Andrej Karpathy เกี่ยวกับข้อผิดพลาดที่พบบ่อยเมื่อ LLM เขียนโค้ด
ทำไมอยู่อันดับนี้
หน้ารายการเรียงด้วยคะแนนการใช้งาน (เต็ม 100) จากส่วนเหล่านี้
| ความนิยม | 0/80 | ดาว GitHub หรือยอดดาวน์โหลดต่อสัปดาห์ ค่ามากนับ 60 ค่าน้อยนับ 20 |
|---|---|---|
| ความสด | 12/12 | ออกรุ่นหรือแก้โค้ดใน 30 วัน ได้เต็ม |
| ระบบยังตอบ | 0/8 | endpoint บนคลาวด์ตอบตอนตรวจล่าสุด |
| คะแนนการใช้งาน | 12/100 |
คุณภาพ: ผลตรวจเบื้องต้นผ่าน 3/3 ข้อ (แสดงให้ดู ไม่ได้ใช้เรียง) · ความมาแรง: ยังไม่มีข้อมูล (ใช้เรียงเฉพาะแท็บมาแรง)
ติดตั้ง
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
ให้ AI ติดตั้งให้ด้วยประโยคเดียว
ติดตั้ง M-Pesa Daraja ให้หน่อย ทำตาม https://mcp.popnx.com/i/mr-macharia-mpesa-daraja-mcp.md แสดงคำสั่งให้ฉันดูและรอฉันตกลงก่อนรันคัดลอกไปวางในแชตของ AI ที่ทำงานในเครื่องคุณได้ (เช่น Claude Code, Cursor) · AI จะอ่านขั้นตอนจากเรา แสดงคำสั่งให้ดู และรอคุณตกลงก่อน · ไม่ต้องใช้คีย์ ไม่ต้องสมัคร · ดูข้อความเต็มที่ AI จะอ่าน
ผลตรวจผ่าน 3/3 · ทำงานบนเครื่องคุณ · ✓ ตรวจคำสั่งแล้ว 14 พ.ย. 2569
ขั้นแรก: คุณใช้ AI ตัวไหน
เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง
ต่อกับ Claude ได้ แต่ต้องเตรียมก่อน
ต้องมีคีย์ของ M-Pesa Daraja (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว) · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ
ให้ AI ติดตั้งให้
คัดลอกข้อความนี้ไปวางในแชตของ Claude AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง
ช่วยติดตั้ง MCP server ชื่อ M-Pesa Daraja ให้ Claude ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี uv ด้วยคำสั่ง uv --version ถ้าไม่มี ให้บอกฉันไปลงจาก https://docs.astral.sh/uv/getting-started/installation/ ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): { "mcpServers": { "mpesa-daraja": { "command": "uvx", "args": [ "mpesa-daraja-mcp" ], "env": { "DARAJA_CONSUMER_KEY": "ใส่ค่าของคุณ", "DARAJA_CONSUMER_SECRET": "ใส่ค่าของคุณ", "DARAJA_PASSKEY": "ใส่ค่าของคุณ", "DARAJA_SECURITY_CREDENTIAL": "ใส่ค่าของคุณ", "DARAJA_CALLBACK_TOKEN": "ใส่ค่าของคุณ", "DARAJA_INITIATOR_PASSWORD": "ใส่ค่าของคุณ", "DARAJA_MCP_TOKEN": "ใส่ค่าของคุณ", "DARAJA_FORWARD_SECRET": "ใส่ค่าของคุณ" } } } } 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง DARAJA_CONSUMER_KEY, DARAJA_CONSUMER_SECRET, DARAJA_PASSKEY, DARAJA_SECURITY_CREDENTIAL, DARAJA_CALLBACK_TOKEN, DARAJA_INITIATOR_PASSWORD, DARAJA_MCP_TOKEN, DARAJA_FORWARD_SECRET ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ M-Pesa Daraja ขึ้นจริงข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป
ลง uv ในเครื่อง (ถ้ายังไม่มี)
ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter
uv --version- ขึ้นเลขรุ่น เช่น uv … = ลงแล้ว ข้ามขั้นนี้ได้
- ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
เปิด Terminal ยังไง
Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter
Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open
ยังไม่ได้ลง: uv ไม่มีตัวติดตั้งแบบกดเอง คัดลอกคำสั่งหนึ่งบรรทัดของเครื่องคุณ (macOS หรือ Windows) จากหน้าทางการของ uv ไปวางใน Terminal · ไม่ต้องลง Python แยก uv ดาวน์โหลดให้เองเมื่อต้องใช้
ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น:
uv --versionลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ uv
สมัครและสร้างคีย์ของ M-Pesa Daraja
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
เปิดไฟล์ตั้งค่าของแอป Claude บนคอม
SettingsDeveloperEdit Config
วางค่าตั้งนี้แล้วบันทึกไฟล์
{ "mcpServers": { "mpesa-daraja": { "command": "uvx", "args": [ "mpesa-daraja-mcp" ], "env": { "DARAJA_CONSUMER_KEY": "ใส่ค่าของคุณ", "DARAJA_CONSUMER_SECRET": "ใส่ค่าของคุณ", "DARAJA_PASSKEY": "ใส่ค่าของคุณ", "DARAJA_SECURITY_CREDENTIAL": "ใส่ค่าของคุณ", "DARAJA_CALLBACK_TOKEN": "ใส่ค่าของคุณ", "DARAJA_INITIATOR_PASSWORD": "ใส่ค่าของคุณ", "DARAJA_MCP_TOKEN": "ใส่ค่าของคุณ", "DARAJA_FORWARD_SECRET": "ใส่ค่าของคุณ" } } } }วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
ปิดแอป Claude แล้วเปิดใหม่
ลองเลย
ใช้ M-Pesa Daraja บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude บอกว่ากำลังใช้ M-Pesa Daraja หรือมีชื่อเครื่องมือของ M-Pesa Daraja ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ค่าตั้งเพิ่มเติม 18 ช่อง (ไม่ต้องกรอกก็ใช้ได้)
คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ
DARAJA_ENVsandbox (ค่าเริ่มต้น) หรือ productionดูต้นฉบับภาษาอังกฤษ
sandbox (default) or productionDARAJA_SHORTCODEหมายเลข Paybill / หมายเลขร้านค้า (174379 ในแซนด์บ็อกซ์)ดูต้นฉบับภาษาอังกฤษ
Paybill / store number (174379 in sandbox)DARAJA_INITIATOR_NAMEAPI operator username (B2C, B2B, status, balance, reversal)DARAJA_CALLBACK_BASE_URLฐาน HTTPS สาธารณะสำหรับ URL สำหรับ callbackดูต้นฉบับภาษาอังกฤษ
Public HTTPS base for callback URLsDARAJA_CALLBACK_LISTENhost:port สำหรับตัวรับ callback ที่มาพร้อมในตัวดูต้นฉบับภาษาอังกฤษ
host:port for the built-in callback receiverDARAJA_TOOLSETSรายการคั่นด้วยเครื่องหมายจุลภาค: stk,c2b,payouts,ops,qr,ratiba,billmanagerดูต้นฉบับภาษาอังกฤษ
Comma list: stk,c2b,payouts,ops,qr,ratiba,billmanagerDARAJA_READ_ONLYtrue จะซ่อนเครื่องมือทั้งหมดที่เกี่ยวข้องกับการโอนเงินหรือการเขียนข้อมูลดูต้นฉบับภาษาอังกฤษ
true hides every tool that moves money or writesDARAJA_APPROVAL_THRESHOLDการจ่ายเงินที่เกินจำนวนชิลลิงนี้ต้องได้รับการอนุมัติในแชตดูต้นฉบับภาษาอังกฤษ
Payouts above this many shillings need approval in the chatDARAJA_ALLOWED_RECIPIENTSรายการหมายเลขโทรศัพท์หรือรหัสย่อที่การจ่ายเงิน (payouts) อาจส่งไปถึงได้ คั่นด้วยเครื่องหมายจุลภาคดูต้นฉบับภาษาอังกฤษ
Comma list of phones/shortcodes that payouts may go toDARAJA_ALLOW_LIVE_MONEY_MOVEMENTtrue เพื่ออนุญาตให้มีการเรียกเก็บเงินและการจ่ายเงินในระบบใช้งานจริงดูต้นฉบับภาษาอังกฤษ
true to allow production charges and payoutsDARAJA_CERT_PATHเส้นทางไปยังใบรับรองสาธารณะของ Safaricom ใช้ร่วมกับ DARAJA_INITIATOR_PASSWORDดูต้นฉบับภาษาอังกฤษ
Path to Safaricom's public certificate, used with DARAJA_INITIATOR_PASSWORDDARAJA_STATE_DBเส้นทางของไฟล์ SQLite ที่เก็บสถานะคำขอและ callbackดูต้นฉบับภาษาอังกฤษ
Path of the SQLite file that stores request state and callbacksDARAJA_OUTPUT_DIRไดเรกทอรีที่บันทึกไฟล์ PNG ของ QR ที่สร้างขึ้นดูต้นฉบับภาษาอังกฤษ
Directory where generated QR PNGs are savedDARAJA_CONFIG_DIRไดเรกทอรีที่เก็บการตั้งค่าที่บันทึกไว้ (ค่าเริ่มต้น: ไดเรกทอรีการตั้งค่าของผู้ใช้)ดูต้นฉบับภาษาอังกฤษ
Directory holding the saved config (default: user config dir)DARAJA_DOTENVพาธของไฟล์ .env ที่จะโหลดแทนไฟล์ของโปรเจกต์ดูต้นฉบับภาษาอังกฤษ
Path of a .env file to load instead of the project oneDARAJA_MCP_HOSTที่อยู่สำหรับผูกกับโหมด HTTP (ค่าเริ่มต้น 127.0.0.1)ดูต้นฉบับภาษาอังกฤษ
HTTP mode bind address (default 127.0.0.1)DARAJA_MCP_PORTพอร์ตในโหมด HTTP (ค่าเริ่มต้น 8000)ดูต้นฉบับภาษาอังกฤษ
HTTP mode port (default 8000)DARAJA_FORWARD_URLURL ของแอปของคุณ: ทุกการเรียกกลับจะถูกส่งด้วยเมธอด POST ไปยัง URL นี้ พร้อมลายเซ็น HMACดูต้นฉบับภาษาอังกฤษ
Your app's URL: every callback is POSTed on to it, HMAC-signed
คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ChatGPT ยังต่อ M-Pesa Daraja ไม่ได้
M-Pesa Daraja ต้องติดตั้งในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะตัวที่ทำงานบนเว็บ
คุณทำแบบนี้แทนได้
ก · ใช้แอปที่ต่อ M-Pesa Daraja ได้
- ต้องมีคีย์ของ M-Pesa Daraja (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว) · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ
- ต้องมีคีย์ของ M-Pesa Daraja (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)
- ต้องมีคีย์ของ M-Pesa Daraja (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)
- ต้องมีคีย์ของ M-Pesa Daraja (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)
ข · ตัวอื่นในหมวด เครื่องมือนักพัฒนา ที่ต่อกับ ChatGPT ได้
เลือกจากตัวที่ใช้มากในหมวดเดียวกัน เฉพาะตัวที่ต่อด้วยที่อยู่ได้โดยไม่ต้องใส่คีย์
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ ChatGPT
ต่อกับ Claude Code ได้ แต่ต้องเตรียมก่อน
ต้องมีคีย์ของ M-Pesa Daraja (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)
ให้ AI ติดตั้งให้
คัดลอกข้อความนี้ไปวางในแชตของ Claude Code AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง
ช่วยติดตั้ง MCP server ชื่อ M-Pesa Daraja ให้ Claude Code ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี uv ด้วยคำสั่ง uv --version ถ้าไม่มี ให้บอกฉันไปลงจาก https://docs.astral.sh/uv/getting-started/installation/ ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): claude mcp add --scope user mpesa-daraja --env DARAJA_CONSUMER_KEY='ใส่ค่าของคุณ' --env DARAJA_CONSUMER_SECRET='ใส่ค่าของคุณ' --env DARAJA_PASSKEY='ใส่ค่าของคุณ' --env DARAJA_SECURITY_CREDENTIAL='ใส่ค่าของคุณ' --env DARAJA_CALLBACK_TOKEN='ใส่ค่าของคุณ' --env DARAJA_INITIATOR_PASSWORD='ใส่ค่าของคุณ' --env DARAJA_MCP_TOKEN='ใส่ค่าของคุณ' --env DARAJA_FORWARD_SECRET='ใส่ค่าของคุณ' -- uvx mpesa-daraja-mcp 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง DARAJA_CONSUMER_KEY, DARAJA_CONSUMER_SECRET, DARAJA_PASSKEY, DARAJA_SECURITY_CREDENTIAL, DARAJA_CALLBACK_TOKEN, DARAJA_INITIATOR_PASSWORD, DARAJA_MCP_TOKEN, DARAJA_FORWARD_SECRET ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ M-Pesa Daraja ขึ้นจริงข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป
ลง uv ในเครื่อง (ถ้ายังไม่มี)
ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter
uv --version- ขึ้นเลขรุ่น เช่น uv … = ลงแล้ว ข้ามขั้นนี้ได้
- ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
เปิด Terminal ยังไง
Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter
Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open
ยังไม่ได้ลง: uv ไม่มีตัวติดตั้งแบบกดเอง คัดลอกคำสั่งหนึ่งบรรทัดของเครื่องคุณ (macOS หรือ Windows) จากหน้าทางการของ uv ไปวางใน Terminal · ไม่ต้องลง Python แยก uv ดาวน์โหลดให้เองเมื่อต้องใช้
ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น:
uv --versionลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ uv
สมัครและสร้างคีย์ของ M-Pesa Daraja
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell
วางคำสั่งนี้แล้วกด Enter
claude mcp add --scope user mpesa-daraja --env DARAJA_CONSUMER_KEY='ใส่ค่าของคุณ' --env DARAJA_CONSUMER_SECRET='ใส่ค่าของคุณ' --env DARAJA_PASSKEY='ใส่ค่าของคุณ' --env DARAJA_SECURITY_CREDENTIAL='ใส่ค่าของคุณ' --env DARAJA_CALLBACK_TOKEN='ใส่ค่าของคุณ' --env DARAJA_INITIATOR_PASSWORD='ใส่ค่าของคุณ' --env DARAJA_MCP_TOKEN='ใส่ค่าของคุณ' --env DARAJA_FORWARD_SECRET='ใส่ค่าของคุณ' -- uvx mpesa-daraja-mcpแก้ “ใส่ค่าของคุณ” เป็นคีย์ของคุณก่อนกด Enter
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
พิมพ์ /mcp ใน Claude Code
ต้องเห็น M-Pesa Daraja ในรายการและขึ้นว่าเชื่อมต่อแล้ว
ลองเลย
ใช้ M-Pesa Daraja บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude Code บอกว่ากำลังใช้ M-Pesa Daraja หรือมีชื่อเครื่องมือของ M-Pesa Daraja ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ค่าตั้งเพิ่มเติม 18 ช่อง (ไม่ต้องกรอกก็ใช้ได้)
คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ
DARAJA_ENVsandbox (ค่าเริ่มต้น) หรือ productionดูต้นฉบับภาษาอังกฤษ
sandbox (default) or productionDARAJA_SHORTCODEหมายเลข Paybill / หมายเลขร้านค้า (174379 ในแซนด์บ็อกซ์)ดูต้นฉบับภาษาอังกฤษ
Paybill / store number (174379 in sandbox)DARAJA_INITIATOR_NAMEAPI operator username (B2C, B2B, status, balance, reversal)DARAJA_CALLBACK_BASE_URLฐาน HTTPS สาธารณะสำหรับ URL สำหรับ callbackดูต้นฉบับภาษาอังกฤษ
Public HTTPS base for callback URLsDARAJA_CALLBACK_LISTENhost:port สำหรับตัวรับ callback ที่มาพร้อมในตัวดูต้นฉบับภาษาอังกฤษ
host:port for the built-in callback receiverDARAJA_TOOLSETSรายการคั่นด้วยเครื่องหมายจุลภาค: stk,c2b,payouts,ops,qr,ratiba,billmanagerดูต้นฉบับภาษาอังกฤษ
Comma list: stk,c2b,payouts,ops,qr,ratiba,billmanagerDARAJA_READ_ONLYtrue จะซ่อนเครื่องมือทั้งหมดที่เกี่ยวข้องกับการโอนเงินหรือการเขียนข้อมูลดูต้นฉบับภาษาอังกฤษ
true hides every tool that moves money or writesDARAJA_APPROVAL_THRESHOLDการจ่ายเงินที่เกินจำนวนชิลลิงนี้ต้องได้รับการอนุมัติในแชตดูต้นฉบับภาษาอังกฤษ
Payouts above this many shillings need approval in the chatDARAJA_ALLOWED_RECIPIENTSรายการหมายเลขโทรศัพท์หรือรหัสย่อที่การจ่ายเงิน (payouts) อาจส่งไปถึงได้ คั่นด้วยเครื่องหมายจุลภาคดูต้นฉบับภาษาอังกฤษ
Comma list of phones/shortcodes that payouts may go toDARAJA_ALLOW_LIVE_MONEY_MOVEMENTtrue เพื่ออนุญาตให้มีการเรียกเก็บเงินและการจ่ายเงินในระบบใช้งานจริงดูต้นฉบับภาษาอังกฤษ
true to allow production charges and payoutsDARAJA_CERT_PATHเส้นทางไปยังใบรับรองสาธารณะของ Safaricom ใช้ร่วมกับ DARAJA_INITIATOR_PASSWORDดูต้นฉบับภาษาอังกฤษ
Path to Safaricom's public certificate, used with DARAJA_INITIATOR_PASSWORDDARAJA_STATE_DBเส้นทางของไฟล์ SQLite ที่เก็บสถานะคำขอและ callbackดูต้นฉบับภาษาอังกฤษ
Path of the SQLite file that stores request state and callbacksDARAJA_OUTPUT_DIRไดเรกทอรีที่บันทึกไฟล์ PNG ของ QR ที่สร้างขึ้นดูต้นฉบับภาษาอังกฤษ
Directory where generated QR PNGs are savedDARAJA_CONFIG_DIRไดเรกทอรีที่เก็บการตั้งค่าที่บันทึกไว้ (ค่าเริ่มต้น: ไดเรกทอรีการตั้งค่าของผู้ใช้)ดูต้นฉบับภาษาอังกฤษ
Directory holding the saved config (default: user config dir)DARAJA_DOTENVพาธของไฟล์ .env ที่จะโหลดแทนไฟล์ของโปรเจกต์ดูต้นฉบับภาษาอังกฤษ
Path of a .env file to load instead of the project oneDARAJA_MCP_HOSTที่อยู่สำหรับผูกกับโหมด HTTP (ค่าเริ่มต้น 127.0.0.1)ดูต้นฉบับภาษาอังกฤษ
HTTP mode bind address (default 127.0.0.1)DARAJA_MCP_PORTพอร์ตในโหมด HTTP (ค่าเริ่มต้น 8000)ดูต้นฉบับภาษาอังกฤษ
HTTP mode port (default 8000)DARAJA_FORWARD_URLURL ของแอปของคุณ: ทุกการเรียกกลับจะถูกส่งด้วยเมธอด POST ไปยัง URL นี้ พร้อมลายเซ็น HMACดูต้นฉบับภาษาอังกฤษ
Your app's URL: every callback is POSTed on to it, HMAC-signed
คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ Cursor ได้ แต่ต้องเตรียมก่อน
ต้องมีคีย์ของ M-Pesa Daraja (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)
ให้ AI ติดตั้งให้
คัดลอกข้อความนี้ไปวางในแชตของ Cursor AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง
ช่วยติดตั้ง MCP server ชื่อ M-Pesa Daraja ให้ Cursor ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี uv ด้วยคำสั่ง uv --version ถ้าไม่มี ให้บอกฉันไปลงจาก https://docs.astral.sh/uv/getting-started/installation/ ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): { "mcpServers": { "mpesa-daraja": { "command": "uvx", "args": [ "mpesa-daraja-mcp" ], "env": { "DARAJA_CONSUMER_KEY": "ใส่ค่าของคุณ", "DARAJA_CONSUMER_SECRET": "ใส่ค่าของคุณ", "DARAJA_PASSKEY": "ใส่ค่าของคุณ", "DARAJA_SECURITY_CREDENTIAL": "ใส่ค่าของคุณ", "DARAJA_CALLBACK_TOKEN": "ใส่ค่าของคุณ", "DARAJA_INITIATOR_PASSWORD": "ใส่ค่าของคุณ", "DARAJA_MCP_TOKEN": "ใส่ค่าของคุณ", "DARAJA_FORWARD_SECRET": "ใส่ค่าของคุณ" } } } } 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง DARAJA_CONSUMER_KEY, DARAJA_CONSUMER_SECRET, DARAJA_PASSKEY, DARAJA_SECURITY_CREDENTIAL, DARAJA_CALLBACK_TOKEN, DARAJA_INITIATOR_PASSWORD, DARAJA_MCP_TOKEN, DARAJA_FORWARD_SECRET ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ M-Pesa Daraja ขึ้นจริงข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป
ลง uv ในเครื่อง (ถ้ายังไม่มี)
ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter
uv --version- ขึ้นเลขรุ่น เช่น uv … = ลงแล้ว ข้ามขั้นนี้ได้
- ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
เปิด Terminal ยังไง
Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter
Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open
ยังไม่ได้ลง: uv ไม่มีตัวติดตั้งแบบกดเอง คัดลอกคำสั่งหนึ่งบรรทัดของเครื่องคุณ (macOS หรือ Windows) จากหน้าทางการของ uv ไปวางใน Terminal · ไม่ต้องลง Python แยก uv ดาวน์โหลดให้เองเมื่อต้องใช้
ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น:
uv --versionลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ uv
สมัครและสร้างคีย์ของ M-Pesa Daraja
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
ใส่คีย์ในช่องที่ว่างไว้
ในค่าตั้งของ M-Pesa Daraja ช่อง DARAJA_CONSUMER_KEY, DARAJA_CONSUMER_SECRET, DARAJA_PASSKEY, DARAJA_SECURITY_CREDENTIAL, DARAJA_CALLBACK_TOKEN, DARAJA_INITIATOR_PASSWORD, DARAJA_MCP_TOKEN, DARAJA_FORWARD_SECRET ยังว่าง ใส่คีย์ของคุณแล้วบันทึก
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
เปิดแชตของ AI ใน Cursor โหมด Agent
ลองเลย
ใช้ M-Pesa Daraja บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Cursor บอกว่ากำลังใช้ M-Pesa Daraja หรือมีชื่อเครื่องมือของ M-Pesa Daraja ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ค่าตั้งเพิ่มเติม 18 ช่อง (ไม่ต้องกรอกก็ใช้ได้)
คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ
DARAJA_ENVsandbox (ค่าเริ่มต้น) หรือ productionดูต้นฉบับภาษาอังกฤษ
sandbox (default) or productionDARAJA_SHORTCODEหมายเลข Paybill / หมายเลขร้านค้า (174379 ในแซนด์บ็อกซ์)ดูต้นฉบับภาษาอังกฤษ
Paybill / store number (174379 in sandbox)DARAJA_INITIATOR_NAMEAPI operator username (B2C, B2B, status, balance, reversal)DARAJA_CALLBACK_BASE_URLฐาน HTTPS สาธารณะสำหรับ URL สำหรับ callbackดูต้นฉบับภาษาอังกฤษ
Public HTTPS base for callback URLsDARAJA_CALLBACK_LISTENhost:port สำหรับตัวรับ callback ที่มาพร้อมในตัวดูต้นฉบับภาษาอังกฤษ
host:port for the built-in callback receiverDARAJA_TOOLSETSรายการคั่นด้วยเครื่องหมายจุลภาค: stk,c2b,payouts,ops,qr,ratiba,billmanagerดูต้นฉบับภาษาอังกฤษ
Comma list: stk,c2b,payouts,ops,qr,ratiba,billmanagerDARAJA_READ_ONLYtrue จะซ่อนเครื่องมือทั้งหมดที่เกี่ยวข้องกับการโอนเงินหรือการเขียนข้อมูลดูต้นฉบับภาษาอังกฤษ
true hides every tool that moves money or writesDARAJA_APPROVAL_THRESHOLDการจ่ายเงินที่เกินจำนวนชิลลิงนี้ต้องได้รับการอนุมัติในแชตดูต้นฉบับภาษาอังกฤษ
Payouts above this many shillings need approval in the chatDARAJA_ALLOWED_RECIPIENTSรายการหมายเลขโทรศัพท์หรือรหัสย่อที่การจ่ายเงิน (payouts) อาจส่งไปถึงได้ คั่นด้วยเครื่องหมายจุลภาคดูต้นฉบับภาษาอังกฤษ
Comma list of phones/shortcodes that payouts may go toDARAJA_ALLOW_LIVE_MONEY_MOVEMENTtrue เพื่ออนุญาตให้มีการเรียกเก็บเงินและการจ่ายเงินในระบบใช้งานจริงดูต้นฉบับภาษาอังกฤษ
true to allow production charges and payoutsDARAJA_CERT_PATHเส้นทางไปยังใบรับรองสาธารณะของ Safaricom ใช้ร่วมกับ DARAJA_INITIATOR_PASSWORDดูต้นฉบับภาษาอังกฤษ
Path to Safaricom's public certificate, used with DARAJA_INITIATOR_PASSWORDDARAJA_STATE_DBเส้นทางของไฟล์ SQLite ที่เก็บสถานะคำขอและ callbackดูต้นฉบับภาษาอังกฤษ
Path of the SQLite file that stores request state and callbacksDARAJA_OUTPUT_DIRไดเรกทอรีที่บันทึกไฟล์ PNG ของ QR ที่สร้างขึ้นดูต้นฉบับภาษาอังกฤษ
Directory where generated QR PNGs are savedDARAJA_CONFIG_DIRไดเรกทอรีที่เก็บการตั้งค่าที่บันทึกไว้ (ค่าเริ่มต้น: ไดเรกทอรีการตั้งค่าของผู้ใช้)ดูต้นฉบับภาษาอังกฤษ
Directory holding the saved config (default: user config dir)DARAJA_DOTENVพาธของไฟล์ .env ที่จะโหลดแทนไฟล์ของโปรเจกต์ดูต้นฉบับภาษาอังกฤษ
Path of a .env file to load instead of the project oneDARAJA_MCP_HOSTที่อยู่สำหรับผูกกับโหมด HTTP (ค่าเริ่มต้น 127.0.0.1)ดูต้นฉบับภาษาอังกฤษ
HTTP mode bind address (default 127.0.0.1)DARAJA_MCP_PORTพอร์ตในโหมด HTTP (ค่าเริ่มต้น 8000)ดูต้นฉบับภาษาอังกฤษ
HTTP mode port (default 8000)DARAJA_FORWARD_URLURL ของแอปของคุณ: ทุกการเรียกกลับจะถูกส่งด้วยเมธอด POST ไปยัง URL นี้ พร้อมลายเซ็น HMACดูต้นฉบับภาษาอังกฤษ
Your app's URL: every callback is POSTed on to it, HMAC-signed
คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ VS Code ได้ แต่ต้องเตรียมก่อน
ต้องมีคีย์ของ M-Pesa Daraja (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)
ให้ AI ติดตั้งให้
คัดลอกข้อความนี้ไปวางในแชตของ VS Code AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง
ช่วยติดตั้ง MCP server ชื่อ M-Pesa Daraja ให้ VS Code ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี uv ด้วยคำสั่ง uv --version ถ้าไม่มี ให้บอกฉันไปลงจาก https://docs.astral.sh/uv/getting-started/installation/ ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): { "servers": { "mpesa-daraja": { "type": "stdio", "command": "uvx", "args": [ "mpesa-daraja-mcp" ], "env": { "DARAJA_CONSUMER_KEY": "ใส่ค่าของคุณ", "DARAJA_CONSUMER_SECRET": "ใส่ค่าของคุณ", "DARAJA_PASSKEY": "ใส่ค่าของคุณ", "DARAJA_SECURITY_CREDENTIAL": "ใส่ค่าของคุณ", "DARAJA_CALLBACK_TOKEN": "ใส่ค่าของคุณ", "DARAJA_INITIATOR_PASSWORD": "ใส่ค่าของคุณ", "DARAJA_MCP_TOKEN": "ใส่ค่าของคุณ", "DARAJA_FORWARD_SECRET": "ใส่ค่าของคุณ" } } } } 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง DARAJA_CONSUMER_KEY, DARAJA_CONSUMER_SECRET, DARAJA_PASSKEY, DARAJA_SECURITY_CREDENTIAL, DARAJA_CALLBACK_TOKEN, DARAJA_INITIATOR_PASSWORD, DARAJA_MCP_TOKEN, DARAJA_FORWARD_SECRET ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ M-Pesa Daraja ขึ้นจริงข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป
ลง uv ในเครื่อง (ถ้ายังไม่มี)
ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter
uv --version- ขึ้นเลขรุ่น เช่น uv … = ลงแล้ว ข้ามขั้นนี้ได้
- ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
เปิด Terminal ยังไง
Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter
Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open
ยังไม่ได้ลง: uv ไม่มีตัวติดตั้งแบบกดเอง คัดลอกคำสั่งหนึ่งบรรทัดของเครื่องคุณ (macOS หรือ Windows) จากหน้าทางการของ uv ไปวางใน Terminal · ไม่ต้องลง Python แยก uv ดาวน์โหลดให้เองเมื่อต้องใช้
ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น:
uv --versionลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ uv
สมัครและสร้างคีย์ของ M-Pesa Daraja
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
ใส่คีย์ในช่องที่ว่างไว้
ในค่าตั้งของ M-Pesa Daraja ช่อง DARAJA_CONSUMER_KEY, DARAJA_CONSUMER_SECRET, DARAJA_PASSKEY, DARAJA_SECURITY_CREDENTIAL, DARAJA_CALLBACK_TOKEN, DARAJA_INITIATOR_PASSWORD, DARAJA_MCP_TOKEN, DARAJA_FORWARD_SECRET ยังว่าง ใส่คีย์ของคุณแล้วบันทึก
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
เปิดแชตของ AI ใน VS Code โหมด Agent
ลองเลย
ใช้ M-Pesa Daraja บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า VS Code บอกว่ากำลังใช้ M-Pesa Daraja หรือมีชื่อเครื่องมือของ M-Pesa Daraja ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ค่าตั้งเพิ่มเติม 18 ช่อง (ไม่ต้องกรอกก็ใช้ได้)
คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ
DARAJA_ENVsandbox (ค่าเริ่มต้น) หรือ productionดูต้นฉบับภาษาอังกฤษ
sandbox (default) or productionDARAJA_SHORTCODEหมายเลข Paybill / หมายเลขร้านค้า (174379 ในแซนด์บ็อกซ์)ดูต้นฉบับภาษาอังกฤษ
Paybill / store number (174379 in sandbox)DARAJA_INITIATOR_NAMEAPI operator username (B2C, B2B, status, balance, reversal)DARAJA_CALLBACK_BASE_URLฐาน HTTPS สาธารณะสำหรับ URL สำหรับ callbackดูต้นฉบับภาษาอังกฤษ
Public HTTPS base for callback URLsDARAJA_CALLBACK_LISTENhost:port สำหรับตัวรับ callback ที่มาพร้อมในตัวดูต้นฉบับภาษาอังกฤษ
host:port for the built-in callback receiverDARAJA_TOOLSETSรายการคั่นด้วยเครื่องหมายจุลภาค: stk,c2b,payouts,ops,qr,ratiba,billmanagerดูต้นฉบับภาษาอังกฤษ
Comma list: stk,c2b,payouts,ops,qr,ratiba,billmanagerDARAJA_READ_ONLYtrue จะซ่อนเครื่องมือทั้งหมดที่เกี่ยวข้องกับการโอนเงินหรือการเขียนข้อมูลดูต้นฉบับภาษาอังกฤษ
true hides every tool that moves money or writesDARAJA_APPROVAL_THRESHOLDการจ่ายเงินที่เกินจำนวนชิลลิงนี้ต้องได้รับการอนุมัติในแชตดูต้นฉบับภาษาอังกฤษ
Payouts above this many shillings need approval in the chatDARAJA_ALLOWED_RECIPIENTSรายการหมายเลขโทรศัพท์หรือรหัสย่อที่การจ่ายเงิน (payouts) อาจส่งไปถึงได้ คั่นด้วยเครื่องหมายจุลภาคดูต้นฉบับภาษาอังกฤษ
Comma list of phones/shortcodes that payouts may go toDARAJA_ALLOW_LIVE_MONEY_MOVEMENTtrue เพื่ออนุญาตให้มีการเรียกเก็บเงินและการจ่ายเงินในระบบใช้งานจริงดูต้นฉบับภาษาอังกฤษ
true to allow production charges and payoutsDARAJA_CERT_PATHเส้นทางไปยังใบรับรองสาธารณะของ Safaricom ใช้ร่วมกับ DARAJA_INITIATOR_PASSWORDดูต้นฉบับภาษาอังกฤษ
Path to Safaricom's public certificate, used with DARAJA_INITIATOR_PASSWORDDARAJA_STATE_DBเส้นทางของไฟล์ SQLite ที่เก็บสถานะคำขอและ callbackดูต้นฉบับภาษาอังกฤษ
Path of the SQLite file that stores request state and callbacksDARAJA_OUTPUT_DIRไดเรกทอรีที่บันทึกไฟล์ PNG ของ QR ที่สร้างขึ้นดูต้นฉบับภาษาอังกฤษ
Directory where generated QR PNGs are savedDARAJA_CONFIG_DIRไดเรกทอรีที่เก็บการตั้งค่าที่บันทึกไว้ (ค่าเริ่มต้น: ไดเรกทอรีการตั้งค่าของผู้ใช้)ดูต้นฉบับภาษาอังกฤษ
Directory holding the saved config (default: user config dir)DARAJA_DOTENVพาธของไฟล์ .env ที่จะโหลดแทนไฟล์ของโปรเจกต์ดูต้นฉบับภาษาอังกฤษ
Path of a .env file to load instead of the project oneDARAJA_MCP_HOSTที่อยู่สำหรับผูกกับโหมด HTTP (ค่าเริ่มต้น 127.0.0.1)ดูต้นฉบับภาษาอังกฤษ
HTTP mode bind address (default 127.0.0.1)DARAJA_MCP_PORTพอร์ตในโหมด HTTP (ค่าเริ่มต้น 8000)ดูต้นฉบับภาษาอังกฤษ
HTTP mode port (default 8000)DARAJA_FORWARD_URLURL ของแอปของคุณ: ทุกการเรียกกลับจะถูกส่งด้วยเมธอด POST ไปยัง URL นี้ พร้อมลายเซ็น HMACดูต้นฉบับภาษาอังกฤษ
Your app's URL: every callback is POSTed on to it, HMAC-signed
คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
สำหรับคนเขียนโค้ด: คำสั่ง Terminal และค่าตั้ง JSON
ติดตั้งในเครื่อง
Claude Code
claude mcp add --scope user mpesa-daraja --env DARAJA_CONSUMER_KEY='ใส่ค่าของคุณ' --env DARAJA_CONSUMER_SECRET='ใส่ค่าของคุณ' --env DARAJA_PASSKEY='ใส่ค่าของคุณ' --env DARAJA_SECURITY_CREDENTIAL='ใส่ค่าของคุณ' --env DARAJA_CALLBACK_TOKEN='ใส่ค่าของคุณ' --env DARAJA_INITIATOR_PASSWORD='ใส่ค่าของคุณ' --env DARAJA_MCP_TOKEN='ใส่ค่าของคุณ' --env DARAJA_FORWARD_SECRET='ใส่ค่าของคุณ' -- uvx mpesa-daraja-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"mpesa-daraja": {
"command": "uvx",
"args": [
"mpesa-daraja-mcp"
],
"env": {
"DARAJA_CONSUMER_KEY": "ใส่ค่าของคุณ",
"DARAJA_CONSUMER_SECRET": "ใส่ค่าของคุณ",
"DARAJA_PASSKEY": "ใส่ค่าของคุณ",
"DARAJA_SECURITY_CREDENTIAL": "ใส่ค่าของคุณ",
"DARAJA_CALLBACK_TOKEN": "ใส่ค่าของคุณ",
"DARAJA_INITIATOR_PASSWORD": "ใส่ค่าของคุณ",
"DARAJA_MCP_TOKEN": "ใส่ค่าของคุณ",
"DARAJA_FORWARD_SECRET": "ใส่ค่าของคุณ"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"mpesa-daraja": {
"command": "uvx",
"args": [
"mpesa-daraja-mcp"
],
"env": {
"DARAJA_CONSUMER_KEY": "ใส่ค่าของคุณ",
"DARAJA_CONSUMER_SECRET": "ใส่ค่าของคุณ",
"DARAJA_PASSKEY": "ใส่ค่าของคุณ",
"DARAJA_SECURITY_CREDENTIAL": "ใส่ค่าของคุณ",
"DARAJA_CALLBACK_TOKEN": "ใส่ค่าของคุณ",
"DARAJA_INITIATOR_PASSWORD": "ใส่ค่าของคุณ",
"DARAJA_MCP_TOKEN": "ใส่ค่าของคุณ",
"DARAJA_FORWARD_SECRET": "ใส่ค่าของคุณ"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"mpesa-daraja": {
"type": "stdio",
"command": "uvx",
"args": [
"mpesa-daraja-mcp"
],
"env": {
"DARAJA_CONSUMER_KEY": "ใส่ค่าของคุณ",
"DARAJA_CONSUMER_SECRET": "ใส่ค่าของคุณ",
"DARAJA_PASSKEY": "ใส่ค่าของคุณ",
"DARAJA_SECURITY_CREDENTIAL": "ใส่ค่าของคุณ",
"DARAJA_CALLBACK_TOKEN": "ใส่ค่าของคุณ",
"DARAJA_INITIATOR_PASSWORD": "ใส่ค่าของคุณ",
"DARAJA_MCP_TOKEN": "ใส่ค่าของคุณ",
"DARAJA_FORWARD_SECRET": "ใส่ค่าของคุณ"
}
}
}
}ค่าที่ต้องใส่เอง
DARAJA_CONSUMER_KEYความลับ จำเป็น envConsumer Key ของแอป Darajaดูต้นฉบับภาษาอังกฤษ
Daraja app Consumer KeyDARAJA_CONSUMER_SECRETความลับ จำเป็น envConsumer Secret ของแอป Darajaดูต้นฉบับภาษาอังกฤษ
Daraja app Consumer SecretDARAJA_ENVenvsandbox (ค่าเริ่มต้น) หรือ productionดูต้นฉบับภาษาอังกฤษ
sandbox (default) or productionDARAJA_SHORTCODEenvหมายเลข Paybill / หมายเลขร้านค้า (174379 ในแซนด์บ็อกซ์)ดูต้นฉบับภาษาอังกฤษ
Paybill / store number (174379 in sandbox)DARAJA_PASSKEYความลับ จำเป็น envpasskey ของ M-Pesa Express (STK Push)ดูต้นฉบับภาษาอังกฤษ
M-Pesa Express passkey (STK Push)DARAJA_INITIATOR_NAMEenvAPI operator username (B2C, B2B, status, balance, reversal)DARAJA_SECURITY_CREDENTIALความลับ จำเป็น envรหัสผ่านของผู้เริ่มต้นที่เข้ารหัสแล้วดูต้นฉบับภาษาอังกฤษ
Encrypted initiator passwordDARAJA_CALLBACK_BASE_URLenvฐาน HTTPS สาธารณะสำหรับ URL สำหรับ callbackดูต้นฉบับภาษาอังกฤษ
Public HTTPS base for callback URLsDARAJA_CALLBACK_LISTENenvhost:port สำหรับตัวรับ callback ที่มาพร้อมในตัวดูต้นฉบับภาษาอังกฤษ
host:port for the built-in callback receiverDARAJA_CALLBACK_TOKENความลับ จำเป็น env16+ random characters; secret path for callbacksDARAJA_TOOLSETSenvรายการคั่นด้วยเครื่องหมายจุลภาค: stk,c2b,payouts,ops,qr,ratiba,billmanagerดูต้นฉบับภาษาอังกฤษ
Comma list: stk,c2b,payouts,ops,qr,ratiba,billmanagerDARAJA_READ_ONLYenvtrue จะซ่อนเครื่องมือทั้งหมดที่เกี่ยวข้องกับการโอนเงินหรือการเขียนข้อมูลดูต้นฉบับภาษาอังกฤษ
true hides every tool that moves money or writesDARAJA_APPROVAL_THRESHOLDenvการจ่ายเงินที่เกินจำนวนชิลลิงนี้ต้องได้รับการอนุมัติในแชตดูต้นฉบับภาษาอังกฤษ
Payouts above this many shillings need approval in the chatDARAJA_ALLOWED_RECIPIENTSenvรายการหมายเลขโทรศัพท์หรือรหัสย่อที่การจ่ายเงิน (payouts) อาจส่งไปถึงได้ คั่นด้วยเครื่องหมายจุลภาคดูต้นฉบับภาษาอังกฤษ
Comma list of phones/shortcodes that payouts may go toDARAJA_ALLOW_LIVE_MONEY_MOVEMENTenvtrue เพื่ออนุญาตให้มีการเรียกเก็บเงินและการจ่ายเงินในระบบใช้งานจริงดูต้นฉบับภาษาอังกฤษ
true to allow production charges and payoutsDARAJA_INITIATOR_PASSWORDความลับ จำเป็น envรหัสผ่านของผู้เริ่มต้น ถูกเข้ารหัสเป็น SecurityCredential ตอนเริ่มทำงาน (ทางเลือกแทน DARAJA_SECURITY_CREDENTIAL)ดูต้นฉบับภาษาอังกฤษ
Initiator password, encrypted into SecurityCredential at startup (alternative to DARAJA_SECURITY_CREDENTIAL)DARAJA_CERT_PATHenvเส้นทางไปยังใบรับรองสาธารณะของ Safaricom ใช้ร่วมกับ DARAJA_INITIATOR_PASSWORDดูต้นฉบับภาษาอังกฤษ
Path to Safaricom's public certificate, used with DARAJA_INITIATOR_PASSWORDDARAJA_STATE_DBenvเส้นทางของไฟล์ SQLite ที่เก็บสถานะคำขอและ callbackดูต้นฉบับภาษาอังกฤษ
Path of the SQLite file that stores request state and callbacksDARAJA_OUTPUT_DIRenvไดเรกทอรีที่บันทึกไฟล์ PNG ของ QR ที่สร้างขึ้นดูต้นฉบับภาษาอังกฤษ
Directory where generated QR PNGs are savedDARAJA_CONFIG_DIRenvไดเรกทอรีที่เก็บการตั้งค่าที่บันทึกไว้ (ค่าเริ่มต้น: ไดเรกทอรีการตั้งค่าของผู้ใช้)ดูต้นฉบับภาษาอังกฤษ
Directory holding the saved config (default: user config dir)DARAJA_DOTENVenvพาธของไฟล์ .env ที่จะโหลดแทนไฟล์ของโปรเจกต์ดูต้นฉบับภาษาอังกฤษ
Path of a .env file to load instead of the project oneDARAJA_MCP_TOKENความลับ จำเป็น envโทเคน Bearer สำหรับโหมด HTTP (ต้องมีอักขระสุ่มอย่างน้อย 32 ตัว)ดูต้นฉบับภาษาอังกฤษ
Bearer token for HTTP mode (32+ random characters)DARAJA_MCP_HOSTenvที่อยู่สำหรับผูกกับโหมด HTTP (ค่าเริ่มต้น 127.0.0.1)ดูต้นฉบับภาษาอังกฤษ
HTTP mode bind address (default 127.0.0.1)DARAJA_MCP_PORTenvพอร์ตในโหมด HTTP (ค่าเริ่มต้น 8000)ดูต้นฉบับภาษาอังกฤษ
HTTP mode port (default 8000)DARAJA_FORWARD_URLenvURL ของแอปของคุณ: ทุกการเรียกกลับจะถูกส่งด้วยเมธอด POST ไปยัง URL นี้ พร้อมลายเซ็น HMACดูต้นฉบับภาษาอังกฤษ
Your app's URL: every callback is POSTed on to it, HMAC-signedDARAJA_FORWARD_SECRETความลับ จำเป็น envรหัสลับ HMAC สำหรับ callback ที่ส่งต่อ (16 ตัวอักษรขึ้นไป)ดูต้นฉบับภาษาอังกฤษ
HMAC secret for forwarded callbacks (16+ characters)
คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ
ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
สรุป
ใช้กับโปรแกรมไหนได้
ดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569
ติดตั้งบนเครื่องได้ใน
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
คู่มือที่เกี่ยวข้อง
ทำอะไรได้บ้าง
รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง
ผลตรวจเบื้องต้นi
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 19 พ.ย. 2569
- ✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub Mr-Macharia ซึ่งเป็นเจ้าของ repo
- ✓ ผ่าน
ยังมีคนดูแล
มีการแก้โค้ดล่าสุด 15 วันที่ผ่านมา
- ✓ ผ่าน
มีสัญญาอนุญาต (license)
ใช้ MIT
- – ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
- – ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
- … ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต
ช่องโหว่ที่เปิดเผยแล้ว (OSV.dev)
ไม่พบรายการใน OSV.dev สำหรับ mpesa-daraja-mcp@0.1.6
ตรวจเฉพาะตัวแพ็กเกจรุ่นนี้ ไม่ใช่ทุก dependency · ตรวจเมื่อ 15 พ.ย. 2569
ผู้ทำ: ขอให้ตรวจใหม่ หรือแจ้งข้อมูลผิด
สำหรับผู้ทำ: ติดป้ายใน README
ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้
[](https://mcp.popnx.com/th/servers/mr-macharia-mpesa-daraja-mcp)พูดคุย
ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์
ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย
ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx
รีวิวจากผู้ใช้
ยังไม่มีรีวิว
เทียบกับตัวอื่นในหมวด เครื่องมือนักพัฒนาi
- ดาวมากกว่า 0% ของอีก 6182 ตัวในหมวดนี้
- ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 57% ของอีก 6182 ตัวในหมวดนี้
- ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 99% ของอีก 6182 ตัวในหมวดนี้
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
คำถามที่พบบ่อย
M-Pesa Daraja ปลอดภัยไหม?
จากการตรวจเบื้องต้นของเรา ผ่าน 3 จาก 3 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
ต้องใช้กุญแจหรือรหัสอะไรบ้าง?
ต้องใส่ค่าเหล่านี้: DARAJA_CONSUMER_KEY, DARAJA_CONSUMER_SECRET, DARAJA_PASSKEY, DARAJA_SECURITY_CREDENTIAL, DARAJA_CALLBACK_TOKEN, DARAJA_INITIATOR_PASSWORD, DARAJA_MCP_TOKEN, DARAJA_FORWARD_SECRET
ตัวนี้รันบนเครื่องหรือบนคลาวด์?
รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)
ยังมีคนดูแลอยู่ไหม?
repo บน GitHub มีการแก้โค้ดล่าสุด 15 วันที่ผ่านมา และส่งรุ่นล่าสุด (0.1.6) เข้า registry 21 วันที่ผ่านมา
ใช้กับโปรแกรมไหนได้บ้าง?
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Python (uv) ในเครื่องด้วย
มีตัวไหนใช้แทนได้บ้าง?
ในหมวดเดียวกันมี GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
ตัวอื่นที่ทำงานคล้ายกัน
หมวดเดียวกันจากผู้ทำคนอื่น ผ่านตัวตรวจคำสั่งแล้ว ตัวทางการขึ้นก่อน แล้วเรียงตามดาว
อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Appllama
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Cloudflare MCP
Cloudflare MCP servers
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Repowise
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| ตัวนี้ M-Pesa Daraja | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| ทำงานที่ไหน | ต้องลงในเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | มีทั้งบนคลาวด์และแบบลงเครื่อง |
| ต้องใส่คีย์ | ใช่ | ไม่ | ไม่ | ไม่ | ไม่ | ไม่ |
| กด + ใน Claude ได้ | ไม่ | ไม่ | ไม่ | ใช่ | ไม่ | ไม่ |
| ผลตรวจเบื้องต้น | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| สัญญาอนุญาต | MIT | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| ราคา | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน |
README จากผู้ทำ
เปิดอ่าน README
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ
mpesa-daraja
Renamed from
mpesa-daraja-mcpin 0.1.5. The old package name still installs this one.
The MCP server in the M-Pesa Daraja Agent Kit. It lets an AI agent call Safaricom's Daraja API safely.
An MCP server that exposes Safaricom's Daraja APIs as tools, so an agent (Claude Code, Codex, Cursor, Gemini CLI, any MCP client) can collect payments, check whether they went through, and operate M-Pesa from a chat. It starts in the sandbox, and nothing live happens until you switch it on.
It pairs with the Agent Skills in the same kit: the skills teach an agent *how* to integrate M-Pesa, and this server lets it *call* Daraja. You can use either on its own.
Who it's for
- Developers building payment integrations: ask your agent to run a request against the sandbox and read the real response.
- Learners finding out how the Daraja API works: send real requests to a safe test environment and see what comes back.
- Businesses and teams that want an AI agent to handle payments: collecting them, checking whether they went through, and reconciling them.
Install
Let your agent do it. Paste this into Claude Code, Codex, Cursor, Gemini CLI or any coding agent:
Add the M-Pesa Daraja MCP server to yourself, named "mpesa", with the command: uvx mpesa-daraja-mcp
It needs no keys in your config. If uv is missing, tell me how to install it first. Don't ask me for my Daraja keys. Tell me to run uvx mpesa-daraja-mcp init in my own terminal, which saves them privately, then to restart you. After I restart you, call mpesa_check_credentials and tell me if everything works.
Or do it yourself. You need uv. The wizard asks for your Daraja keys (secrets are typed hidden), checks them live with Safaricom, saves them to a file only you can read, and registers the server with Claude Code, Codex, Gemini CLI or Cursor:
uvx mpesa-daraja-mcp init
Then restart your agent and ask: *"Check my M-Pesa credentials, then send a KES 1 STK push to 0712345678 and tell me when it's paid."* The full Agent Kit, with the skills and more examples, is in the main README.
Tools
| Tool | Daraja API | Moves money |
|---|---|---|
mpesa_explain_code | — offline error/result code lookup | |
mpesa_normalize_phone | — offline 07… → 2547… | |
mpesa_generate_stk_password | — offline Password + EAT Timestamp | |
mpesa_parse_callback | — offline parse of any callback payload | |
mpesa_setup_status | — offline: what's configured and missing per toolset (no values) | |
mpesa_check_credentials | OAuth token (never returned) | |
mpesa_get_result | Final status by idempotency key or any Daraja ID (from captured callbacks; STK falls back to STK Query) | |
mpesa_stk_push_and_wait | M-Pesa Express: push, then wait for callback / poll query; returns SUCCESS, FAILED or UNKNOWN | ✅ |
mpesa_stk_push / mpesa_stk_query | M-Pesa Express, fire-and-forget / status | ✅ / |
mpesa_c2b_register_urls / mpesa_c2b_simulate | C2B v2 (simulate = sandbox only) | |
mpesa_pull_transactions | Pull Transactions query | |
mpesa_b2c_payment | B2C v3, B2Pochi | ✅ |
mpesa_b2b_payment | BusinessPayBill, BusinessBuyGoods, BusinessPayToBulk (B2C top-up), PayTaxToKRA | ✅ |
mpesa_b2b_express_checkout | B2B USSD push | ✅ |
mpesa_transaction_status / mpesa_account_balance | Status / Balance (async result) | |
mpesa_reverse_transaction | Reversal | ✅ |
mpesa_generate_dynamic_qr | Dynamic QR, saved as a PNG file (path returned, not the image) | |
mpesa_ratiba_create_standing_order | M-Pesa Ratiba | ✅ |
mpesa_bill_manager_optin / mpesa_bill_manager_send_invoice / mpesa_bill_manager_cancel_invoice | Bill Manager |
Tool annotations mark money-moving tools as destructiveHint, so MCP clients ask for approval.
Safety
- Defaults to the sandbox.
- In production, money-moving tools refuse to run unless
DARAJA_ALLOW_LIVE_MONEY_MOVEMENT=true. - Optional guardrails, all off until set:
DARAJA_READ_ONLY=truehides every tool that moves money or writes. Use it for support bots, reconciliation and learning.DARAJA_APPROVAL_THRESHOLD=5000: B2C, B2B, tax and reversals above KES 5,000 pause for a yes/no in the chat (MCP elicitation). Clients that can't show the prompt get a refusal, and nothing is sent. Collections (STK, B2B Express, Ratiba) never prompt, because the payer enters their own PIN.DARAJA_ALLOWED_RECIPIENTS=0712345678,600000: payouts may go only to these phones and shortcodes.- For a B2C refund, pass
refund_ofwith the original M-Pesa receipt; it appears in the approval prompt and the remarks. - Callback URLs must be HTTPS; C2B URLs with
mpesa/safaricomin them are rejected up front. - Tokens and secrets are never returned in tool output.
- Responses with
ResponseCode "0"are tagged_note: ACCEPTED for processing only, so the agent does not report them as completed payments. - Idempotent money tools. Each request is stored under an idempotency key. Repeating the key returns the stored request (
duplicate: true) instead of paying again. - Only a definitively FAILED request is re-sent.
- ACCEPTED or UNKNOWN requests (queue timeouts, network errors) are never re-sent until their result is known.
- B2C, B2B and B2B Express require an explicit
idempotency_key, e.g.refund-order-1042. Reversal, tax and Ratiba derive one from the transaction ID, the PRN and phone + name respectively. For STK the key is optional.
Configuration
| Variable | Required | Notes |
|---|---|---|
DARAJA_ENV | sandbox (default) or production | |
DARAJA_CONSUMER_KEY, DARAJA_CONSUMER_SECRET | ✅ | From your Daraja app |
DARAJA_SHORTCODE | most tools | Paybill / store number (174379 in sandbox) |
DARAJA_PASSKEY | STK | Lipa na M-Pesa passkey |
DARAJA_INITIATOR_NAME | B2C/B2B/status/balance/reversal | API operator username |
DARAJA_SECURITY_CREDENTIAL | same | Pre-encrypted credential, or set the next two |
DARAJA_INITIATOR_PASSWORD + DARAJA_CERT_PATH | Server encrypts the password with the cert at startup | |
DARAJA_CALLBACK_BASE_URL | e.g. https://abc.ngrok-free.app; tools append /mpesa/stk/callback, /mpesa/b2c/result, … | |
DARAJA_ALLOW_LIVE_MONEY_MOVEMENT | true to allow production charges/payouts | |
DARAJA_CALLBACK_LISTEN | e.g. 127.0.0.1:8787: starts the built-in callback receiver | |
DARAJA_CALLBACK_TOKEN | with receiver | 16+ random characters. Callback URLs become /cb/ /… |
DARAJA_STATE_DB | SQLite file for requests and results (default ~/.mpesa-mcp/state.db) | |
DARAJA_TOOLSETS | Comma list of stk,c2b,payouts,ops,qr,ratiba,billmanager (core is always on). Default: all | |
DARAJA_READ_ONLY | true hides every tool that moves money or writes | |
DARAJA_APPROVAL_THRESHOLD | Payouts above this many shillings need a yes in the chat | |
DARAJA_ALLOWED_RECIPIENTS | Comma list of phones/shortcodes that payouts may go to | |
DARAJA_OUTPUT_DIR | Where QR PNGs are saved (default ~/.mpesa-mcp/qr) | |
DARAJA_FORWARD_URL | Your app's endpoint. Each callback is POSTed on to it, signed. See forwarding | |
DARAJA_FORWARD_SECRET | with forwarding | 16+ random characters, used for the X-Mpesa-Signature HMAC |
DARAJA_MCP_TOKEN | HTTP mode | 32+ random characters; clients send Authorization: Bearer |
DARAJA_MCP_HOST, DARAJA_MCP_PORT | HTTP mode bind address and port (default 127.0.0.1:8000) |
Commands and configuration files
Install once with uv tool install mpesa-daraja-mcp to get the mpesa command (or prefix any command with uvx mpesa-daraja-mcp instead of mpesa):
mpesa init # guided: keys (hidden input), live check, save, register with your agents
mpesa status # what's configured (masked), the guardrails, and a live key check mpesa dev # callback receiver + tunnel (cloudflared or ngrok) + a live log of callbacks mpesa serve [--http] # the MCP server: stdio for local agents, HTTP for remote ones mpesa up --domain pay.example.com # self-host with Docker and automatic HTTPS mpesa pay stk 0712345678 10 --ref order-42 # waits for the PIN and shows the outcome mpesa pay b2c 0712345678 500 --key refund-42 --refund-of NLJ7RT61SV mpesa result · mpesa balance · mpesa explain 1032 mpesa skills install # copy the Agent Skills into Claude Code, Codex, Cursor, … mpesa upgrade
Every data command takes --json, and mpesa --verbose … logs each HTTP request to Daraja. A failed STK Push shows the --key to retry it with. Payments use the same guardrails as the MCP tools, and approvals are asked in the terminal. uvx mpesa-daraja-mcp with no arguments is the MCP server on stdio, which is what your agent runs.
The server needs no flags or environment variables in your agent's config. Settings are read in this order, highest first:
- Environment variables, e.g. from the client's
envblock. - A project `.env` in the folder the agent starts the server in, or the file named by
DARAJA_DOTENV. OnlyDARAJA_*lines are read. - The user config file that
setupwrites:~/.config/mpesa-daraja-mcp/config.env(Windows:%APPDATA%\mpesa-daraja-mcp\config.env; override the folder withDARAJA_CONFIG_DIR). It is readable only by you.
The server starts even when unconfigured. Tools then explain what's missing, and mpesa_setup_status lists the gaps for each toolset without revealing any values.
To register by hand: claude mcp add --scope user mpesa -- uvx mpesa-daraja-mcp. Every other agent is covered in docs/clients.md. The mpesa-daraja and mpesa-mcp commands are aliases.
Remote access (HTTP mode)
mpesa serve --http serves MCP at /mcp and Daraja callbacks at /cb/ /… on one port, for n8n, cloud agents and teammates. It needs DARAJA_MCP_TOKEN, and starts read-only with every payout needing approval unless you say otherwise. Docker, HTTPS and n8n guides: https://github.com/Mr-Macharia/mpesa-daraja-skills-and-mcp/blob/main/docs/self-hosting.md
Results and callbacks
Every money or async tool returns one shape:
{"status": "ACCEPTED | SUCCESS | FAILED | UNKNOWN", "message": "...", "idempotency_key": "...",
"duplicate": false, "ids": {"checkout_request_id": "..."}, "receipt": "...", "result_code": "...", "explanation": "...", "raw": {}}
To let the agent see final results, enable the built-in receiver:
export DARAJA_CALLBACK_LISTEN=127.0.0.1:8787
export DARAJA_CALLBACK_TOKEN=$(python -c "import secrets; print(secrets.token_urlsafe(24))") ngrok http 8787 # sandbox; use a reverse proxy with TLS in production export DARAJA_CALLBACK_BASE_URL=https://
Callbacks are stored in DARAJA_STATE_DB:
mpesa_get_result(id)reads them.mpesa_stk_push_and_waitreturns the final outcome in one call.- Queue-timeout callbacks are recorded as UNKNOWN.
- C2B validation requests are always accepted. Use yo