# MCP 도구 목록

> Atmark MCP 서버가 에이전트에게 주는 도구 열두 개와 각 도구에 필요한 권한.

- `send_email`
- `reply_email`
- `forward_email`
- `list_inbox`
- `read_email`
- `get_thread`
- `get_attachment_url`
- `get_approval_status`
- `get_my_policy`
- `get_verification_code`
- `list_scheduled`
- `cancel_scheduled`

## 도구별 설명

| 도구 | 하는 일 | 권한 |
|---|---|---|
| `send_email` | 새 메일을 보냅니다. `from`을 생략하면 대표 주소로 보냅니다. | 보내기 |
| `reply_email` | 받은 메일에 회신합니다. 기본 받는 사람은 보낸 사람, 제목은 `Re: …`입니다. | 보내기 |
| `forward_email` | 받은 메일을 전달합니다. 본문 텍스트만, 첨부는 빼고 옮깁니다. | 보내기 |
| `list_inbox` | 받은 메일 목록(최신순). 보낸 사람·기간·스레드로 거릅니다. 격리된 메일은 개수만 보입니다. | 읽기 |
| `read_email` | 받은 메일 한 통을 읽습니다. 길면 잘리고 `offset`으로 이어 읽습니다. | 읽기 |
| `get_thread` | 스레드를 봅니다. 길면 최신 메일부터 보이고, `before_message_id`로 앞을 이어 봅니다. | 읽기 |
| `get_attachment_url` | 받은 첨부의 내려받기 링크(5분 유효) | 읽기 |
| `get_approval_status` | 승인 대기 결과(대기·승인·거절·만료) | 읽기 |
| `get_my_policy` | 자기 정책과 한도, 기본 발신 주소 | 자기 정보 |
| `get_verification_code` | 가입·로그인 인증 코드 찾기. [인증 코드](https://docs.atmark.ai/email/verification-codes) | 읽기 |
| `list_scheduled` | 예약 메일 목록과 상태(`scheduled`·`dispatched`·`cancelled`) | 읽기 |
| `cancel_scheduled` | 예약 취소. 사유 코드가 필수입니다. | 보내기 |

## 알아 둘 것

- `agent_id`는 인자가 아닙니다. 토큰이 정합니다. 에이전트는 자기 메일과 정보만 봅니다.
- 소유자 권한이 필요한 도구(정책 바꾸기 등)는 서버에 없습니다. 예약을 **만드는** 도구도 없습니다. 예약은 [REST API](https://docs.atmark.ai/api/scheduled)로 만듭니다.
- 같은 인자로 다시 불러도 메일은 두 번 나가지 않습니다. 결과에 `replayed: true`가 붙습니다. 그래서 거부된 메일을 원인을 고친 뒤 다시 보낼 때는 `idempotency_key`에 새 값을 넣어야 합니다.
- 발송 결과(`sent`·`denied`·`pending_approval`)와 전달 거부(`refused`)는 모두 정상 결과입니다. 결과의 `next_step` 한 줄이 다음 할 일을 말합니다.
- 받은 메일의 본문·제목·주소·파일명은 결과 안의 외부 데이터 블록에만 들어 있습니다. [받은 메일은 데이터로 다루기](https://docs.atmark.ai/connect/untrusted-mail)

---

원문: https://docs.atmark.ai/connect/mcp-tools · 마지막 수정 2026-09-27