MCP server ของ SendHQ

เซิร์ฟเวอร์นี้คืออะไร

MCP server ของ SendHQ ให้เอเจนต์ AI ใช้งานเวิร์กสเปซ SendHQ หนึ่งเวิร์กสเปซผ่าน Model Context Protocol ได้ ส่งอีเมล (แบบเดี่ยว แบบชุด แบบเทมเพลต การตอบกลับ ไฟล์แนบ และการลองใหม่แบบ idempotent) อ่านและค้นหาอีเมลที่ส่งและได้รับ (หัวเรื่อง เนื้อหา และชื่อไฟล์แนบ) พร้อมอีเวนต์การส่ง จัดอีเมลเข้าป้ายกำกับด้วยกฎจัดเก็บอัตโนมัติ จัดการฉบับร่างและไฟล์แนบส่วนตัว เขียนและเผยแพร่เทมเพลตแบบโฮสต์ เพิ่มและยืนยันโดเมนพร้อม DNS ตั้งค่าการรับอีเมลขาเข้าและที่อยู่ขาเข้า ตรวจสอบความสามารถในการส่งถึง bounce complaint และการระงับการส่ง และอ่านการใช้งานบัญชี สถานะการเรียกเก็บเงิน การวิเคราะห์ และเมทาดาทาของ API key

เป็นเซิร์ฟเวอร์ stdio ในเครื่องที่ฝังอยู่ในไบนารี CLI sendhq MCP client ของคุณเริ่ม sendhq mcp เป็นโปรเซสลูกและสื่อสาร JSON-RPC ผ่าน stdin/stdout การเรียกเครื่องมือทุกครั้งกลายเป็นคำขอที่มีเอกสารหนึ่งรายการไปยัง SendHQ REST API ที่ https://sendhq.cc/api/v1 โดยยืนยันตัวตนด้วย API key ของเวิร์กสเปซคุณ ดังนั้น MCP server จึงมีสิทธิ์เท่ากับคีย์นั้นทุกประการและไม่เกินกว่านั้น

• 59 เครื่องมือ ใน 8 กลุ่ม สร้างจากแค็ตตาล็อกเดียวที่เผยแพร่เป็น tools.json ด้วย
• JSON Schema ที่เข้มงวด: อาร์กิวเมนต์ที่ไม่รู้จัก ชนิดที่ผิด และฟิลด์บังคับที่ขาดหายจะถูกปฏิเสธในเครื่องก่อนที่จะไปถึง SendHQ
• ข้อผิดพลาดแบบมีโครงสร้าง พร้อม code ที่คงที่ status ของ HTTP explanation remedy ที่เป็นรูปธรรม และข้อมูลว่าการลองใหม่ช่วยได้หรือไม่
• ทุกเครื่องมือที่ส่งอีเมลจริงหรือทำลายข้อมูลจะระบุไว้ในคำแรกของคำอธิบาย และมี MCP safety annotation
• โหมด --read-only ซ่อนทุกเครื่องมือที่ส่งและเปลี่ยนแปลงข้อมูล
• ไม่มีการบันทึกล็อกใด ๆ stdout ส่งเฉพาะข้อความโปรโตคอล API key และเนื้อหาข้อความจะไม่ไปถึงล็อกเลย

ใช้ SendHQ ใน Claude และ ChatGPT

ไม่ต้องติดตั้ง SendHQ ยังให้บริการเซิร์ฟเวอร์นี้เป็นคอนเน็กเตอร์แบบโฮสต์ที่ https://mcp.sendhq.cc/mcp พร้อมเครื่องมือชุดเดียวกัน คุณเข้าสู่ระบบด้วยบัญชี SendHQ แทนการวางคีย์

Claude

1. เปิด Settings → Connectors แล้วค้นหา SendHQ ในไดเรกทอรี หรือเลือก Add custom connector แล้ววาง https://mcp.sendhq.cc/mcp
2. คลิก Connect เข้าสู่ระบบ SendHQ ตรวจสอบสิทธิ์การเข้าถึง แล้วคลิก Allow
3. ขอให้ Claude ตรวจสอบกล่องจดหมายของคุณ ส่งอีเมลจากโดเมนที่ยืนยันแล้วของคุณ หรืออธิบายอีเมลตีกลับ

ChatGPT

1. Open Settings → Security and login and turn on Developer mode.
2. Go to chatgpt.com/plugins, click Create MCP app, name it SendHQ and enter https://mcp.sendhq.cc/mcp.
3. Sign in to SendHQ and click Allow, then pick SendHQ from the tools menu in a new chat.

Muse by Meta

In Muse, open Connectors and search for SendHQ. Click Connect, sign in to SendHQ and click Allow.

การอนุมัติและการตัดการเชื่อมต่อ

