SendHQ MCP 서버

이 서버는 무엇인가요

SendHQ MCP 서버를 사용하면 AI 에이전트가 Model Context Protocol을 통해 SendHQ 워크스페이스 하나를 운영할 수 있습니다. 이메일 발송(단건, 일괄, 템플릿, 답장, 첨부 파일, 멱등 재시도), 발신 및 수신 메일(제목, 본문, 첨부 파일 이름)과 전송 이벤트 조회 및 검색, 자동 분류 규칙을 갖춘 라벨로 메일 정리, 초안과 비공개 첨부 파일 관리, 호스팅 템플릿 작성과 게시, 도메인과 DNS 추가 및 검증, 수신 설정과 수신 주소 구성, 전달성, 반송, 스팸 신고, 발송 제외 조사, 계정 사용량, 결제 상태, 분석, API 키 메타데이터 조회를 지원합니다.

sendhq CLI 바이너리에 내장된 로컬 stdio 서버입니다. MCP 클라이언트가 sendhq mcp를 자식 프로세스로 실행하고 stdin/stdout으로 JSON-RPC를 주고받습니다. 모든 도구 호출은 워크스페이스 API 키로 인증된 https://sendhq.cc/api/v1의 SendHQ REST API에 대한 문서화된 요청 하나로 변환되므로, MCP 서버는 그 키가 가진 권한만큼만, 그 이상은 갖지 않습니다.

• 8개 그룹의 59개 도구가 하나의 카탈로그에서 생성되며, 이 카탈로그는 tools.json으로도 공개됩니다.
• 엄격한 JSON 스키마: 알 수 없는 인수, 잘못된 타입, 누락된 필수 필드는 SendHQ에 도달하기 전에 로컬에서 거부됩니다.
• 안정적인 code, HTTP status, explanation, 구체적인 remedy, 재시도가 도움이 되는지 여부를 담은 구조화된 오류를 반환합니다.
• 실제 이메일을 발송하거나 데이터를 삭제하는 모든 도구는 설명의 첫머리에서 이를 밝히며 MCP 안전 어노테이션을 포함합니다.
• --read-only 모드는 발송 및 변경 도구를 모두 숨깁니다.
• 아무것도 로그로 남기지 않습니다. stdout에는 프로토콜 메시지만 흐르며, API 키와 메시지 내용은 어떤 로그에도 기록되지 않습니다.

Claude와 ChatGPT에서 SendHQ 사용하기

설치가 필요 없습니다. 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에서는 Settings → Connectors → SendHQ에서 해당 도구에 Needs approval을 선택하세요.
• 커넥터는 어시스턴트 이름을 딴 별도의 API 키(예: “Claude (AI connector)”)를 받습니다. API Keys에서 이 키를 삭제하면 즉시 연결이 해제됩니다.
• API 키를 만들거나 폐기할 수 없으며 결제도 변경할 수 없습니다. 첨부 파일은 base64로 보내고 반환되며, 로컬 파일에는 접근하지 않습니다.
• 미결제 워크스페이스(연동 체험판)는 계정 이메일 또는 AWS SES 시뮬레이터 주소로만 전송할 수 있습니다.

문의: postmaster@sendhq.cc. 개인정보 처리: sendhq.cc/privacy.

설치

sendhq 바이너리를 설치하세요(x86-64와 arm64의 Linux, macOS, Windows 지원). 설치 프로그램은 릴리스 체크섬을 검증하고 기본적으로 바이너리를 ~/.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

대시보드 https://sendhq.cc/app#/keys에서 API 키를 만드세요. MCP 서버는 키를 만들 수 없습니다. 서버를 실행하는 명령어는 다음 하나뿐입니다.

SENDHQ_API_KEY=re_your_key sendhq mcp

보통은 직접 실행할 일이 없으며 MCP 클라이언트가 실행합니다. 터미널에서 실행하면 stdin에서 JSON-RPC를 기다립니다.

클라이언트 설정

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를, 프로젝트의 .mcp.json에 기록하려면 --scope project를 추가하세요. 공유 .mcp.json에서는 키를 커밋하지 말고 환경 변수에서 참조하세요. Claude Code는 .mcp.json의 ${VAR}를 확장합니다.

