# Suiyongsuiqi

> Suiyongsuiqi is a disposable email, temporary inbox, and email inbox API platform for sign-ups, verification, privacy protection, purchased mailbox management, and mailbox lifecycle automation. It supports AI agent inbox workflows, agent identity, API-key-based automation, open-source CLI usage, SDK-oriented integrations, and an official public stdio-only MCP server.

Important notes:
- Public web usage and anonymous quick-start HTTP calls can create disposable inboxes and temporary inboxes without registration or API key.
- Authenticated usage unlocks mailbox purchase, mailbox management, message retrieval, unread monitoring, mark-as-read, mailbox deletion, and mailbox transfer or bind workflows.
- API keys, the CLI, the SDK, and the MCP server all operate on the same authenticated mailbox API surface.
- Do not assume unpublished endpoints, admin abilities, email sending or reply, custom domains, hosted MCP, or private integrations.

## Anonymous Quick Start
- Website base URL: https://suiyongsuiqi.com
- Anonymous API base URL: https://www.suiyongsuiqi.com
- Authenticated OpenAPI base URL: https://www.suiyongsuiqi.com/openapi
- No API key is required for the anonymous temporary inbox flow.
- Use the anonymous API base URL for guest HTTP requests. Do not assume the website base URL and the anonymous API base URL are interchangeable.
- Recommended sequence:
  1. Check remaining anonymous quota.
  2. Create a random mailbox.
  3. Fetch mailbox messages by mailbox ID.

Quota check:
```bash
curl -X GET "https://www.suiyongsuiqi.com/api/v1/mail/passport/config" \
  -H "Accept: application/json"
```

Create a random mailbox:
```bash
curl -X POST "https://www.suiyongsuiqi.com/api/v1/mail/passport/random" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json"
```

Fetch mailbox messages by mailbox ID:
```bash
curl -X POST "https://www.suiyongsuiqi.com/api/v1/mail/messages" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d "{"mailBoxId":"<MAILBOX_ID>","current":1,"size":20}"
```
- Anonymous quota is limited per IP and is intended for temporary or low-frequency usage.
- For stable automation, purchased mailboxes, mailbox asset management, CLI, SDK, and MCP workflows, use authenticated API keys and the authenticated OpenAPI base URL.

## Primary Entry Points
- [Home](https://suiyongsuiqi.com/en): Disposable email and temporary inbox quick start for sign-ups, verification, privacy protection, and spam reduction.
- [Help Center](https://suiyongsuiqi.com/en/help): Product overview, mailbox lifecycle guidance, automation entry points, and support context.
- [Security & Trust](https://suiyongsuiqi.com/en/security): Security, privacy, and compliance notes for disposable inboxes, purchased mailboxes, and automated mailbox workflows.

## Authenticated Console
- [API Keys](https://suiyongsuiqi.com/en/user/api-keys): Login required. Generate API keys and inspect authenticated mailbox APIs.
- [Purchase Mailbox](https://suiyongsuiqi.com/en/user/purchase): Login required. Buy custom, random, or batch mailboxes and access related paid workflows.
- [My Mailboxes](https://suiyongsuiqi.com/en/user/mailbox): Login required. Manage mailbox assets, read emails, monitor unread mail, delete mailboxes, and handle transfers.
- [Recharge](https://suiyongsuiqi.com/en/user/recharge): Login required. Add balance for paid mailbox workflows.

## Agent and API Access
- [OpenAPI Base URL](https://www.suiyongsuiqi.com/openapi): Base URL for authenticated HTTP requests and agent integrations.
- Authentication: create an API key from the console after login.
- Permission scopes:
  - MAIL_BUY: buy random mailboxes, buy custom mailboxes, batch buy mailboxes, and bind or transfer purchased mailboxes.
  - MAIL_READ: retrieve mailbox messages, query unread summaries, and query unread mailbox lists.
  - MAIL_ASSET: list mailbox assets, delete purchased mailboxes, and batch delete purchased mailboxes.
  - MAIL_MARK_READ: mark messages as read.
- Key endpoint families:
  - /api/v1/mail/buy-random
  - /api/v1/mail/buy
  - /api/v1/mail/batch-buy
  - /api/v1/mail/bind
  - /api/v1/mail/user-list
  - /api/v1/mail/remove
  - /api/v1/mail/batch-remove
  - /api/v1/mail/messages
  - /api/v1/mail/user-unread-summary
  - /api/v1/mail/user-unread-list
  - /api/v1/mail/mark-read

## Agent Tooling
- [SYSQ CLI](https://github.com/suiyongsuiqi/sysq-cli): Official agent-first CLI for authenticated mailbox automation across terminal workflows, CI/CD jobs, local scripts, and agent orchestration.
- CLI install: `npm i -g @suiyongsuiqi/sysq-cli`.
- CLI run without global install: `npx @suiyongsuiqi/sysq-cli --help`.
- CLI required environment variables: SYSQ_BASE_URL=https://www.suiyongsuiqi.com/openapi and SYSQ_API_KEY=<created from console>.
- CLI automation flags: use `--json` for stable machine-readable output and `--yes` for non-interactive destructive flows.
- Representative CLI commands: `sysq mailbox list`, `sysq mailbox buy`, `sysq mailbox buy-random`, `sysq mailbox remove`, `sysq mail unread-summary`, `sysq mail unread-list`, `sysq mail messages`, `sysq mail mark-read`.
- CLI JSON contract: success responses return a normalized envelope, failures also return normalized JSON, and exit codes distinguish success, remote or business errors, usage or configuration errors, and user cancellation.
- CLI boundary: authenticated automation only; no anonymous guest access.
- [SYSQ MCP](https://github.com/suiyongsuiqi/sysq-mcp): Official public stdio-only MCP server for Model Context Protocol compatible clients and authenticated agent workflows.
- MCP install: `npm i -g @suiyongsuiqi/sysq-mcp`.
- MCP required environment variables: SYSQ_BASE_URL=https://www.suiyongsuiqi.com/openapi and SYSQ_API_KEY=<created from console>.
- Recommended MCP clients: Claude Desktop, Cursor, Cherry Studio, and similar MCP-compatible LLM clients.
- Representative MCP tools: `sysq_mailbox_list`, `sysq_mailbox_buy`, `sysq_mailbox_buy_random`, `sysq_mailbox_buy_batch`, `sysq_mailbox_bind`, `sysq_mailbox_remove`, `sysq_mailbox_remove_batch`, `sysq_mail_unread_summary`, `sysq_mail_unread_list`, `sysq_mail_messages`, `sysq_mail_mark_read`.
- MCP process model: single-user per process; one MCP server process maps to one SYSQ API key.
- MCP transport boundary: v1 is stdio-only and does not expose a public Streamable HTTP endpoint.
- Use the CLI and MCP repository READMEs as the source of truth for current setup, supported commands, tools, resources, prompts, and workflow details.
- [GitHub Organization](https://github.com/suiyongsuiqi): Source code and related public tooling.
- [Support Email](mailto:zhisirudan@gmail.com): zhisirudan@gmail.com. Include mailbox address, mailbox ID, order ID, payment status, API request parameters, or automation workflow context when asking for help.

## Policies
- [Privacy Policy](https://suiyongsuiqi.com/en/legal/privacy): Data processing, retention, and privacy contact guidance.
- [Terms of Service](https://suiyongsuiqi.com/en/legal/terms): Service rules, acceptable use, and paid feature boundaries.
- [Cookie Policy](https://suiyongsuiqi.com/en/legal/cookies): Browser storage, session handling, and local state behavior.