• The request_feature tool sends a feature request to the SendHQ team with your account details, so we can follow up by email.
• เครื่องมือที่ส่งอีเมลจริงหรือลบข้อมูลจะมีป้ายกำกับระบุไว้ การที่ผู้ช่วยจะถามคุณก่อนหรือไม่ตั้งค่าต่อเครื่องมือในตัวผู้ช่วย ใน Claude ให้เลือก Needs approval สำหรับเครื่องมือเหล่านั้นที่ Settings → Connectors → SendHQ
• คอนเน็กเตอร์จะได้ API key ของตัวเองซึ่งตั้งชื่อตามผู้ช่วย (เช่น “Claude (AI connector)”) ลบที่ API Keys เพื่อตัดการเชื่อมต่อทันที
• ไม่สามารถสร้างหรือเพิกถอน API key หรือเปลี่ยนการเรียกเก็บเงินได้ ไฟล์แนบส่งและคืนเป็น base64 ไม่มีการเข้าถึงไฟล์ในเครื่อง
• เวิร์กสเปซที่ยังไม่ชำระเงิน (ช่วงทดลองการเชื่อมต่อ) ส่งถึงได้เฉพาะอีเมลของบัญชีหรือที่อยู่จำลองของ AWS SES

คำถาม: postmaster@sendhq.cc ความเป็นส่วนตัว: sendhq.cc/privacy

ติดตั้ง

ติดตั้งไบนารี sendhq (Linux, macOS และ Windows บน x86-64 และ arm64) ตัวติดตั้งจะตรวจสอบ checksum ของรุ่นที่ปล่อยและวางไบนารีไว้ที่ ~/.local/bin เป็นค่าเริ่มต้น

curl -fsSL https://downloads.sendhq.cc/install.sh | sh

irm https://downloads.sendhq.cc/install.ps1 | iex

sendhq version
SENDHQ_API_KEY=re_your_key sendhq doctor

สร้าง API key ในแดชบอร์ดที่ https://sendhq.cc/app#/keys MCP server สร้างคีย์ไม่ได้ คำสั่งเดียวที่รันเซิร์ฟเวอร์คือ:

SENDHQ_API_KEY=re_your_key sendhq mcp

โดยปกติคุณไม่ต้องรันคำสั่งนั้นด้วยตนเอง MCP client จะเรียกให้ เมื่อรันในเทอร์มินัล มันจะรอ JSON-RPC บน stdin

ตั้งค่าไคลเอนต์ของคุณ

Claude Code

claude mcp add sendhq --env SENDHQ_API_KEY=re_your_key -- sendhq mcp

# read-only variant
claude mcp add sendhq-readonly --env SENDHQ_API_KEY=re_your_key -- sendhq mcp --read-only

เพิ่ม --scope user เพื่อให้ใช้ได้ในทุกโปรเจกต์ หรือ --scope project เพื่อเขียนลงใน .mcp.json ของโปรเจกต์ สำหรับ .mcp.json ที่ใช้ร่วมกัน ให้อ้างอิงคีย์จากตัวแปรสภาพแวดล้อมแทนการคอมมิต Claude Code จะขยาย ${VAR} ใน .mcp.json

{
  "mcpServers": {
    "sendhq": {
      "command": "sendhq",
      "args": [
        "mcp"
      ],
      "env": {
        "SENDHQ_API_KEY": "${SENDHQ_API_KEY}"
      }
    }
  }
}

OpenAI Codex

[mcp_servers.sendhq]
command = "sendhq"
args = ["mcp"]
env = { SENDHQ_API_KEY = "re_your_key" }

หรือจากบรรทัดคำสั่ง: codex mcp add sendhq --env SENDHQ_API_KEY=re_your_key -- sendhq mcp

Claude Desktop

แก้ไข claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) แล้วรีสตาร์ทแอป แอปเดสก์ท็อปไม่สืบทอด PATH ของเชลล์คุณ จึงให้ใช้พาธสัมบูรณ์ของไบนารี (which sendhq)

{
  "mcpServers": {
    "sendhq": {
      "command": "/Users/you/.local/bin/sendhq",
      "args": [
        "mcp"
      ],
      "env": {
        "SENDHQ_API_KEY": "re_your_key"
      }
    }
  }
}

MCP client อื่น ๆ

ตั้งค่า stdio server ด้วยคำสั่ง sendhq อาร์กิวเมนต์ ["mcp"] (ใส่ "--read-only" ได้หากต้องการ) และตัวแปรสภาพแวดล้อมด้านล่าง เซิร์ฟเวอร์รองรับ MCP protocol เวอร์ชัน 2024-11-05, 2025-03-26, 2025-06-18 และ 2025-11-25 และทำงาน initialize, ping, tools/list และ tools/call ผลลัพธ์ของเครื่องมือมีทั้งบล็อกข้อความ JSON และ structuredContent

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"probe","version":"1"}}}
{"jsonrpc":"2.0","method":"notifications/initialized"}
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_service_health","arguments":{}}}

เซิร์ฟเวอร์ที่ผูกกับบัญชีไม่มีทรานสปอร์ต HTTP แบบโฮสต์ endpoint MCP ระยะไกลที่เขียนได้ต้องใช้ OAuth ต่อผู้ใช้ ซึ่ง SendHQ ไม่มี ไบนารีในเครื่องเก็บคีย์ไว้บนเครื่องที่ถือคีย์อยู่แล้ว

สภาพแวดล้อมและแฟลก

คีย์ถูกส่งเฉพาะในเฮดเดอร์ Authorization: Bearer ไปยัง base URL ที่ตั้งค่าไว้ จะไม่มีการพิมพ์ บันทึกล็อก สะท้อนในข้อผิดพลาด หรือรวมในผลลัพธ์ของเครื่องมือ