{
  "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 클라이언트

명령어 sendhq, 인수 ["mcp"](선택적으로 "--read-only"), 아래의 환경 변수로 stdio 서버를 구성하세요. 이 서버는 MCP 프로토콜 버전 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 전송이 없습니다. 쓰기가 가능한 원격 MCP 엔드포인트에는 사용자별 OAuth가 필요한데 SendHQ는 이를 제공하지 않습니다. 로컬 바이너리는 키를 이미 보유한 머신에만 둡니다.

환경 변수와 플래그

키는 설정된 기본 URL로 Authorization: Bearer 헤더로만 전송됩니다. 출력, 로그, 오류 메시지, 도구 결과에는 절대 포함되지 않습니다.

에이전트를 위한 안전 모델

• 실제 이메일을 발송합니다. 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는 사람이 직접 열어 DNS 제공업체에서 승인해야 하는 동의 URL을 반환합니다.
• 이 서버는 결제를 절대 변경하지 않습니다. get_account는 요금제, 사용량, 구독 상태만 읽습니다.
• 미결제 워크스페이스(연동 체험판)는 계정 소유자의 이메일(get_account → user.email) 또는 success@simulator.amazonses.com 같은 AWS SES 시뮬레이터 주소로만 전송할 수 있으며, 첨부 파일은 보낼 수 없습니다.
• 접수는 전달이 아닙니다. 발송에 성공하면 ID가 반환됩니다. 전달, 반송, 스팸 신고 증거는 나중에 list_email_events에 나타납니다. 받은편지함에 도달했다거나 사람이 메시지를 읽었다고 절대 단정하지 마세요.
• 423 일시 중지를 우회하려고 다른 From 주소로 바꾸지 말고, 수신 거부하거나 스팸 신고한 수신자를 다시 추가하지 마세요.

API 키는 범위 밖입니다

설계상 API 키를 만들거나, 수정하거나, 교체하거나, 폐기하거나, 삭제하는 도구는 없습니다. 에이전트가 자격 증명을 발급하거나 파기해서는 안 되기 때문입니다. list_api_keys는 이름, 비밀이 아닌 접두사, 마지막 사용 시각만 반환합니다. 키 관리는 로그인한 사람이 대시보드에서 수행합니다.

워크플로

1. 첫 발송

1. get_service_health로 API에 연결할 수 있는지 확인합니다(키 없이도 동작).
2. get_account로 요금제(access.tier), 남은 할당량, user.email을 확인합니다. 체험판에서는 그 이메일이 유일하게 허용되는 실제 수신자입니다.
3. list_sending_identities로 사용할 수 있는 From 주소를 조회합니다. 목록이 비어 있으면 먼저 도메인 워크플로를 진행하세요.
4. 발신자, 수신자, 제목, 본문을 사용자에게 확인한 뒤 idempotency_key와 함께 send_email을 호출합니다.
5. 반환된 id로 list_email_events를 호출하면 제공업체가 보고하는 즉시(보통 몇 초에서 몇 분 이내) 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. name: "example.com"으로 add_domain을 호출합니다. 결과에는 DNS 레코드(DKIM CNAME, SES 검증, SPF, 권장 DMARC)가 포함됩니다.
2. domain_id로 get_dns_provider를 호출하면 권한 있는 DNS 제공업체를 감지하고 해당 제공업체에서 각 레코드에 입력할 정확한 상대 호스트를 반환합니다.
3. providers.domainConnect.available이 true이면 get_domain_connect_link가 동의 URL을 반환합니다. 이를 사람에게 전달하세요. 사람이 제공업체에서 승인하기 전까지는 아무것도 바뀌지 않습니다. 그렇지 않으면 게시할 레코드를 사람에게 알려 주세요. SPF 레코드를 두 번째로 게시하지 말고 기존 v=spf1 값에 include:amazonses.com을 병합하세요.
4. verify_domain은 DNS와 SES를 다시 확인합니다. 상태는 pending, checking, propagating을 거쳐 verified가 됩니다. verify_domain 또는 get_domain을 30~60초마다 폴링하세요. DNS는 몇 분에서 몇 시간이 걸릴 수 있습니다.
5. status가 verified가 되면 도메인의 주소가 list_sending_identities에 나타납니다.

3. 반송, 스팸 신고, 발송 제외

1. list_blocked_recipients는 차단된 모든 주소를 사유(bounce, complaint, unsubscribe)와 요약 건수와 함께 반환합니다.
2. list_suppressions는 하드 바운스 및 스팸 신고로 인한 발송 제외 항목을 반환하고, deliverability_stats는 최근 30일의 전달률, 반송률, 스팸 신고율을 제공하며, list_sender_reputation은 속도가 제한되었거나 일시 중지된 From 주소를 보여 줍니다.
3. 발송 제외된 수신자가 포함된 발송은 422 recipient_suppressed로 실패합니다. 그 수신자를 제거하고 다시 발송하세요.
4. 사람이 반송된 메일함이 이제 정상 작동한다고 확인한 경우에만 remove_suppression을 호출하세요. 스팸 신고로 인한 발송 제외는 영구적입니다(409 complaint_suppression_locked).

4. 수신 이메일 받기

1. 도메인(inbound.example.com 같은 서브도메인인 경우가 많음)이 검증되어 있어야 합니다.
2. setup_inbound가 수신을 프로비저닝하고 MX 레코드 하나를 반환합니다. 사람이 이를 게시합니다.
3. status가 ready가 될 때까지 verify_inbound를 호출합니다.
4. domain_id와 local_part(예: support)로 create_inbox를 호출하면 support@inbound.example.com이 만들어집니다.
5. direction: "in"과 unread: true(선택적으로 inbox_id)로 list_emails를 폴링합니다. 메시지는 get_email로, 대화는 get_thread로, 첨부 파일은 download_attachment로 읽고, 처리를 마치면 mark_email(read: true)로 표시합니다.
6. send_email과 reply_to_email_id로 같은 스레드에서 답장합니다. SendHQ가 In-Reply-To, References, 스레드를 설정합니다.

5. 웹훅과 이벤트 알림

SendHQ는 현재 고객이 직접 설정할 수 있는 웹훅을 제공하지 않으므로 웹훅 도구가 없습니다. 제공업체 알림은 SendHQ 내부에서 처리되어 읽기 도구로 노출됩니다. 대신 폴링하세요. 메시지 하나의 결과에는 list_email_events, 최근 변경에는 status(예: bounced) 또는 after를 지정한 list_emails, 새 수신 메일에는 direction: "in"과 unread: true를 지정한 list_emails, 새 발송 제외에는 list_blocked_recipients를 사용합니다. 질문당 약 1분에 한 번을 넘지 않게 폴링하세요.

6. 전달 실패 진단

1. 메시지 찾기: direction: "out"과 to 또는 query를 지정한 list_emails를 사용하거나, ID를 알면 get_email을 사용합니다. status: failed는 SendHQ 또는 제공업체가 제출 단계에서 거부했다는 뜻이며, 이메일의 오류가 이유를 설명합니다.
2. list_email_events: bounce(제공업체 진단과 함께 영구적 또는 일시적), complaint, reject, delivery. 아직 이벤트가 없다면 제공업체가 보고하지 않은 것이므로 기다렸다가 다시 확인하세요.
3. 발송 호출 자체가 실패했다면 오류 code를 확인하세요. sender_domain_unverified → 도메인 검증을 마치세요. recipient_suppressed → 그 주소가 이전에 하드 바운스되었거나 스팸 신고했습니다. sender_paused → list_sender_reputation을 확인하고 목록 출처를 고치세요. trial_recipient_restricted → 체험판 제한입니다. quota_exhausted → get_account 사용량을 확인하세요.
4. get_domain으로 DKIM, SPF, DMARC가 여전히 게시되어 있는지 확인하고, deliverability_stats로 문제가 메시지 하나의 문제인지 추세인지 확인합니다.
5. 증거가 보여 주는 내용을 그대로 보고하세요. delivery 이벤트는 수신자의 서버가 메시지를 받아들였다는 뜻이지, 받은편지함에 도달했거나 읽혔다는 뜻이 아닙니다.

7. 작업 버킷 운영하기(라벨)

1. name(예: Agent/Orders)과 skip_inbox: true로 create_label을 호출합니다. 그러면 라벨이 버킷이 됩니다. 이 라벨이 붙는 수신 메일은 보관 처리되어 라벨에만 표시되고 사람의 받은편지함에는 나타나지 않습니다.
2. send_email(또는 send_batch)에 labels: ["Agent/Orders"]를 지정해 작업 메일을 발송합니다. 그 대화에 대한 답장은 라벨을 자동으로 상속하고 받은편지함을 건너뜁니다.
3. 내 대화 밖에서 시작되는 메일에는 분류 규칙을 추가합니다. inbox_id(orders@… 같은 전용 주소), from, to, subject를 지정해 create_label_rule을 호출하세요. 이미 받은 메일도 분류하려면 apply_to_existing: true를 전달합니다.
4. 버킷 처리: label: "Agent/Orders", direction: "in", unread: true로 list_emails를 호출하고, get_email 또는 get_thread로 읽고, send_email과 reply_to_email_id로 답장하며, 처리를 마치면 mark_email read: true로 표시합니다.
5. 엉뚱한 메시지는 label_email(add / remove)로 버킷에 넣거나 뺍니다. 수신 메시지에 버킷 라벨을 추가하면 그 메시지도 보관 처리됩니다.
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. 첨부 파일과 템플릿

유료 플랜에서는 send_email attachments로 파일을 최대 10개까지 첨부할 수 있습니다(각각 content_base64 또는 로컬 file_path가 필요하며 filename의 기본값은 파일의 basename입니다). 호스팅 템플릿의 경우 create_template → update_template_draft → 샘플 데이터로 미리 보는 render_template → 실제 테스트 메일 한 통을 보내는 send_template_test → publish_template 순서로 진행한 다음, template: {key, data}와 정확히 한 명의 to 수신자로 send_email 또는 send_batch를 호출해 발송합니다.

결과, 페이지네이션, 오류

호출에 성공하면 API의 JSON 객체가 structuredContent와 JSON 텍스트 블록으로 반환됩니다. 모든 list_* 도구는 limit(1–200, 기본값 50)과 offset을 받으며 pagination 객체를 추가합니다. has_more가 true인 동안 offset: pagination.next_offset으로 계속 호출하세요.

{
  "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(invalid_arguments에 대한 스키마 위반 목록), idempotent_replayed(멱등성 항목 참조).

멱등성

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 호출만 자동으로 재시도됩니다(네트워크 오류, 429, 5xx에서 최대 3회).
• 인라인 attachments가 있는 send_email은 여러 요청을 실행하므로 idempotency_key를 받을 수 없습니다. 재시도해도 안전한 첨부 파일 발송은 create_draft → upload_attachment → draft_id와 idempotency_key를 지정한 send_email 순서로 진행하세요.

{
  "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"
  }
}

속도 제한과 할당량

SendHQ는 API의 초당 요청 수 제한을 고정 값으로 공개하지 않습니다. 에이전트가 실제로 마주치는 제한은 사용량 한도이며 429로 반환됩니다.

• 요금제별 월간 수신자 전달 수. To, Cc, Bcc 주소 각각이 전달 1건으로 집계됩니다. 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일 롤링 기간 동안 반송 또는 스팸 신고가 임계값을 넘으면 From 주소 하나의 발송 속도를 제한하거나 일시 중지합니다(423 sender_paused). 비율이 낮아지면 자동으로 복구됩니다.

quota_exhausted는 기간이 초기화되거나 요금제가 바뀌기 전까지 재시도할 수 없습니다. rate_limited는 retry_after_seconds 이후 재시도할 수 있으며, 발송은 같은 idempotency_key와 동일한 본문으로 재시도하세요.

오류 카탈로그

code는 안정적이므로 message가 아니라 이 값으로 분기하세요.

도구 레퍼런스

모든 도구의 안전 등급, 호출하는 REST 엔드포인트, 매개변수, 반환 형태, tools/call params 객체 예시를 나열합니다. 매개변수는 정확히 이대로여야 하며, 서버는 나열되지 않은 항목을 모두 거부합니다.

이메일 및 스레드: 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
초안, 첨부 파일, 발신 ID: 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
전달성, 반송, 발송 제외: 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"
    ]
  }
}

초안, 첨부 파일, 발신 ID

{
  "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"
  }
}

전달성, 반송, 발송 제외

{
  "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(스키마, 어노테이션, 엔드포인트 매핑, 제외 항목). 이 페이지의 Markdown 버전: /docs/mcp.md. CLI가 설치되어 있으면 sendhq commands --format json이 같은 카탈로그를 출력합니다.