โมเดลความปลอดภัยสำหรับเอเจนต์

• ส่งอีเมลจริง send_email, send_batch และ send_template_test ส่งอีเมลถึงคนจริงและใช้เครดิตการส่ง คำอธิบายของเครื่องมือเหล่านี้ขึ้นต้นด้วย SENDS REAL EMAIL เรียกใช้เฉพาะเมื่อผู้ใช้ขอให้ส่งข้อความนั้นโดยเฉพาะอย่างชัดเจน และยืนยันผู้รับ ผู้ส่ง และเนื้อหาแล้ว
• ทำลายข้อมูล delete_email, delete_draft, delete_attachment, delete_domain, delete_inbox และ remove_suppression ถูกทำเครื่องหมาย destructiveHint: true และคำอธิบายขึ้นต้นด้วย DESTRUCTIVE ให้ยืนยันกับผู้ใช้ก่อน remove_suppression ลดความเข้มของการบล็อกเพื่อความปลอดภัย และเหมาะสมเฉพาะเมื่อมนุษย์ยืนยันว่าที่อยู่นั้นใช้งานได้อีกครั้ง
• เปลี่ยนสถานะ การสร้างหรืออัปเดตฉบับร่าง เทมเพลต โดเมน และกล่องจดหมาย การเผยแพร่เทมเพลต และการเริ่มการยืนยัน จะเปลี่ยนเวิร์กสเปซแต่ไม่ส่งอีเมล
• อ่านอย่างเดียว ที่เหลือทั้งหมดเป็น readOnlyHint: true และเรียกใช้ได้อย่างอิสระโดยปลอดภัย
• เซิร์ฟเวอร์นี้ไม่เปลี่ยน DNS เลย add_domain คืนเรคคอร์ดให้มนุษย์เผยแพร่ get_domain_connect_link คืน URL ขอความยินยอมที่บุคคลต้องเปิดและอนุมัติที่ผู้ให้บริการ DNS ของตน
• เซิร์ฟเวอร์นี้ไม่เปลี่ยนการเรียกเก็บเงินเลย get_account อ่านเฉพาะแพ็กเกจ การใช้งาน และสถานะการสมัคร
• เวิร์กสเปซที่ยังไม่ชำระเงิน (ช่วงทดลองการเชื่อมต่อ) ส่งถึงได้เฉพาะอีเมลของเจ้าของบัญชี (get_account → user.email) หรือที่อยู่จำลองของ AWS SES เช่น success@simulator.amazonses.com และส่งไฟล์แนบไม่ได้
• ยอมรับไม่เท่ากับส่งถึง การส่งที่สำเร็จจะคืน ID หลักฐานการส่งถึง bounce และ complaint จะมาถึงภายหลังใน list_email_events ห้ามอ้างว่าเข้ากล่องจดหมายหรือมีคนอ่านข้อความแล้ว
• อย่าเปลี่ยนไปใช้ที่อยู่ From อื่นเพื่อเลี่ยงการหยุดชั่วคราวแบบ 423 และอย่าเพิ่มผู้รับที่ยกเลิกการรับหรือร้องเรียนกลับเข้าไปอีก

API key อยู่นอกขอบเขต

โดยการออกแบบ ไม่มีเครื่องมือที่สร้าง แก้ไข หมุนเวียน เพิกถอน หรือลบ API key เอเจนต์ต้องไม่สร้างหรือทำลายข้อมูลรับรอง list_api_keys คืนเฉพาะชื่อ คำนำหน้าที่ไม่เป็นความลับ และเวลาใช้งานล่าสุด การจัดการคีย์อยู่ในแดชบอร์ดกับมนุษย์ที่เข้าสู่ระบบ

เวิร์กโฟลว์

1. การส่งครั้งแรก

1. get_service_health ยืนยันว่าเข้าถึง API ได้ (ใช้งานได้โดยไม่ต้องมีคีย์)
2. get_account แสดงแพ็กเกจ (access.tier) โควตาที่เหลือ และ user.email ในช่วงทดลอง อีเมลนั้นเป็นผู้รับจริงเพียงรายเดียวที่อนุญาต
3. list_sending_identities แสดงที่อยู่ From ที่คุณใช้ได้ หากว่างเปล่า ให้ทำเวิร์กโฟลว์โดเมนก่อน
4. ยืนยันผู้ส่ง ผู้รับ หัวเรื่อง และเนื้อหากับผู้ใช้ จากนั้นเรียก send_email พร้อม idempotency_key
5. list_email_events พร้อม id ที่ได้คืนมาจะแสดง delivery, bounce, complaint หรือ reject เมื่อผู้ให้บริการรายงาน (โดยปกติภายในไม่กี่วินาทีถึงไม่กี่นาที)

{
  "name": "send_email",
  "arguments": {
    "from": "Acme <hello@example.com>",
    "to": [
      "owner@example.com"
    ],
    "subject": "SendHQ is connected",
    "text": "It works.",
    "idempotency_key": "first-send-2026-09-26"
  }
}

2. การยืนยันโดเมนตั้งแต่ต้นจนจบ

1. add_domain พร้อม name: "example.com" ผลลัพธ์รวมเรคคอร์ด DNS (CNAME ของ DKIM การยืนยัน SES SPF และ DMARC ที่แนะนำ)
2. get_dns_provider พร้อม domain_id ตรวจหาผู้ให้บริการ DNS ที่เป็นผู้มีอำนาจ และคืนโฮสต์แบบสัมพัทธ์ที่ตรงกันที่ต้องกรอกสำหรับแต่ละเรคคอร์ดที่ผู้ให้บริการนั้น
3. หาก providers.domainConnect.available เป็น true get_domain_connect_link จะคืน URL ขอความยินยอม ให้ส่งให้มนุษย์ จะไม่มีอะไรเปลี่ยนจนกว่าเขาจะอนุมัติที่ผู้ให้บริการ มิฉะนั้นให้ส่งเรคคอร์ดที่ต้องเผยแพร่ให้มนุษย์ อย่าเผยแพร่เรคคอร์ด SPF ที่สองเด็ดขาด ให้รวม include:amazonses.com เข้ากับค่า v=spf1 ที่มีอยู่
4. verify_domain ตรวจ DNS และ SES ซ้ำ สถานะเปลี่ยนผ่าน pending, checking และ propagating ไปเป็น verified ให้ poll verify_domain หรือ get_domain ทุก 30–60 วินาที DNS อาจใช้เวลาตั้งแต่ไม่กี่นาทีถึงหลายชั่วโมง
5. เมื่อ status เป็น verified ที่อยู่ของโดเมนจะปรากฏใน list_sending_identities

3. Bounce, complaint และการระงับการส่ง

1. list_blocked_recipients คืนทุกที่อยู่ที่ถูกบล็อกพร้อมเหตุผล (bounce, complaint, unsubscribe) และจำนวนสรุป
2. list_suppressions คืนการระงับการส่งจาก hard bounce และ complaint ส่วน deliverability_stats ให้อัตราการส่งถึง bounce และ complaint ย้อนหลัง 30 วัน และ list_sender_reputation แสดงที่อยู่ From ที่ถูกจำกัดหรือหยุดชั่วคราว
3. การส่งที่มีผู้รับที่ถูกระงับการส่งจะล้มเหลวด้วย 422 recipient_suppressed ให้ลบผู้รับรายนั้นแล้วส่งใหม่
4. เรียก remove_suppression เฉพาะเมื่อมนุษย์ยืนยันว่ากล่องจดหมายที่เคยตีกลับใช้งานได้แล้วเท่านั้น การระงับการส่งจาก complaint เป็นแบบถาวร (409 complaint_suppression_locked)

4. รับอีเมลขาเข้า

1. ต้องยืนยันโดเมน (มักเป็นโดเมนย่อย เช่น inbound.example.com)
2. setup_inbound จัดเตรียมการรับอีเมลและคืนเรคคอร์ด MX หนึ่งรายการ มนุษย์เป็นผู้เผยแพร่
3. verify_inbound จนกว่า status จะเป็น ready
4. create_inbox พร้อม domain_id และ local_part (เช่น support) สร้าง support@inbound.example.com
5. poll list_emails พร้อม direction: "in" และ unread: true (ใส่ inbox_id ได้หากต้องการ) อ่านข้อความด้วย get_email อ่านบทสนทนาด้วย get_thread ไฟล์แนบด้วย download_attachment และทำเครื่องหมายว่าจัดการแล้วด้วย mark_email (read: true)
6. ตอบกลับในเธรดเดิมด้วย send_email และ reply_to_email_id SendHQ ตั้งค่า In-Reply-To, References และเธรดให้

5. Webhook และการแจ้งเตือนอีเวนต์

ขณะนี้ SendHQ ไม่มี webhook ที่ลูกค้าตั้งค่าเองได้ จึงไม่มีเครื่องมือ webhook การแจ้งเตือนจากผู้ให้บริการถูกประมวลผลภายใน SendHQ และเปิดให้อ่านผ่านการอ่านข้อมูล ให้ poll แทน: list_email_events สำหรับผลลัพธ์ของข้อความหนึ่งฉบับ list_emails พร้อม status (เช่น bounced) หรือ after สำหรับการเปลี่ยนแปลงล่าสุด list_emails พร้อม direction: "in" และ unread: true สำหรับอีเมลขาเข้าใหม่ และ list_blocked_recipients สำหรับการระงับการส่งใหม่ อย่า poll เกินประมาณหนึ่งครั้งต่อนาทีต่อหนึ่งคำถาม

6. วินิจฉัยความล้มเหลวในการส่งถึง

1. ค้นหาข้อความ: list_emails พร้อม direction: "out" และ to หรือ query หรือ get_email หากคุณมี ID status: failed หมายความว่า SendHQ หรือผู้ให้บริการปฏิเสธในขั้นตอนการส่งเข้า ข้อผิดพลาดของอีเมลอธิบายสาเหตุ
2. list_email_events: bounce (ถาวรหรือชั่วคราว พร้อมข้อมูลวินิจฉัยจากผู้ให้บริการ) complaint, reject หรือ delivery หากยังไม่มีอีเวนต์ แสดงว่าผู้ให้บริการยังไม่รายงาน ให้รอแล้วตรวจสอบอีกครั้ง
3. หากการเรียกส่งล้มเหลวเอง ให้อ่านข้อผิดพลาด code: sender_domain_unverified → ทำการยืนยันโดเมนให้เสร็จ recipient_suppressed → ที่อยู่นั้นเคย hard bounce หรือร้องเรียนมาก่อน sender_paused → ตรวจสอบ list_sender_reputation และแก้ที่มาของรายชื่อ trial_recipient_restricted → ขีดจำกัดช่วงทดลอง quota_exhausted → การใช้งานใน get_account
4. get_domain ตรวจสอบว่า DKIM, SPF และ DMARC ยังเผยแพร่อยู่ ส่วน deliverability_stats แสดงว่าปัญหาเกิดกับข้อความเดียวหรือเป็นแนวโน้ม
5. รายงานสิ่งที่หลักฐานแสดง อีเวนต์ delivery หมายความว่าเซิร์ฟเวอร์ของผู้รับยอมรับข้อความ ไม่ได้หมายความว่าไปถึงกล่องจดหมายหรือถูกอ่านแล้ว

7. ดูแล bucket งาน (ป้ายกำกับ)

1. create_label พร้อม name (เช่น Agent/Orders) และ skip_inbox: true ซึ่งทำให้ป้ายกำกับเป็น bucket อีเมลที่ได้รับและได้ป้ายกำกับนี้จะถูกเก็บถาวร จึงปรากฏเฉพาะในป้ายกำกับ ไม่ปรากฏในกล่องเข้าของมนุษย์
2. ส่งอีเมลงานด้วย send_email (หรือ send_batch) และ labels: ["Agent/Orders"] การตอบกลับในบทสนทนานั้นจะสืบทอดป้ายกำกับโดยอัตโนมัติและข้ามกล่องเข้า
3. สำหรับอีเมลที่เริ่มนอกบทสนทนาของคุณ ให้เพิ่มกฎการจัดเก็บ: create_label_rule พร้อม inbox_id (ที่อยู่เฉพาะ เช่น orders@…) from to หรือ subject ส่ง apply_to_existing: true เพื่อจัดเก็บอีเมลที่ได้รับไปแล้ว
4. ทำงานกับ bucket: list_emails พร้อม label: "Agent/Orders" direction: "in" และ unread: true อ่านด้วย get_email หรือ get_thread ตอบกลับด้วย send_email และ reply_to_email_id และ mark_email read: true เมื่อจัดการแล้ว
5. ย้ายข้อความที่หลุดเข้าหรือออกด้วย label_email (add / remove) การเพิ่มป้ายกำกับ bucket ให้ข้อความที่ได้รับจะเก็บถาวรข้อความนั้นด้วย
6. หากต้องการ set_inbox_forwarding จะส่งสำเนาทุกอย่างที่ที่อยู่ผู้รับได้รับไปยังกล่องจดหมายอื่น (ปลายทางต้องยืนยันทางอีเมลก่อน)

{
  "name": "send_email",
  "arguments": {
    "from": "Orders <orders@example.com>",
    "to": [
      "customer@example.net"
    ],
    "subject": "Order 1042: confirm delivery window",
    "text": "Reply with a time that works.",
    "labels": [
      "Agent/Orders"
    ],
    "idempotency_key": "order-1042-window"
  }
}

8. ไฟล์แนบและเทมเพลต

แนบไฟล์ได้สูงสุด 10 ไฟล์ด้วย send_email attachments (แต่ละไฟล์ต้องมี content_base64 หรือ file_path ในเครื่อง โดย filename มีค่าเริ่มต้นเป็นชื่อไฟล์ของ basename) บนแพ็กเกจแบบชำระเงิน สำหรับเทมเพลตแบบโฮสต์: create_template → update_template_draft → render_template เพื่อดูตัวอย่างด้วยข้อมูลตัวอย่าง → send_template_test (ส่งอีเมลทดสอบจริงหนึ่งฉบับ) → publish_template จากนั้นส่งด้วย send_email หรือ send_batch โดยใช้ template: {key, data} และผู้รับ to หนึ่งรายพอดี

ผลลัพธ์ การแบ่งหน้า และข้อผิดพลาด

การเรียกที่สำเร็จจะคืนออบเจ็กต์ JSON ของ API เป็น structuredContent และเป็นบล็อกข้อความ JSON ทุกเครื่องมือ list_* รับ limit (1–200 ค่าเริ่มต้น 50) และ offset และเพิ่มออบเจ็กต์ pagination ให้เรียกต่อด้วย offset: pagination.next_offset ตราบใดที่ has_more เป็น true

{
  "data": [
    "…"
  ],
  "count": 50,
  "pagination": {
    "offset": 0,
    "limit": 50,
    "returned": 50,
    "total": 180,
    "has_more": true,
    "next_offset": 50
  }
}

การเรียกที่ล้มเหลวจะคืน isError: true พร้อมข้อผิดพลาดแบบมีโครงสร้าง ให้ทำตาม remedy แทนที่จะลองใหม่แบบสุ่มสี่สุ่มห้า ลองใหม่เฉพาะเมื่อ retryable เป็น true

{
  "error": {
    "code": "trial_recipient_restricted",
    "status": 402,
    "message": "The integration trial can deliver only to your account email or an AWS SES simulator address",
    "retryable": false,
    "explanation": "This workspace is on the unpaid integration trial. Trial sends can be delivered only to the account owner's email address or an AWS SES simulator address.",
    "remedy": "Send to the account email (get_account -> user.email) or a simulator address such as success@simulator.amazonses.com to test. To email anyone else, the account owner must activate a paid plan in the dashboard (Profile & Billing). Do not retry the same recipients."
  }
}

ฟิลด์ข้อผิดพลาดที่ไม่บังคับ: request_id (แจ้งซัพพอร์ตด้วยค่านี้) retry_after_seconds problems (รายการการละเมิด schema สำหรับ invalid_arguments) และ idempotent_replayed (ดู Idempotency)

Idempotency

send_email และ send_batch รับ idempotency_key (ไม่เกิน 200 ตัวอักษร) ซึ่งส่งเป็นเฮดเดอร์ Idempotency-Key ให้สร้างคีย์ที่คงที่หนึ่งคีย์ต่อข้อความเชิงตรรกะหนึ่งฉบับ เช่น invoice-4812-receipt

• การลองใหม่ต้องใช้คีย์เดิมและเนื้อหาคำขอที่เหมือนกันทุกประการ คีย์เดียวกันแต่มีการเปลี่ยนแปลงใด ๆ (ผู้รับ หัวเรื่อง เนื้อหา เฮดเดอร์ ข้อมูลเทมเพลต หรือแม้แต่ค่าอาร์กิวเมนต์) จะคืน 409 idempotency_conflict
• คีย์เดียวกัน เนื้อหาเดียวกัน และคำขอเดิมเสร็จแล้ว: SendHQ คืนผลลัพธ์ที่เก็บไว้โดยไม่ส่งอีก นี่คือวิธีลองใหม่อย่างปลอดภัยหลังหมดเวลาหรือ network_error
• คีย์เดียวกันขณะที่คำขอเดิมยังทำงานอยู่: 409 idempotency_in_progress ลองใหม่ได้หลังรอสักครู่
• ข้อความเชิงตรรกะใหม่ต้องใช้คีย์ใหม่
• ความล้มเหลวที่เก็บไว้ก็ถูกเล่นซ้ำเช่นกัน หากความพยายามแรกล้มเหลว การลองใหม่ด้วยคีย์เดียวกันจะคืนความล้มเหลวเดิมพร้อม idempotent_replayed: true และ retryable: false ตรวจสอบ list_emails (direction: out) เพื่อยืนยันว่าไม่มีอะไรถูกส่งออกไป แก้สาเหตุ แล้วส่งด้วยคีย์ใหม่
• เซิร์ฟเวอร์ไม่เคยลอง POST ใหม่เอง มีเพียงการเรียก GET แบบอ่านอย่างเดียวที่ลองใหม่โดยอัตโนมัติ (สูงสุด 3 ครั้งเมื่อเกิดข้อผิดพลาดของเครือข่าย 429 และ 5xx)
• send_email ที่มี attachments แบบอินไลน์ใช้ idempotency_key ไม่ได้ เพราะทำงานหลายคำขอ สำหรับการส่งไฟล์แนบที่ลองใหม่ได้อย่างปลอดภัย: create_draft → upload_attachment → send_email พร้อม draft_id และ idempotency_key

{
  "name": "send_email",
  "arguments": {
    "from": "Acme <billing@example.com>",
    "to": [
      "owner@example.com"
    ],
    "subject": "Receipt #4812",
    "text": "Thanks for your payment.",
    "idempotency_key": "receipt-4812"
  }
}

Rate limit และโควตา

SendHQ ไม่ได้เผยแพร่ขีดจำกัดจำนวนคำขอต่อวินาทีที่แน่นอนสำหรับ API ขีดจำกัดที่เอเจนต์พบจริงคือขีดจำกัดการใช้งาน ซึ่งคืนเป็น 429:

• การส่งถึงผู้รับรายเดือนตามแพ็กเกจ แต่ละที่อยู่ To, Cc และ Bcc นับเป็นหนึ่งการส่งถึง ดู get_account → usage.recipientDeliveries เทียบกับ usage.emailQuotaMonth
• ผู้รับรายวันต่อที่อยู่ From ที่ตรงกันทุกตัวอักษร กำหนดโดยสถานะชื่อเสียงของผู้ส่งรายนั้น (list_sender_reputation → dailyLimit ค่าเริ่มต้น 2,000 บนแพ็กเกจแบบชำระเงิน)
• ช่วงทดลองการเชื่อมต่อ: ผู้รับรวม 100 ราย ส่งถึงได้เฉพาะอีเมลของบัญชีหรือที่อยู่จำลองของ SES
• ไฟล์แนบ: สูงสุด 10 ไฟล์และ 10 MB ต่อข้อความ และ 10 GB ของการถ่ายโอนไฟล์แนบตามน้ำหนักผู้รับต่อเดือนบนแพ็กเกจแบบชำระเงิน
• ต่อคำขอ: To + Cc + Bcc สูงสุด 100 ที่อยู่ send_batch สูงสุด 100 ข้อความ
• ตัวตัดวงจรด้านชื่อเสียง: ในช่วงเลื่อน 7 วัน หาก bounce หรือ complaint เกินเกณฑ์ จะจำกัดหรือหยุดที่อยู่ From หนึ่งที่อยู่ชั่วคราว (423 sender_paused) และจะกลับมาเป็นปกติโดยอัตโนมัติเมื่ออัตราลดลง

quota_exhausted ลองใหม่ไม่ได้จนกว่ารอบจะรีเซ็ตหรือเปลี่ยนแพ็กเกจ rate_limited ลองใหม่ได้หลัง retry_after_seconds สำหรับการส่ง ให้ลองใหม่ด้วย idempotency_key เดิมและเนื้อหาที่เหมือนกันทุกประการ

แค็ตตาล็อกข้อผิดพลาด

code คงที่ ให้แตกสาขาตามค่านี้ ไม่ใช่ตาม message

ข้อมูลอ้างอิงเครื่องมือ

ทุกเครื่องมือพร้อมคลาสความปลอดภัย REST endpoint ที่เรียก พารามิเตอร์ รูปแบบค่าที่คืน และตัวอย่างออบเจ็กต์ params ของ tools/call พารามิเตอร์ต้องตรงทุกตัวอักษร เซิร์ฟเวอร์จะปฏิเสธทุกอย่างที่ไม่ได้ระบุไว้

อีเมลและเธรด: send_email, send_batch, list_emails, get_email, mark_email, delete_email, list_email_events, get_thread
ป้ายกำกับและกฎจัดเก็บอัตโนมัติ: list_labels, get_label, create_label, update_label, delete_label, create_label_rule, delete_label_rule, label_email
ฉบับร่าง ไฟล์แนบ และตัวตนผู้ส่ง: list_sending_identities, create_draft, list_drafts, get_draft, update_draft, delete_draft, upload_attachment, download_attachment, delete_attachment
เทมเพลตแบบโฮสต์: list_templates, create_template, get_template, update_template_draft, create_template_draft, render_template, send_template_test, publish_template, archive_template, restore_template
โดเมนและ DNS: list_domains, get_domain, add_domain, verify_domain, delete_domain, get_dns_provider, get_domain_connect_link
อีเมลขาเข้า: setup_inbound, verify_inbound, list_inboxes, get_inbox, create_inbox, update_inbox, set_inbox_forwarding, delete_inbox
ความสามารถในการส่งถึง bounce และการระงับการส่ง: deliverability_stats, list_sender_reputation, list_suppressions, remove_suppression, list_blocked_recipients
บัญชี การใช้งาน การวิเคราะห์ และคีย์: get_account, get_analytics, list_api_keys, get_service_health

ไม่มีเครื่องมือที่ตรงกับตัวกรองนี้

อีเมลและเธรด

{
  "name": "send_email",
  "arguments": {
    "from": "Acme <hello@example.com>",
    "to": [
      "owner@example.com"
    ],
    "subject": "Your export is ready",
    "text": "Download it from your dashboard.",
    "idempotency_key": "export-ready-42"
  }
}

{
  "name": "send_batch",
  "arguments": {
    "emails": [
      {
        "from": "Acme <hello@example.com>",
        "to": [
          "owner@example.com"
        ],
        "template": {
          "key": "account-welcome",
          "data": {
            "first_name": "Asha"
          }
        }
      }
    ],
    "idempotency_key": "welcome-batch-2026-09-26"
  }
}

{
  "name": "list_emails",
  "arguments": {
    "direction": "in",
    "unread": true,
    "limit": 25
  }
}

{
  "name": "get_email",
  "arguments": {
    "email_id": "em_123"
  }
}

{
  "name": "mark_email",
  "arguments": {
    "email_id": "em_123",
    "read": true
  }
}

{
  "name": "delete_email",
  "arguments": {
    "email_id": "em_123"
  }
}

{
  "name": "list_email_events",
  "arguments": {
    "email_id": "em_123"
  }
}

{
  "name": "get_thread",
  "arguments": {
    "thread_id": "em_123"
  }
}

ป้ายกำกับและกฎจัดเก็บอัตโนมัติ

{
  "name": "list_labels",
  "arguments": {}
}

{
  "name": "get_label",
  "arguments": {
    "label_id": "Billing"
  }
}

{
  "name": "create_label",
  "arguments": {
    "name": "Agent/Orders",
    "skip_inbox": true,
    "rules": [
      {
        "from": "@stripe.com"
      }
    ]
  }
}

{
  "name": "update_label",
  "arguments": {
    "label_id": "lbl_123",
    "name": "Finance/Billing"
  }
}

{
  "name": "delete_label",
  "arguments": {
    "label_id": "lbl_123"
  }
}

{
  "name": "create_label_rule",
  "arguments": {
    "label_id": "Billing",
    "inbox_id": "inb_123",
    "skip_inbox": true
  }
}

{
  "name": "delete_label_rule",
  "arguments": {
    "label_id": "lbl_123",
    "rule_id": "lrule_123"
  }
}

{
  "name": "label_email",
  "arguments": {
    "email_id": "em_123",
    "add": [
      "Billing"
    ],
    "remove": [
      "Support"
    ]
  }
}

ฉบับร่าง ไฟล์แนบ และตัวตนผู้ส่ง

{
  "name": "list_sending_identities",
  "arguments": {}
}

{
  "name": "create_draft",
  "arguments": {
    "from": "hello@example.com",
    "to": [
      "owner@example.com"
    ],
    "subject": "Invoice"
  }
}

{
  "name": "list_drafts",
  "arguments": {}
}

{
  "name": "get_draft",
  "arguments": {
    "draft_id": "dr_123"
  }
}

{
  "name": "update_draft",
  "arguments": {
    "draft_id": "dr_123",
    "from": "hello@example.com",
    "to": [
      "owner@example.com"
    ],
    "subject": "Invoice (updated)",
    "text": "Attached."
  }
}

{
  "name": "delete_draft",
  "arguments": {
    "draft_id": "dr_123"
  }
}

{
  "name": "upload_attachment",
  "arguments": {
    "draft_id": "dr_123",
    "filename": "invoice.pdf",
    "content_type": "application/pdf",
    "file_path": "/tmp/invoice.pdf"
  }
}

{
  "name": "download_attachment",
  "arguments": {
    "attachment_id": "att_123",
    "save_to_path": "/tmp/invoice.pdf"
  }
}

{
  "name": "delete_attachment",
  "arguments": {
    "attachment_id": "att_123"
  }
}

เทมเพลตแบบโฮสต์

{
  "name": "list_templates",
  "arguments": {
    "lifecycle": "active"
  }
}

{
  "name": "create_template",
  "arguments": {
    "name": "Account welcome",
    "key": "account-welcome",
    "starter": "welcome"
  }
}

{
  "name": "get_template",
  "arguments": {
    "template_id": "account-welcome"
  }
}

{
  "name": "update_template_draft",
  "arguments": {
    "template_id": "account-welcome",
    "revision": 3,
    "name": "Account welcome",
    "subject_template": "Welcome, {{first_name}}",
    "text_template": "Hi {{first_name}}",
    "variables": [
      {
        "key": "first_name",
        "type": "text",
        "required": true
      }
    ],
    "sample_data": {
      "first_name": "Asha"
    }
  }
}

{
  "name": "create_template_draft",
  "arguments": {
    "template_id": "account-welcome"
  }
}

{
  "name": "render_template",
  "arguments": {
    "template_id": "account-welcome",
    "data": {
      "first_name": "Asha"
    }
  }
}

{
  "name": "send_template_test",
  "arguments": {
    "template_id": "account-welcome",
    "to": [
      "owner@example.com"
    ]
  }
}

{
  "name": "publish_template",
  "arguments": {
    "template_id": "account-welcome"
  }
}

{
  "name": "archive_template",
  "arguments": {
    "template_id": "account-welcome"
  }
}

{
  "name": "restore_template",
  "arguments": {
    "template_id": "account-welcome"
  }
}

โดเมนและ DNS

{
  "name": "list_domains",
  "arguments": {}
}

{
  "name": "get_domain",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "add_domain",
  "arguments": {
    "name": "example.com"
  }
}

{
  "name": "verify_domain",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "delete_domain",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "get_dns_provider",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "get_domain_connect_link",
  "arguments": {
    "domain_id": "dom_123"
  }
}

อีเมลขาเข้า

{
  "name": "setup_inbound",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "verify_inbound",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "list_inboxes",
  "arguments": {
    "domain_id": "dom_123"
  }
}

{
  "name": "get_inbox",
  "arguments": {
    "inbox_id": "inb_123"
  }
}

{
  "name": "create_inbox",
  "arguments": {
    "domain_id": "dom_123",
    "local_part": "support",
    "name": "Support"
  }
}

{
  "name": "update_inbox",
  "arguments": {
    "inbox_id": "inb_123",
    "status": "disabled"
  }
}

{
  "name": "set_inbox_forwarding",
  "arguments": {
    "inbox_id": "inb_123",
    "forward_to": "team@example.net"
  }
}

{
  "name": "delete_inbox",
  "arguments": {
    "inbox_id": "inb_123"
  }
}

ความสามารถในการส่งถึง bounce และการระงับการส่ง

{
  "name": "deliverability_stats",
  "arguments": {}
}

{
  "name": "list_sender_reputation",
  "arguments": {}
}

{
  "name": "list_suppressions",
  "arguments": {}
}

{
  "name": "remove_suppression",
  "arguments": {
    "email": "fixed-mailbox@example.net"
  }
}

{
  "name": "list_blocked_recipients",
  "arguments": {}
}

บัญชี การใช้งาน การวิเคราะห์ และคีย์

{
  "name": "get_account",
  "arguments": {}
}

{
  "name": "get_analytics",
  "arguments": {
    "days": 30
  }
}

{
  "name": "list_api_keys",
  "arguments": {}
}

{
  "name": "get_service_health",
  "arguments": {}
}

รายการความครอบคลุมของ API

ทุกการดำเนินการใน API สาธารณะและเครื่องมือที่ครอบคลุม ทุกอย่างที่ผู้ใช้ทำได้ในแดชบอร์ดและมี API จะถูกครอบคลุม ส่วนที่ยกเว้นด้านล่างเป็นการเจตนา

ไม่มีให้ใช้โดยเจตนา

แค็ตตาล็อกที่เครื่องอ่านได้: /docs/mcp/tools.json (schema, annotation, การจับคู่ endpoint และรายการที่ยกเว้น) หน้านี้ฉบับ Markdown: /docs/mcp.md เมื่อติดตั้ง CLI แล้ว sendhq commands --format json จะพิมพ์แค็ตตาล็อกเดียวกัน